The Control-M/Tape Action parameters (DO parameters) are used to specify processing instructions to be performed by the rule. The actions specified using the DO parameters are performed only after conditions specified in the ON block have been satisfied.
Note: A list of valid DO parameters can be alternately displayed or hidden on the screen by typing the command DOOPT (abbreviated DOO) in the COMMAND field and pressing Enter.
The DO parameter specifies an action to be taken. An unlimited number of DO parameters are permitted. The combination of DO parameters specified in the rule form a DO block.
It is possible to create a rule without specifying any Action parameters. One use for a rule without a DO block is for changing the Control-M/Tape operation mode systematically, without performing other actions.
To specify Action parameters, type the parameter name next to the DO on the Rule Definition screen, and press Enter. Depending on the specified parameter, different subparameters are displayed on the screen.
Note: It is usually not necessary to enter the full parameter name; the shortest unique abbreviation or code letter of the command is sufficient.
DOM Actions
The Action parameters are divided into the following categories:
Table 40 Action Parameter Categories
Category |
Description |
---|---|
IOA-compatible |
DO parameters that interface with, or are common to, the INCONTROL family of products. DO parameters in this category are DO SHOUT, DO RESOURCE, DO FORCEJOB, DO SET, and DO CONDITION. |
Unique to Control-M/Tape |
All remaining DO parameters are unique to Control-M/Tape. |
The following are a description and example of each of the DO statement options:
DO ABENDRET – Specifies how long the data set should be retained if an abend or a system crash occurs while creating the data set (meaning, the data set is incomplete or unreliable). Only one DO ABENDRET statement can be specified per rule.
===========================================================================
DO ABENDRET = CYCLES 0010 PREFIX Y (Y/N) And/Or A
DATE 0101 YEAR 2000 And/Or A
LAST ACCESS 0090 And/Or
DO
===========================================================================
DO BYPASS – Indicates whether Control-M/Tape should bypass tape management activities for the data set.
===========================================================================
DO BYPASS = YES
DO
===========================================================================
DO CONDITION – Adds or deletes a prerequisite condition. Prerequisite conditions are used to trigger events in other INCONTROL products.
===========================================================================
DO CONDITION = TAPE-MOUNTED ODAT +
AT M (CHeck volumes /Mount /Open / CLose /Abend Close /Keep)
===========================================================================
DO DYNDS – Indicates whether a data set should be dynamically added to the Media Database.
===========================================================================
DO DYNDS = YES
DO
===========================================================================
DO DYNVOL – Indicates whether a volume should be dynamically added to the Media Database.
===========================================================================
DO DYNVOL = SPECIFIC REQUEST= Y NON SPECIFIC REQUEST (SCRATCH)= E
DO
===========================================================================
DO FASTPOS – Indicates whether Control-M/Tape should request Fast Positioning for a tape.
===========================================================================
DO FASTPOS = YES
DO
===========================================================================
DO FORCEJOB – Force (schedule) a jobs under Control-M.
===========================================================================
DO FORCEJOB = TABLE JOBCHECK JOB PROD032 DATE ODAT
LIBRARY CTM.PROD.SCHEDULE
AT A (CHeck volumes /Mount /Open / CLose /Abend Close /Keep)
DO
===========================================================================
DO LABEL – Determines whether an external label is printed upon creation of the data set. Only one DO LABEL statement can be specified per rule.
===========================================================================
DO LABEL = Y (Y/N)
DO
===========================================================================
DO OVERJCL – Indicates whether MVS retention attributes for the data set should be overridden by Control-M/Tape rules.
===========================================================================
DO OVERJCL = YES
DO RETENTION = DAYS 00030 And/Or
DO
===========================================================================
DO OWNER – Assigns an owner to a volume. Only one DO OWNER statement can be specified per rule.
===========================================================================
DO OWNER = SUPV043
DO
===========================================================================
DO POOL – Indicates the pool from which scratch volumes should be taken. Only one DO POOL statement can be specified per rule.
===========================================================================
DO POOL = ACCOUNTING
DO
===========================================================================
DO RECREATE – Indicates whether an existing data set should be overwritten by the data set.
===========================================================================
DO RECREATE = YES
DO
===========================================================================
DO RESOURCE – Modifies the quantity of a Quantitative resource.
===========================================================================
DO RESOURCE = TAPE1 0001 +
AT CL (CHeck volumes /Mount /Open / CLose /Abend Close /Keep)
===========================================================================
DO RETENTION – Specifies how long the data set should be retained. Only one DO RETENTION statement can be specified per rule.
===========================================================================
DO RETENTION = PERMANENT And/Or
DO
===========================================================================
DO SET – Assigns a value to an IOA AutoEdit variable.
===========================================================================
DO SET = %%TAPEOK=0
MEMBER TAPESTAT LIBRARY CTT.PROD.STATS
AT A (CHeck volumes /Mount /Open / CLose /Abend Close /Keep)
===========================================================================
DO SHOUT – Issues a message (to a console, a TSO user ID, the IOA Log, ROSCOE user, or Info/Management).
===========================================================================
DO SHOUT = TO TSO-MRE URGENCY U
MESSAGE TAPE CLOSE DURING ABEND
AT A (CHeck volumes /Mount /Open / CLose /Abend Close /Keep)
===========================================================================
DO STACK – Enables or disables stacking of data sets on existing volumes. Only one DO STACK statement can be specified per rule.
===========================================================================
DO STACK = N (Y/N) SCOPE VOL
DO
===========================================================================
DO STKDEFSZ – Indicates a default size to use for calculating stacking statistics for the data set.
===========================================================================
DO STKDEFSZ = 0050 OVERRIDE STATISTICS YES
DO
===========================================================================
DO STKGROUP – Indicates a stacking group for the data set.
===========================================================================
DO STKGROUP = STKGRP1
DO
===========================================================================
DO STKMODE – Indicates a method to be used for stacking the data set.
===========================================================================
DO STACK = Y (Y/N)
DO STKMODE = ALL
DO
===========================================================================
DO STKMXLBL – Indicates a maximum number of data sets with which the data set can be stacked on a volume or group of volumes.
===========================================================================
DO STACK = Y (Y/N)
DO STKMXLBL = 0005
DO
===========================================================================
DO STKMXVOL – Indicates the maximum number of volumes in a chain on which the data set can be stacked.
===========================================================================
DO STACK = Y (Y/N)
DO STKMXVOL = 0002
DO
===========================================================================
DO STKRULE – Indicates a stacking limitation for the data set.
===========================================================================
DO STACK = Y (Y/N)
DO STKRULE = NOT WITH JOB JOB1
DSN
DO STKRULE = NOT WITH JOB
DSN DSN1
DO STKRULE = NOT WITH JOB JOB2
DSN DSN2
DO
===========================================================================
DO STKSRCHL – Indicates a maximum number of volumes to consider for stacking the data set.
===========================================================================
DO STACK = Y (Y/N)
DO STKSRCHL = 0300
DO
===========================================================================
DO VAULT – Identifies vault names and retention specifications for storing volumes.
===========================================================================
DO VAULT = VAULTA BY BOX (Y/N)
UNTIL DATE 0101 YEAR 2000 And/Or
VAULT =
===========================================================================
DO
Parent Topic |