CHECKL (Validity Check List)

The CHECKL tag defines a validity check for input variables.

Syntax


>>-<CHECKL--+------------------------+-->--</CHECKL>-----------><
            '-MSG=message-identifier-'

Parameters

MSG=message-identifier: This attribute identifies the message to be issued if the value fails the embedded test. The conversion utility adds this message-identifier to the VER statement generated by the enclosed CHECKI tag. If you do not specify your own message, ISPF issues a message specified on the enclosing VARCLASS tag or the default message associated with the type of VER statement generated. See MSG (Message) for information about creating messages.

Comments

The CHECKL tag defines a validity check for input variables. The CHECKI tag coded within the check list performs the validation test.

Field validity checking follows standard ISPF conventions based on the verification statements generated. For details, see CHECKI (Validity Check Item).

Restrictions

The CHECKL tag requires an end tag.
You must code the CHECKL tag within a VARCLASS definition. See VARCLASS (Variable Class) for a complete description of this tag.
The CHECKL tag must be coded after all XLATL tags in the same variable class.

Processing

Table 1. Tags you can code within a CHECKL definition
Tag	Reference	Usage	Required
CHECKI	CHECKI (Validity Check Item)	Single	No

Examples

Here is source file markup that contains two variable classes that each contain a validity check list. The second variable class also contains a translate list that translates variable values to uppercase. Notice that the translate list is coded in the variable class before the validity check list.

<!DOCTYPE DM SYSTEM>

<VARCLASS NAME=aa TYPE='char 18'>
  <CHECKL MSG=msgf881>
    <CHECKI TYPE=ALPHA>
  </CHECKL>

<VARCLASS NAME=bb TYPE='char 6'>
  <XLATL FORMAT=upper>
  </XLATL>
  <CHECKL MSG=msgf883>
    <CHECKI TYPE=VALUES PARM1=EQ PARM2="SINGLE DOUBLE">
  </CHECKL>

<VARLIST>
  <VARDCL NAME=checka VARCLASS=aa>
  <VARDCL NAME=checkb VARCLASS=bb>
</VARLIST>

<PANEL NAME=checkl>CHECKL audits
  <DTAFLD DATAVAR=checka ENTWIDTH=18 PMTWIDTH=20>Enter Last Name
  <DTAFLD DATAVAR=checkb ENTWIDTH=6 PMTWIDTH=20>Enter Room Type
  <CMDAREA>
</PANEL>