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

Reporting Facility: (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.

<DOVARIABLE EXP="%%PARM1=%%TIME"/>

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).

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).