Usage

Optional

Format

Select Specific statement output from the When drop-down list, and fill in the sub-parameters below.

Variable Name

None

Alternate names

• Control‑M/EM Utilities:ON
• Control‑M/Server Utilities:‑on
• e-Trigger:on_do_statement
• Control‑M/EM API:on_statement

Sub-parameters

Statement

A character string, from 1 through 132 characters in length, containing a statement from the job script file. The specified string can be a portion of the statement.

NOTE: If this portion is within the statement,it must be preceded and followed by mask characters. Alternatively, you can set the ONSTMT_ADD_WILD in the CONFIG file to the value of Y.

Statement character strings can each contain mask characters. Valid mask characters are:

• * – represents any number of characters (including no characters)
• $ – represents any single character
• ? – represents any single character

Code

A character string, from 1 through 255 characters in length, to be compared to the operating system’s response to the specified statement. The specified string can be a portion of the code.

NOTE: If this portion is within the code,it must be preceded and followed by mask characters. Alternatively, you can set the ONSTMT_ADD_WILD in the CONFIG file to the value of Y.

Code character strings can each contain mask characters. Valid mask characters are:

• * – represents any number of characters (including no characters)
• $ – represents any single character
• ? – represents any single character

Alternate formats

Control‑M/EM Utilities

ON is composed of the STMT, CODE, PGMS, PROCS, and AND_OR sub-parameters.

STMT is a 1-132 character string, used only when you are specifying an On statement value.

Control‑M/EM API

on_statement is composed of the following sub-parameters:

• and_or
• code
• procedure_step
• program_step
• statement

  NOTE: Chinese, Japanese and Korean character sets: The ? and $ wildcards are not supported. The * wildcard is supported only as a standalone value or as a suffix to another value. It cannot be embedded in, or act as a prefix to another value.