User-defined variables and variable tables
About this task
Beside the supplied variables, you can define variables
in a variable table by using the JCL VARIABLE panel.
- Select option 9 (JCLVAR) from the MAINTAINING DATABASES panel, or enter the fast path
1.9
from the main menu. You see the MAINTAINING JCL VARIABLE TABLES panel, shown in EQQJVMAP - Maintaining JCL Variable Tables. - (MODIFY). You then see a filter panel that lets you select which JCL variable tables you want to look at. If you leave all the fields blank when you press Enter, you see a list of all the JCL variable tables defined to your HCL Workload Automation for Z system. See EQQJVTML - List of JCL variable tables.
- From this panel, you can copy, modify, browse, delete, and create
a variable table. Enter the CREATE command to display the CREATING
A JCL VARIABLE TABLE panel, where you are prompted for a table name,
the names of the variables you want to create, and other details.
See EQQJVVCL - Creating a JCL variable
table for an example of
variable creation.
The SETUP option specifies when the variable is substituted. See When variables are substituted for more information.
You can specify the variable-substitution exit, rather than HCL Workload Automation for Z should substitute the variable. For more details about this exit, see Variable-substitution exit (on JCL or job definition variable).
When you select a variable from panel EQQJVVCL, you can make detailed modifications to it using this panel:
Set the UPPER CASE field to
Y
, if you want lower case characters of the DEFAULT VALUE field to be translated to upper case.The VALUE REQUIRED option specifies whether the variable can be blank. If you set this field to
Y
, the value cannot be assigned a blank value. - When you have selected and defined a variable, you can specify:
- Dependencies on the variable (see Making one variable dependent on another)
- Validation criteria for the variable (see Variable validation)