Previous Topic

Next Topic

Book Contents

Book Index

ON Statement: Data Selection Statement

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

Rule Definition