Previous Topic

Next Topic

Book Contents

Book Index

Selection Parameters: ON Statement

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.

     =====================================================================

ON DATASET   = DS303K.INF                                And/Or/Not A

ON ACCOUNT   = A001                                      And/Or/Not O

ON JOBNAME   = RT*                                       And/Or/Not

      =====================================================================

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

Rule Definition Screen