CHDIV (Choice Divider)

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.

Restrictions

You must code the CHDIV tag within an SELFLD definition. See SELFLD (Selection Field) for a description of this tag.

Processing

Table 1. Tags you can code within a CHDIV definition
Tag	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