ON

Specifies the conditions under which the rule is to be performed.

An ON statement is comprised of the ON field and the optional parameters listed below. At least one ON statement is required. Additional ON statements can be specified using the And/Or/Not option described below.

Type one of the following options or abbreviations in the ON field and press Enter. Specify a value for the selected option, and specify values as indicated for any additional subparameters.

• CO (COMMAND) – any operator command entered on the console
• CT (CTOPCMSG – message issued by Control-M/Links for Windows NT
• D (DSNEVENT) – name (or mask) of the job to be monitored for data set events

The rule is performed when data set disposition is performed by MVS, for specified data sets, at deallocation time during step termination or dynamic deallocation. Data set name and disposition are specified in subparameters.

• E (EVENT) – Event identifier from 1 through 8 characters in length. Use of an ON EVENT statement indicates that Control-O will use only the Runtime Scheduling criteria to determine whether or not to perform an action. For example, issue a command every hour.
• JA (JOBARRIV) – Job name (or mask). The rule is performed when a job or started task arrives on the JES spool from any source.

Examples: Jobs submitted by a TSO user, jobs submitted by CICS, and jobs received over an NJE network.

ON

(continued)

• JE (JOBEND) – Job name (or mask). The rule is performed when a job or started task terminates.
• M (MESSAGE) – Message identifier (ID) from 1 through 10 characters in length.
• MV (MVALARM) – MAINVIEW alarm exception code (or mask) issued by MAINVIEW ALARM (a BMC product.)
• OM (OMEGAEXP) – Exception code (or mask) issued by an OMEGAMON monitor. The rule is triggered when the specified exception code is issued from the specified OMEGAMON monitor.
• R (RULE) – Rule identifier (name) from 1 through 8 characters in length. Use of an ON RULE statement indicates that the specified rule is performed only when it is invoked by a DO RULE statement which is part of another rule.
• SMS – SMS (Storage Management System) data set allocation event. When a new data set is allocated, SMS calls three Automatic Class Selection (ACS) routines that set the data, management, and storage classes of the data set. The rule is triggered when the ACS routine is called.
• STE (STEP) – Name or mask of the job to be monitored for the completion of a specified step. The rule is performed when the specified step of the specified job is completed.
• STR (STRING) – Message text to be intercepted by Control-O. The search for the specified string can be limited to a FROM and TO column range, using the COL subparameter.
• SYSOUT – Message text issued to a SYSOUT DD stream. The rule is triggered when the message is issued.

ON

(continued)

The first ten characters of the value specified for the selected options will appear as the name of the rule in the Rule List and Rule Status screens.

Mask characters (* and ?) can be used when specifying values for all ON selection options except ON EVENT and ON RULE.

Control-O AutoEdit variables can be specified and are resolved during rule ordering. For more information, see ON Statement: Message/Event Selection Parameter.

And/Or/Not

Conjunctional parameter for linking ON statements.

Specifying A (And), O (Or), or N (Not) opens a new ON statement and links the new statement to the line containing the A/O/N specification.

Examples

ON MESSAGE -

OR

ON COMMAND

ON DSNEVENT  JOBA  STEPA

OR

ON DSNEVENT  JOBA  STEPB

Note: When specifying multiple ON statements, ensure that the statements are not mutually exclusive or not connected by an AND parameter.

Rules containing mutually exclusive ON statements connected by an AND parameter will never be triggered.

JNAME

Name of the job that issues the message. Mask characters (* and ?) are supported.

JTYPE

Job type that issues the message.

SMFID

SMF ID of the CPU on which the message or command is issued.

SYSTEM

Name of the system from which the message or command originated. Mask characters (* and ?) are supported.

ROUTE

Route code of the message.

DESC

Descriptor code of the message.

CONSOLEID

Console ID to which the message is issued or on which the operator command is entered.

CONSOLE

Name of the console on which the message is displayed. Mask characters (* and ?) are supported.

APPEARED n TIMES IN m MINUTES

Number of times the message must appear within a specified number of minutes before the rule is triggered.

jobname

Name (or mask) of the job to be monitored for data set events.

JTYPE

Job type which issues the message.

SMFID

SMF ID of the CPU to monitor for data set events. Mask characters (* and ?) are supported.

SYSTEM

Name of the system to monitor for data set events. Mask characters (* and ?) are supported.

DSN

Name of data set (or masks) to be monitored.

DISP

Data set disposition.

PROCSTEP

Procedure step name (or mask) to be monitored for this event within the selected jobs.

PGMSTEP

Program step name (or mask) to be monitored for this event within the selected jobs.

STEPRC

Completion code of the step which is monitored.