VARLIST (Variable List)

The VARLIST tag provides the means to code VARDCL tags in a single list.

Syntax


>>-<VARLIST>--</VARLIST>---------------------------------------><

Comments

The VARLIST tag provides the means to code VARDCL tags in a single list. The VARDCL tags coded within a VARLIST definition declare variables that are referred to in the dialog element definitions within a DTL source file.

Note: The ISPF Dialog Tag Language conversion utility does not require that you code the VARCLASS, VARDCL, or VARLIST tags for a successful generation of a panel, command table, or message member that includes variables. If the conversion utility finds a variable that does not have an associated VARDCL definition, it issues a warning message.

The use of the VARCLASS, VARDCL, and VARLIST tags is required if you want to use the facilities provided by the CHECKL and XLATL tags.

Restrictions

The VARLIST tag requires an end tag.
You cannot code the VARLIST tag within any other tag definition.
You can code the VARLIST tag immediately after all VARCLASS tags within the DTL source file and before any tag definitions that refer to the variables declared in the variable list.

Processing

Table 1. Tags you can code within a VARLIST definition
Tag	Reference	Usage	Required
VARDCL	VARLIST (Variable List)	Multiple	No

Examples

Here is source file markup that contains a variable list. The variable declarations within the list define variables for the fields within the PANEL definitions that refer to them.

<!DOCTYPE DM SYSTEM>

<VARCLASS NAME=char8 TYPE='char 8'>
<VARCLASS NAME=name  TYPE='char 25'>
<VARCLASS NAME=phoncls TYPE='char 12'>
<VARCLASS NAME=appcls  TYPE='char 1'>
  <XLATL FORMAT=upper>
  </XLATL>
  <CHECKL>
    <CHECKI TYPE=values PARM1=EQ PARM2='Y N'>
  </CHECKL>

<VARLIST>
  <VARDCL NAME=curdate VARCLASS=char8>
  <VARDCL NAME=namevar VARCLASS=name>
  <VARDCL NAME=passvar VARCLASS=char8>
  <VARDCL NAME=xlname  VARCLASS=name>
  <VARDCL NAME=xphone  VARCLASS=phoncls>
  <VARDCL NAME=xapp    VARCLASS=appcls>
</VARLIST>

<PANEL NAME=varlist1 KEYLIST=keylxmp>System Log On
<TOPINST>Complete the following fields, then press Enter.
<AREA>
  <DTACOL PMTWIDTH=12>
    <DTAFLD DATAVAR=curdate ENTWIDTH=8 USAGE=out>Date
    <DTAFLD DATAVAR=namevar ENTWIDTH=25 DESWIDTH=15>Name
    <DTAFLD DATAVAR=passvar ENTWIDTH=8 DISPLAY=no>Password
  </DTACOL>
</AREA>
</PANEL>

<PANEL NAME=varlist2 DEPTH=14 KEYLIST=keyltbl>Subscriber List
<TOPINST>Enter phone number, if missing,
(format - nnn-nnn-nnnn) and approved
indicator (y or n) for each person.
<AREA>
  <LSTFLD>
      <LSTCOL DATAVAR=xlname USAGE=out COLWIDTH=25>Last Name
      <LSTCOL DATAVAR=xphone COLWIDTH=12>Phone Number
    <LSTGRP>Approved
      <LSTCOL DATAVAR=xapp USAGE=in REQUIRED=yes
        COLWIDTH=1 MSG=msgv886>(Y or N)
    </LSTGRP>
  </LSTFLD>
</AREA>
<CMDAREA>Enter a command
</PANEL>