z/OS ISPF Dialog Tag Language Guide and Reference
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


NT (Note)

z/OS ISPF Dialog Tag Language Guide and Reference
SC19-3620-00

The NT tag defines a single- or multiple-paragraph note within an information region.

Syntax

Read syntax diagramSkip visual syntax diagram
>>-<NT--+--------+--+----------+--+----------------+------------>
        '-NOSKIP-'  '-INDENT=n-'  |       .-ET---. |   
                                  '-TYPE=-+-CH---+-'   
                                          +-CT---+     
                                          +-FP---+     
                                          +-LEF--+     
                                          +-LI---+     
                                          +-NT---+     
                                          +-PT---+     
                                          +-SAC--+     
                                          +-TEXT-+     
                                          +-WASL-+     
                                          '-WT---'     

>--+---------------------+--+----------------------+------------>
   '-COLOR=-+-WHITE----+-'  |         .-HIGH-----. |   
            +-RED------+    '-INTENS=-+-LOW------+-'   
            +-BLUE-----+              +-NON------+     
            +-GREEN----+              '-%varname-'     
            +-PINK-----+                               
            +-YELLOW---+                               
            +-TURQ-----+                               
            '-%varname-'                               

>--+----------------------+--+-----------------------------+---->
   '-HILITE=-+-USCORE---+-'  '-TEXT=alternate-note-heading-'   
             +-BLINK----+                                      
             +-REVERSE--+                                      
             '-%varname-'                                      

>-->--+-----------+--</NT>-------------------------------------><
      '-note-text-'          

Parameters

NOSKIP
This attribute causes the note to be formatted without creating a blank line before the note.
INDENT=n
This attribute specifies that the note be indented from the current left margin.
TYPE= ET | CH | CT | FP | LEF | LI | NT | PT | SAC | TEXT | WASL | WT
This attribute defines the attribute type to be applied to the note heading. Using a CUA attribute causes the text to appear in the associated color.

When TYPE=TEXT, a non-CUA attribute is generated and you can specify the color, intensity, and highlighting with the COLOR, INTENS, and HILITE attributes. These attributes are not valid for CUA types.

COLOR= WHITE | RED | BLUE | GREEN | PINK | YELLOW | TURQ | %varname
This attribute specifies the color of the note heading. You can define this attribute as a variable name preceded by a percent (%) sign.
INTENS= HIGH | LOW | NON | %varname
This attribute defines the intensity of the note heading. You can define this attribute as a variable name preceded by a percent (%) sign.
HILITE= USCORE | BLINK | REVERSE | %varname
This attribute specifies the extended highlighting attribute of the note heading. You can define this attribute as a variable name preceded by a percent (%) sign.
TEXT=alternate-note-heading
This attribute provides a text string to replace the standard "Note:" heading.
note-text
This is the text of the note. You can use the P tag to code additional paragraphs of text.

Comments

The NT tag defines a single- or multiple-paragraph note within an information region. You can code the NT tag anywhere within an INFO definition.

The text of the note formats as an indented block. The block of text is indented seven spaces from the current left margin. The text "Note:" (or its translated equivalent), or the alternate note heading, begins the paragraph. The note aligns with the text of a list item when you code it within a list.

Restrictions

  • The NT tag requires an end tag.
  • You must code the NT tag within an INFO definition. See INFO (Information Region) for a complete description of this tag.
  • You can nest text tags such as paragraphs and lists within a note, but you cannot nest NT and NOTE tags.

Processing

Table 1. Tags you can code within an NT definition
Tag Reference Usage Required
DL DL (Definition List) Multiple No
FIG FIG (Figure) Multiple No
HP HP (Highlighted Phrase) Multiple No
LINES LINES (Lines) Multiple No
OL OL (Ordered List) Multiple No
P P (Paragraph) Multiple No
PARML PARML (Parameter List) Multiple No
PS PS (Point-and-Shoot) Multiple No
RP RP (Reference Phrase) Multiple No
SL SL (Simple List) Multiple No
UL UL (Unordered List) Multiple No
XMP XMP (Example) Multiple No

Examples

Here is help panel markup that contains a multiple-paragraph note. Notice the indented format for the content of the note, which is different from the format generated with the NOTE tag. A P tag is nested within the NT definition to provide an additional paragraph of note text. Figure 1 shows the formatted result.
<!DOCTYPE DM SYSTEM>

<HELP NAME=nt DEPTH=20>Book / Periodical Search Help
<AREA>
<INFO>
  <P>This entry screen allows you to locate a desired
  book or periodical by entering the title in the entry field.
  <NT>If the item you are trying to locate is not
  in stock and you would like to reserve it, please see the
  librarian at the front desk.
  <P>If the librarian is not there, please do not yell for help.
  This is a library!
  </NT>
</INFO>
</AREA>
</HELP>
Figure 1. NT
           Book / Periodical Search Help

 This entry screen allows you to locate a desired
 book or periodical by entering the title in the
 entry field.

 Note: If the item you are trying to locate is
       not in stock and you would like to
       reserve it, please see the librarian at
       the front desk.

       If the librarian is not there, please do
       not yell for help.  This is a library!




  F1=Help         F3=Exit         F5=Exhelp
  F6=Keyshelp     F7=PrvTopic     F8=NxtTopic
 F10=PrvPage     F11=NxtPage     F12=Cancel

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014