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


Selection width

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

The SELWIDTH attribute of the SELFLD tag should be used to define the amount of space taken up by the choice-description-text of each CHOICE tag. This attribute is used to control the formatting of panels defined with horizontal regions. If you do not specify a SELWIDTH value, the conversion utility reserves the remaining available formatting width for the text.

When specifying an explicit SELWIDTH value, you must take into consideration the components of the selection field, as well as the choice-description-text. The conversion utility reserves a number of positions on the lines that selection field choices appear on for the entry fields, 3270 attributes, and, in the case of single-choice, menu-choice, model-choice, and tutor-choice selection fields, the choice prefixes. See the SELWIDTH attribute in SELFLD (Selection Field) for a discussion of the amount of space reserved for each choice type.

These reserved positions must be added to the length of the choice-description-text in the SELWIDTH value you specify. Here is an example of markup that contains two selection fields, one single-choice and one multiple-choice, within a horizontal region. To format the selection fields properly, ensure that the SELWIDTH values you specify are adequate for the reserved positions and the choice-description-text. The largest choice-description-text in the first selection field is 9 characters, which, when combined with the 10 reserved positions in the field, means you must specify a SELWIDTH value of at least 19. The largest choice-description-text in the second selection field is 27 characters, which, when combined with the 5 reserved positions in the field, means you must specify a SELWIDTH value of at least 32.

<!doctype dm system>
<varclass name=char1 type='char 1'>
<varclass name=char2 type='char 2'>

<varlist>
  <vardcl name=person varclass=char2>
  <vardcl name=ch1 varclass=char1>
  <vardcl name=ch2 varclass=char1>
  <vardcl name=ch3 varclass=char1>
  <vardcl name=ch4 varclass=char1>
  <vardcl name=ch5 varclass=char1>
  <vardcl name=ch6 varclass=char1>
</varlist>

<panel name=servsel>Service Selections
  <topinst>Select the stylist and services you want, then press Enter.
  <area>
    <region dir=horiz>
    <selfld name=person selwidth=19 pmtwidth=15>Stylist
      <choice checkvar=stylst match=1>Cecilia
      <choice checkvar=stylst match=2>Dana
      <choice checkvar=stylst match=3>Laurel
      <choice checkvar=stylst match=4>Pierce
      <choice checkvar=stylst match=5>Stephenie
    </selfld>
    <divider>
    <selfld type=multi selwidth=32 pmtwidth=15>Services
      <choice name=ch1 checkvar=dry>Dry haircut
      <choice name=ch2 checkvar=cut>Shampoo, haircut, and style
      <choice name=ch3 checkvar=per>Permanent or body wave
      <choice name=ch4 checkvar=fac>Facial
      <choice name=ch5 checkvar=man>Manicure
      <choice name=ch6 checkvar=ped>Pedicure
    </selfld>
    </region>
  </area>
</panel>

Here is the formatted result:

Figure 1. Selection field SELWIDTH attribute
                             Service Selections

 Select the stylist and services you want, then press Enter.

 Stylist               Services
 __  1.  Cecilia       _  Dry haircut
     2.  Dana          _  Shampoo, haircut, and style
     3.  Laurel        _  Permanent or body wave
     4.  Pierce        _  Facial
     5.  Stephenie     _  Manicure
                       _  Pedicure










 

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014