Selection parameters specify selection criteria (ON statements) that must be fulfilled before Control-M/Tape performs designated actions.
Note: A list of valid ON parameters can be alternately displayed or hidden on the screen by typing the command ONOPT (abbreviated O) in the COMMAND field and pressing Enter.
An ON statement is comprised of the ON field, and its corresponding parameters. The ON DATASET statement is required in each rule definition. If it is not specified, Control-M/Tape automatically adds ON DATASET = * (an unqualified ON DATASET statement) as the last ON statement.
An unlimited number of ON statements can be specified in an ON block, using the And/Or/Not parameter described below.
Character masking (described in Character Masking) can be used in any of the specified criteria described in Table 39, except ON MEDIA and ON VOLSER (if a range is specified).
===========================================================================
ON DATASET = * And/Or/Not A
ON ACCOUNT = A001 And/Or/Not
===========================================================================
The syntax of the ON statement is
ON selection_criteria
When the selection_criteria of a volume and data set is accessed, they trigger the rule.
To add a selection condition to a rule, type a valid ON parameter in the ON field and press Enter. To delete a specified selection condition, delete the ON parameter keyword and press Enter.
Valid selection criteria options and their abbreviations are:
Table 39 ON Parameter Options
Option |
Description |
---|---|
V (VOLSER) |
Volume serial numbers or range of volume serial numbers. (If a range is specified, character masking is not supported.) |
D (DATASET) |
Data set specification. |
J (JOBNAME) |
Job names that created the data set. |
A (ACCOUNT) |
Job accounting information. |
US (USERID) |
Security user IDs assigned to the job that created the data set. |
P (PGM) |
Program that created the data set. |
ME (MEDIA) |
Media type (for example, cartridge, tape). Allowed values are specified in a table predefined by the user. Character masking is not supported. |
MG (MGMTCLAS) |
DFSMS Management Class (1 to 8 characters). Relevant only if the Control-M/Tape to DFSMS interface is active. For more information, see Control-M/Tape to DFSMS Interface. |
UC (UCB) |
Unit Control Block (UCB) device number or range of device numbers of the unit on which the data set is created. |
|
|
And/Or/Not |
Conjunctional parameter for linking ON statements. Specifying A (And), O (Or), or N (Not) opens a new ON statement and links the new statement to the line containing the A/O/N specification. |
Parent Topic |