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


Ordered lists

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

Ordered lists imply an outline sequence to the list items by preceding each of the list items with a number or character depending on the level of nesting.

Here is an ordered list:

Figure 1. Ordered list
                   Window Shopper

 After you have placed your order with Window
 Shopper, you should...

 1.  Press the Enter key to leave the Order Panel.

 2.  Go to the receiving desk located at the front
     of the store.

 3.  Give the cashier the pink copy of your
     receipt.

 4.  Take your purchases home, and enjoy!







 

You don't supply the numbers for the list items in your markup; they are generated automatically. This saves you time when you revise ordered lists, because you can insert, delete, or rearrange list items without renumbering them yourself.

Here is the markup we used for this list:
<!doctype dm system>
<panel name=winshop2 width=52>Window Shopper
  <area>
    <info width=50>
      <p>After you have placed your order with Window Shopper, you should...
      <ol>
        <li>Press the Enter key to leave the Order Panel.
        <li>Go to the receiving desk located at the front of the store.
        <li>Give the cashier the pink copy of your receipt.
        <li>Take your purchases home, and enjoy!
      </ol>
    </info>
  </area>
</panel>

Like other types of lists, you can nest ordered lists within other lists. And, like unordered lists, the levels of the lists you nest determine the characters that precede the list items.

Specifically, the conversion utility uses this sequence when processing list items in nested ordered lists:
  • First-level list items are preceded by sequential numbers followed by a period and 2 spaces 1.
  • Second-level list items are preceded by sequential lowercase alphabetic characters followed by a period and 2 spaces 1.
  • Third-level list items are preceded by sequential numbers followed by a close parentheses symbol and 2 spaces 1.
  • Fourth-level list items are preceded by sequential lowercase alphabetic characters followed by a close parentheses symbol and 2 spaces 1.
Note: Each level beyond the first level indents 41 spaces.

The sequence of nesting is repeated for levels of nesting beyond the fourth level. For example, the list items in a fifth level of nesting are preceded by sequential numbers followed by a period.

To show you what this looks like, we'll nest three levels of ordered lists in this markup. We'll use the COMPACT attribute in the third level to conserve space.
<!doctype dm system>
<panel name=olists width=42>Nested Ordered Lists
  <area>
    <info width=40>
      <ol>
        <li>Step one (first level)
        <li>Step two (first level)
          <ol>
            <li>Step one (second level)
            <li>Step two (second level)
              <ol compact>
                <li>Step one (third level)
                <li>Step two (third level)
              </ol>
            <li>Step three (second level)
          </ol>
        <li>Step three (first level)
      </ol>
    </info>
  </area>
</panel>

Here is how the DTL compiler formats this panel:

Figure 2. Nested ordered lists
           Nested Ordered Lists

 1.  Step one (first level)

 2.  Step two (first level)

     a.  Step one (second level)

     b.  Step two (second level)

         1)  Step one (third level)
         2)  Step two (third level)

     c.  Step three (second level)

 3.  Step three (first level)





 
1 The default indentation for a list item is 4 spaces. When the SPACE=YES attribute is coded, the indentation is 3 spaces. See the LI and OL tag descriptions in Tag reference for more information.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014