Previous Topic

Next Topic

Book Contents

Book Index

ON STEP (CMEM): Event Parameter

Monitor a job step termination event.

Figure 365 ON STEP (CMEM) Parameter Format

Optional. Type S (STEP) in the ON field and press Enter. The following subparameters are displayed:

Table 244 ON STEP (CMEM) Subparameters

Subparameter

Description

job

Name (or mask) of the job to be monitored for step termination. Mandatory.

JTYPE

Type of job to be monitored for step termination. Optional. Valid values are:

  • J (Job) – batch job
  • S (STC) – started task
  • T (TSU) – TSO user task
  • blank – any type of job. Default.

If JTYPE is entered, only the termination of steps from the specified type of job can trigger the rule.

SMFID

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

SYSTEM

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

PROCSTEP

Name (or mask) of a step invoking a procedure or, for a started task, task ID. Optional. If omitted, all procedure steps in the selected jobs are monitored.

 

Note: When a started task is initiated, it can be assigned a task ID. For example, in command S GTF.G, the task ID of GTF is G. If a task ID is not entered, MVS assigns a default task ID to the started task, as follows:

  • For a system started task with stepname IEFPROC, MVS sets an internal task ID.
  • For other started tasks, the default task ID equals the procedure (started task) name.

Therefore, when using CMEM to monitor system started tasks, if no task ID is entered in the START command, do not specify the PROCSTEP parameter.

PGMSTEP

Name (or mask) of a step invoking a program. Optional. If omitted, all program steps in the selected jobs are monitored.

Note: When a system started task with stepname IEFPROC is initiated, MVS assigns the step a default program step name. Therefore, when using CMEM to monitor these system started tasks, do not specify the PGMSTEP parameter.

STEPRC

Return codes and/or statuses returned upon termination of the specified steps that satisfy the step termination criteria. Valid values are:

  • ‘  ‘ (Blank) or **** – step ended with any code or status
    If no value or four asterisks are entered, the return code or status is irrelevant.
  • OK – step ended with a condition code of 0
  • NOTOK – step ended with a nonzero code
  • Cnnnn – step ended with the indicated condition code
  • Snnn – step ended with the indicated system abend code
  • Unnnn – step ended with the indicated user abend code

Asterisks can be entered instead of code digits; condition codes and abends can be preceded by code qualifiers (<, >, N). For more information, see the following section, "General Information".

And/Or/Not

Conjunctional parameter that opens a new ON statement and links it to the previous ON statement. Valid values are:

  • A (And) – indicates AND logic between the two ON statements
  • O (Or) – indicates OR logic between the preceding and following sets of ON statements
  • N (Not) – indicates AND NOT logic between the two ON statements

Parent Topic

Control-M Event Manager (CMEM)