The CHDIV tag creates a blank or visible
divider between CHOICE tags.
Syntax
>>-<CHDIV--+-----------------+--+---------------+--------------->
| .-NONE--. | | .-1-. |
'-TYPE=-+-SOLID-+-' '-GUTTER=-+-n-+-'
+-DASH--+
'-TEXT--'
>--+--------------------+-->--+--------------+--+----------+---><
| .-START--. | '-divider-text-' '-</CHDIV>-'
'-FORMAT=-+-CENTER-+-'
'-END----'
Parameters
- TYPE=NONE | SOLID
| DASH | TEXT
- This
attribute specifies the type of divider line. The line width is one
character.
The default value is NONE, which produces a blank line.
You must specify SOLID, DASH, or TEXT to produce a visible divider
line. When the GRAPHIC invocation option is specified, SOLID produces
a solid line for host display and DASH produces a dashed line. When
NOGRAPHIC is specified or the panel is displayed in GUI mode, both
SOLID and DASH produce a dashed line.
- GUTTER=1 | n
- This
attribute specifies the total width of the divider. If the GUTTER
value is an even number, the conversion utility increases the number
by 1 so that the divider is centered within the defined width.
The
minimum and default GUTTER value is 1.
- FORMAT=START |
CENTER | END
- This
attribute specifies the position of the divider text within the width
of the divider line. The divider width is the same as the CHOICE
tag text formatting width.
- divider-text
- This is the text of the choice divider.
Comments
The
CHDIV tag creates a blank or solid divider between CHOICE tags.
Processing
Table 1. Tags you can code within a CHDIV definitionTag |
Reference |
Usage |
Required |
---|
HP |
HP (Highlighted Phrase) |
Multiple |
No |
Examples
Here
is an example that shows the creation of an ISPF selection menu. The
CHDIV tag is included to separate the Exit option from the other selection
choices. The FCHOICE attribute specifies that the first selection
number is 0. The choice selection for Exit is specified on the CHOICE
tag. The ACTION tag for the Exit choice selection specifies both the
RUN and TYPE attributes because RUN is required on the ACTION tag
and TYPE is necessary to specify the ISPF selection for the generated
ZSEL panel statement.
<!doctype dm system ()>
<!-- Sample selection menu -->
<varclass name=vc1 type='char 80'>
<xlatl format=upper>
</xlatl>
<varlist>
<vardcl name=zcmd varclass=vc1>
</varlist>
<panel name=chdiv1 menu keylist=keylxmp>
Sample Selection Panel with CHDIV tag
<topinst>This is a selection panel.
<selfld type=menu pmtloc=before fchoice=0 trail=nextsel
selwidth=40 pmtwidth=10>Select an option
<choice checkvar=xtest1 match=a>
Selection #0 (Command Selch0)
<action run=Selch0>
<choice checkvar=xtest1 match=b>
Selection #1 (Command Selch1)
<action run=Selch1 parm='1 2 3 4'
passlib newpool suspend>
<choice checkvar=xtest1 match=c>
Selection #2 (Command Selch2)
<action run=Selch2 parm=1234>
<choice checkvar=xtest1 match=d>
Selection #3 (Command Selch3)
<action run=Selch3 parm=abcd>
<choice checkvar=xtest1 match=e>
Selection #4 (Command Selch4)
<action run=Selch4 parm='a b c d'>
<chdiv>
<choice selchar=X>
Exit
<action run=exit type=exit>
</selfld>
<cmdarea>
</panel>
Figure 1 shows
the formatted result.
Figure 1. Choice
divider Sample Selection Panel with CHDIV tag
Option ===> _____________________________________________________________
This is a selection panel.
Select an
option . . 0 Selection #0 (Command Selch0)
1 Selection #1 (Command Selch1)
2 Selection #2 (Command Selch2)
3 Selection #3 (Command Selch3)
4 Selection #4 (Command Selch4)
X Exit
Option ===> _____________________________________________________________
F1=Help F3=Exit F5=Display F6=Keyshelp F10=Actions
F12=Cancel