General Information for ON STEP (CMEM)

ON STEP rules are triggered when specified job steps terminate with specified return codes or statuses.

Entering values for the optional subparameters PROCSTEP, PGMSTEP and STEPRC limits the situations that can satisfy the step termination event. Conversely, if a subparameter is blank, that subparameter is ignored.

• If a PGMSTEP and PROCSTEP value are both entered, the rule is triggered only if the specified PGMSTEP is completed in the specified PROCSTEP.
• If a PGMSTEP value is entered without a PROCSTEP value, the rule is triggered if the PGMSTEP is completed anywhere within the job stream.

CMEM must be active before any tasks tracked by ON STEP rules begin; moreover, ON STEP rules only intercept data set events for jobs, started tasks, or TSO users that started after the rule was ordered.

Note: To monitor data set events for a job, started task or TSO user, the job, started task or TSO user must have MSGLEVEL=(1,1) and message IEF403I or IEF125I must appear in the job log. A DSNEVENT can be triggered only on the Control-O/CMEM that runs on the same z/OS system on which the event occurs. Even a focal Control-O or CMEM in a Sysplex environment is insufficient. This is because Control-O or CMEM intercepts the messages written to JESYSMSG while they are being written, which can be done only on the same system where the event happens.

The SMFID and SYSTEM Subparameters

The default values for the SMFID and SYSTEM subparameters are the current system. If no value is entered for either SMFID or SYSTEM, the rule is triggered only by events that occur in the current system.

The STEPRC Subparameter

When entering a condition code or abend code in the STEPRC subparameter, any characters in the code can be replaced by an asterisk (*). An asterisk means "any value" for the character it replaces. For example, if S*13 is entered, the code criteria is satisfied by codes S013, S613, S913, and so on. When entering condition and/or abend codes, the following qualifiers can be used as indicated:

Table 245 ON STEP Subparameter STEPRC Qualifiers