HCL Workload Automation, Version 9.4

User-defined variables

You can add your own defined variables in the JCLs.

The names of user-defined variables can be of up to 8 alphanumeric characters, the first of which must be alphabetic. A longer name is taken as not valid and the variable is not processed. An error is recorded in EELMLOG.

Variable values can be of up to 44 alphanumeric characters. Longer values are truncated to 44 characters.

To define these variables, use the variable table definition in the Dynamic Workload Console. To define a variable table and to add variables:
  1. From the navigation toolbar, click Administration>Workload Design>Manage Workload Definitions.
  2. Select the HCL Workload Automation engine when prompted, and provide a valid userid and password if required.
  3. Select New or Search and then Variable table.

Alternatively, you can use the composer vartable command.

Variable tables can be assigned at run cycle, job stream, and workstation level.

The variables (and the values) included in a JCL are forwarded to the agent for z/OS at submission time in a single table. If the scheduler finds that the same variable name is present in more than one of the tables associated with the JCL, it picks the first value according to this sequence:
  1. Run cycle
  2. Job stream
  3. Workstation
Note: The agent does not process variables defined in the global (default) variable table.