DO RESOURCE: Action Parameter

Modifies the quantity of available resources.

Figure 155 DO RESOURCE Parameter Format

Optional. Type RESOURCE (or its abbreviation RES) in the DO field and press Enter. The DO RESOURCE statement consists of the following subparameters:

Table 157 DO RESOURCE Subparameters

Subparameters	Description
name	The name of the resource whose quantity is to be changed (1 through 20 characters). No blanks (except trailing blanks) are allowed. Mandatory.
quantity	The quantity must be a 1 to 4 digit number (0 is permitted). Mandatory. To the right of the quantity, specify one of the following: + — Increases the quantity by the specified amount. - — Decreases the quantity by the specified amount. blank–Sets a new quantity for the resource.
AT	The operation is performed if the specified event occurs. The shortest unique abbreviation can be specified. Valid values are: Check in Volumes (CH) — An external volume is checked in either automatically, or manually by screen TC. Mount (M) — The media is mounted by the operator. Supported only if Y (Yes) or M (Mount) was specified for Control-M/Tape installation parameter DYNWTO. Open (O) — The data set is opened. Close (CL) — The data set is closed. Abend/Close (A) — The data set is closed due to an abend. Keep (K) — The media is dismounted and returned by the operator. Supported only if Y (Yes) or K (Keep) was specified for Control-M/Tape installation parameter DYNWTO.

Subparameters

Description

name

The name of the resource whose quantity is to be changed (1 through 20 characters). No blanks (except trailing blanks) are allowed. Mandatory.

quantity

The quantity must be a 1 to 4 digit number (0 is permitted). Mandatory.

To the right of the quantity, specify one of the following:

+ — Increases the quantity by the specified amount.
- — Decreases the quantity by the specified amount.

blank–Sets a new quantity for the resource.

The operation is performed if the specified event occurs. The shortest unique abbreviation can be specified. Valid values are:

Check in Volumes (CH) — An external volume is checked in either automatically, or manually by screen TC.
Mount (M) — The media is mounted by the operator.
Supported only if Y (Yes) or M (Mount) was specified for Control-M/Tape installation parameter DYNWTO.
Open (O) — The data set is opened.
Close (CL) — The data set is closed.
Abend/Close (A) — The data set is closed due to an abend.
Keep (K) — The media is dismounted and returned by the operator.
Supported only if Y (Yes) or K (Keep) was specified for Control-M/Tape installation parameter DYNWTO.

Note: Open, Close or Abend Close apply only for data set creation events. Keep and Mount can be activated (through ON statements) only upon attributes that are available at keep and mount time. For example, you cannot request DO CONDITION AT KEEP based on the program name, since this information is not available from the Keep message.

Parent Topic

Rule Parameters