Defines the data source that the rule processes.
Figure 237 ON Statement Format
Mandatory. Type one of the data source options – CLASS, DB2, DDNAME, DSN, FILE, PAGE, SYSDATA, SYSOUT, VSAM, DATA – in the ON field and press Enter. If the selected option is valid, Control-M/Analyzer displays the relevant parameters.
Note: It is usually not necessary to enter the full name of the data source option. The shortest unique abbreviation of the option is sufficient.
Each ON statement is summarized below and discussed in detail on the following pages.
Table 251 ON STATEMENT Fields
Field |
Description |
---|---|
ON CLASS |
Processes all outputs of jobs belonging to the specified class, destination, external writer, and form. Control-M/Analyzer receives the output characteristics from the system. |
ON COMPARE |
Compares two data sources. |
ON DATA |
Processes Control-M/Analyzer variables. ON DATA is unique in that it provides conditional execution through the IF statement and unconditional execution through the ALWAYS statement. The WHEN statement cannot be specified. |
ON DB2 |
Processes data from DB2 tables using the dynamic SQL facility. |
ON DDNAME |
Processes the sequential datasets referenced by the specified DD statement in the current step (for example, the step from which the Control-M/Analyzer Runtime Environment was invoked). |
ON DSN |
For Control-D users: Processes one or more Compressed Dataset Access Method (CDAM) files. CDAM selection criteria must be specified. |
ON FILE |
Processes a sequential dataset. Control-M/Analyzer receives the characteristics of the sequential dataset from the system. The file name must represent a physical sequential (PS) dataset, or a partitioned dataset (PDS), with member name in parentheses. |
ON PAGE |
For Control-D users: Processes pages passed to the Control-M/Analyzer rule when Control-M/Analyzer is invoked by the Control-D monitor (by statement DO CTBRULE in a report decollating mission). |
ON SYSDATA |
For Control-M and Control-M/Restart users: Processes the three job sysout datasets referred to as SYSDATA. SYSDATA is available to the current job when Control-M/Analyzer is invoked by the Control-M monitor (by statement DO CTBRULE in a job scheduling definition). |
ON SYSOUT |
Processes sysouts referenced by the specified DD statement. Control-M/Analyzer receives the output characteristics from the system. ON SYSOUT is only available under JES2. |
ON VSAM |
Processes VSAM file records using user-specified keys, or record addresses (RBAs). |
Parent Topic |