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


SL (Simple List)

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

The SL tag defines a simple list of items within an information region.

Syntax

Read syntax diagramSkip visual syntax diagram
>>-<SL--+---------+--+--------+--+----------------+------------->
        '-COMPACT-'  '-NOSKIP-'  |        .-NO--. |   
                                 '-SPACE=-+-YES-+-'   

>--+----------+--+----------------------+-->--</SL>------------><
   '-INDENT=n-'  '-TEXT=SL-heading-text-'             

Parameters

COMPACT
This attribute causes the list to be formatted without a blank line between the list items.
NOSKIP
This attribute causes the list to format without creating a blank line before the first line of the list.
SPACE=NO | YES
The SPACE attribute controls the indentation space for the list item. When the SPACE attribute is not specified on the LI tag, the SPACE attribute from the SL tag is used to set the indentation space for the nested LI tag item-text.

When SPACE=YES, the indentation is set to 3 spaces. When SPACE=NO (or SPACE is not specified), the indentation is set to 4 spaces.

The SPACE attribute can be used to control the alignment of list items when the first word of some list items is a DBCS word preceded by a shift-out character and the first word of other list items is a SBCS word.

INDENT=n
This attribute specifies that the list be indented from the current left margin.
TEXT=SL-heading-text
This attribute causes the list to format with a heading line containing the SL-heading-text.

Comments

The SL tag defines a simple list of items within an information region.

Simple lists are indented lists, with no bullets, dashes, or hyphens preceding the list items. Nested lists indent four spaces to the right of the left margin of the list that contains them.

Note: The SPACE attribute does not affect the indentation of nested lists.

The conversion utility adds a blank line before the first item in the list.

Use the LI tag to denote each list item. See LI (List Item) for more information on the LI tag.

Restrictions

  • The SL tag requires an end tag.
  • You must code the SL tag within an INFO definition. See INFO (Information Region) for a complete description of this tag.

Processing

Table 1. Tags you can code within an SL definition
Tag Reference Usage Required
LI LI (List Item) Multiple No
LP LP (List Part) Multiple No

Examples

Here is help panel markup that contains two simple lists. The second simple list is compact, and is nested within the first list. Figure 1 shows the formatted result.
<!DOCTYPE DM SYSTEM>

<HELP NAME=sl WIDTH=40 DEPTH=22>Help for ShelfBrowse
<AREA>
<INFO>
  <P>Using ShelfBrowse, you can locate the following items:
  <SL>
    <LI>Audiotapes
    <LI>Books
    <LI>Periodicals
      <SL COMPACT>
        <LI>Newspapers
        <LI>Magazines
      </SL>
    <LI>Reference material
    <LI>Videotapes
</SL>
</INFO>
</AREA>
</HELP>
Figure 1. Simple list
          Help for ShelfBrowse

 Using ShelfBrowse, you can locate the
 following items:

     Audiotapes

     Books

     Periodicals

         Newspapers
         Magazines

     Reference material

     Videotapes


  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