Set Variable

The Set Variable assigns a value to a variable for use in a rerun of the job when the On Statement/Code criteria are satisfied.

Additional information	Description

Usage	Optional
Format	Name and Value text boxes Enter the variable name in the Name text box, and the expression in the Value text box. Application-specific job parameters may not be specified in variable values. The names of application-specific job parameters are prefixed by two percent signs, the application’s abbreviation and a hyphen (%%SAPR3- for SAP, %%OAP- for Oracle, and so on).
Length	Computers other than z/OS: The variable name can be up to 40 characters long (including the %% prefix). The Variable expression Value can be up to 214 characters long. z/OS: The total length of Set Variable, including the %% prefix, variable-name, value, and the = sign, must not exceed 55 characters.
Case Sensitive	Yes
Invalid Characters	Computers other than z/OS: The following characters cannot be included as part of variable-name in a User-defined variable: < > [ ] { } ( ) = ; ‘ ~ \| : ? . + - * / & ^ # @ ! , " '. In value the only invalid characters are embedded blanks. Leading blanks are valid. z/OS: Blanks
Variable Support	Yes. A variable or expression can be specified as all or part of the value for this parameter.
Alternate names	Control‑M/EM Utilities: DOVARIABLE Control-M Report: (none) Control‑M/Server Utilities: ‑dovariable Control‑M for z/OS: (none) Control‑M/EM API: do_variable
Alternate formats
Control‑M/EM Utilities	The value for the DOVARIABLE parameter is contained in the EXP sub-parameter. EXAMPLE: <DOVARIABLE EXP="%%PARM1=%%TIME"/>
Control‑M/EM Utilities	EXP	String containing both the variable and the expression, presented as an equation.
Sub-parameters
Name	Name of the variable. The %% prefix is entered automatically. 1-38 character string (following the %% prefix).
Type	From the Variable Type drop-down list, select a variable type as described in Adding a variable.
Value	Variable expression. 1-214 character string. Application-specific job parameters may not be specified in variable values. The names of application-specific job parameters are prefixed by two percent signs, the application’s abbreviation and a hyphen (%%SAPR3- for SAP, %%OAP- for Oracle, and so on).

Variables are resolved (replaced) at the time a job is submitted.

The Set Variable parameter can be used to assign a value to a variable for use in a rerun of the job. When a job is rerun, statements specified in Set Variable are evaluated after statements specified in Variable Assignment.

Unless it is assigned a value in the Variable Assignment parameter, a variable that is assigned a value in a Set Variable parameter does not have any value during the first submission of the job.

Parent Topic

On/Do Actions