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


Notes (NOTE, NT and NOTEL tags)

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

The NOTE, NOTEL, and NT tags format as noted text. Use notes to emphasize minor points.

When you use either the NOTE or NT tag, you get the text "Note:" followed by a space before the text you specify. However, the text is formatted differently depending on which tag you use.

The NOTEL tag is formatted with the first line containing the text "Notes:" followed by a numbered list of note information provided by the <LI> tag.

The NOTE tag
If the text is a single paragraph, you use the NOTE tag. The text is formatted as an unindented block, like a paragraph. The NOTE tag does not require a matching end tag.
You use the NOTE tag like this:
<!doctype dm system>
<panel name=widget61 width=50>Widgets
  <area>
    <info width=48>
      <p>Choose the type of Widget you want to order by placing
      the cursor on the field and pressing Enter.
      <note>If the Widget you wish to order is not in stock, please
      refer to the "Back Order" panel to place an order.
    </info>
  </area>
</panel>

Figure 1 shows how it formats.

Figure 1. Note (NOTE tag)
                     Widgets

 Choose the type of Widget you want to order by
 placing the cursor on the field and pressing
 Enter.

 Note: If the Widget you wish to order is not in
 stock, please refer to the "Back Order" panel to
 place an order.












 
The NOTEL tag
If more than one note is used for special attention information, you use the NOTEL tag. Each note is provided by a separate LI tag. The notes are numbered similar to the format described in Ordered lists. You use either the P or LP tag to add any additional paragraphs in the NOTEL definition. Use the required end tag to end the NOTEL definition.

In this example, 2 notes are used, 1 with more than one paragraph. We use the NOTEL tag and its required end tag along with LI tags to define the notes, and a P tag for the additional paragraph.

<!doctype dm system>
<panel name=widget63 width=50>Widgets
  <area>
    <info width=48>
      <p>Choose the type of Widget you want to order by placing
      the cursor on the field and pressing Enter.
      <notel>
        <li>If the Widget you wish to order is not in stock, please
            refer to the "Back Order" panel to place an order.
        <li>Back-ordered Widgets usually arrive within three days.
          <p>Please check again in three days.
      </notel>
      <p>If you want to order more than one Widget, specify the quantity
      and press Enter.
    </info>
  </area>
</panel>

Notice that the P tag in the note is coded before the NOTEL end tag, indicating that the second paragraph belongs in the note.

This is how the panel looks now:
Figure 2. Notel (NOTEL tag)
                     Widgets

 Choose the type of Widget you want to order by
 placing the cursor on the field and pressing
 Enter.

 Notes:

 1.  If the Widget you wish to order is not in
     stock, please refer to the "Back Order"
     panel to place an order.

 2.  Back-ordered Widgets usually arrive within
     three days.

     Please check again in three days.

If you want to order more than one Widget,
specify the quantity and press Enter.



  

As you can see, the text of the NOTEL tag is formatted as a list under the "Notes:" heading. The text of the P tag is indented to match the list items.

The NT tag
If the note requires more than one paragraph, you use the NT tag. You use the P tag to add any additional paragraphs in the NT definition. Use the required end tag to end the NT definition.

Another difference between the NOTE and NT tag is that the NT tag indents the note text from the left panel margin.

In this example, the note is longer than one paragraph. We use the NT tag and its required end tag to define the note, and a P tag for each additional paragraph.
<!doctype dm system>
<panel name=widget62 width=50>Widgets
  <area>
    <info width=48>
      <p>Choose the type of Widget you want to order by placing
      the cursor on the field and pressing Enter.
      <nt>If the Widget you wish to order is not in stock, please
      refer to the "Back Order" panel to place an order.
        <p>Back-ordered Widgets usually arrive within three days.
      </nt>
      <p>If you want to order more than one Widget, specify the quantity
      and press Enter.
    </info>
  </area>
</panel>

Notice that the P tag in the note is coded before the NT end tag, indicating that the second paragraph belongs in the note.

This is how the panel looks now:

Figure 3. Note (NT tag)
                     Widgets

 Choose the type of Widget you want to order by
 placing the cursor on the field and pressing
 Enter.

 Note: If the Widget you wish to order is not in
       stock, please refer to the "Back Order"
       panel to place an order.

       Back-ordered Widgets usually arrive
       within three days.

 If you want to order more than one Widget,
 specify the quantity and press Enter.






 

As you can see, the text of the NT tag is indented, as is the text of the P tag coded within the NT tag.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014