VARDCL (Variable Declaration)

The VARDCL tag declares variables referred to in dialog element definitions.

Syntax


>>-<VARDCL--NAME=name--VARCLASS=variable-class-name-->---------->

>--+-----------+-----------------------------------------------><
   '-</VARDCL>-'

Parameters

NAME=name: This attribute specifies the name of a variable used elsewhere in the DTL source file. The name must follow the standard naming convention described in Rules for variable names.
VARCLASS=variable-class-name: This attribute specifies the default variable class associated with the variable. If you want to perform a different set of checks or translations on any data field or list column, you can specify an overriding variable class in the DTAFLD or LSTCOL tags.

Comments

The VARDCL tag declares variables referred to in dialog element definitions.

Note: The ISPF Dialog Tag Language conversion utility does not require that you code the VARCLASS, VARDCL, or VARLIST tags for 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

You must code the VARDCL tag within a VARLIST tag. See VARLIST (Variable List) for a complete description of this tag.

Processing

None.

Examples

Here is source file markup that contains variable declarations for all of the variables defined in the panel definition. The declared variables include:

The variable whchsrch specified in the CHECKVAR attributes associated with the pull-down choices of the Search action bar choice.
The data field variables curdate, cardno, name, and address.
The variable cardsel, which is the entry-field of the single-choice selection field.
The variables north, south, east, and west, which are the entry-fields associated with the multiple-choice selection field.
The variables defined as the check variables (CHECKVAR attribute) for the selection fields.

<!DOCTYPE DM SYSTEM(
  <!entity sampabc sysem>
  <!entity sampbody system>)>

<VARCLASS NAME=date    TYPE='char 8'>
<VARCLASS NAME=numcls  TYPE='numeric 7'>
<VARCLASS NAME=namecls TYPE='char 25'>
<VARCLASS NAME=char1cls TYPE='char 1'>
<VARCLASS NAME=char7cls TYPE='char 7'>

<VARLIST>
  <VARDCL NAME=whchsrch VARCLASS=char1cls>
  <VARDCL NAME=curdate VARCLASS=date>
  <VARDCL NAME=cardno  VARCLASS=numcls>
  <VARDCL NAME=name    VARCLASS=namecls>
  <VARDCL NAME=address VARCLASS=namecls>
  <VARDCL NAME=cardsel VARCLASS=char1cls>
  <VARDCL NAME=card VARCLASS=char7cls>
  <VARDCL NAME=north VARCLASS=char1cls>
  <VARDCL NAME=south VARCLASS=char1cls>
  <VARDCL NAME=east VARCLASS=char1cls>
  <VARDCL NAME=west VARCLASS=char1cls>
  <VARDCL NAME=nth VARCLASS=char1cls>
  <VARDCL NAME=sth VARCLASS=char1cls>
  <VARDCL NAME=est VARCLASS=char1cls>
  <VARDCL NAME=wst VARCLASS=char1cls>
</VARLIST>

<PANEL NAME=vardcl>Library Card Registration
<AB>
&sampabc;
</AB>
&sampbody;
</PANEL>