Previous Topic

Next Topic

Book Contents

Book Index

ON Statement: Selection Parameter

Specification of selection criteria. The access of media that meet the selection criteria triggers the rule. Control-M/Tape can then perform DO actions on the media.

Figure 192 ON Parameter Format

Type a valid option (abbreviated V, D, J, A, US, P, ME, MG, or UC) in the ON field and press Enter. Specify subparameters for each option as prompted.

Table 171 ON Subparameters

Subparameter

Description

VOLSER (V)

Syntax:

VOLSER (V) volser_start TO volser_end

where:

  • volser_start – Volume serial number (or starting volume serial number in a range) that contains the data set (6 characters). Character masking is supported if no range is specified.
  • volser_end – Ending volume serial number if a range is specified. Character masking is not supported in this field.

DATASET (D)

 

Name (or mask) of the data set (1 to 33 characters).

Every rule definition must contain one ON DATASET statement. If no ON DATASET statement is specified, Control-M/Tape automatically adds the expression ON DATASET=* to the rule definition.

Note: In rules in which Generation Data Group (GDG) data sets are to be stacked (using the expression DO STACK=Y) only the base name of the data set is specified in the ON DATASET statement (without the last period). For example, if the data set name is A.B.C.G0001V00, the ON statement is as follows:

ON DATASET=A.B.C

JOBNAME (J)

Name (or mask) of the job that created the data set (1 through 8 characters).

ACCOUNT (A)

JCL accounting information (or mask) of the job that created the data set.

USERID (US)

User ID (or mask) of the user assigned to the job that created the data set (1 through 8 characters). The default is site dependent.

PGM (P)

Name (or mask) of the programs that created the data set (1 through 8 characters).

MEDIA (ME)

Media type of the volume (for example, cartridge, tape). (1 through 8 characters.) The values for this field must match those specified in a predefined table specified by the user in member CTTPARM. For additional information, see the INCONTROL for z/OS Installation Guide.

Character masking is not supported.

MGMTCLAS (MG)

DFSMS Management Class (1 through 8 characters). Relevant only if the Control-M/Tape to DFSMS interface is active. For additional information, see Control-M/Tape to DFSMS Interface.

UCB (UC)

 

Unit Control Block (UCB) or range of UCBs of the device on that the data set is created. Mask characters (* and ?) can be specified for this field.

Notes: A second value (in the TO field) should only be specified if a range is indicated.

Mask characters cannot be specified as part of a range in an ON UCB statement.

Examples

Specifying a value:

ON UCB=01A2 TO

Specifying a range:

ON UCB=0100 TO 0200

Specifying a mask:

ON UCB=01?? TO

Parent Topic

Rule Parameters