RESOURCE: Runtime Scheduling Parameter

Quantitative resources and their quantities required by the job.

Figure 286 RESOURCE Parameter Format

Optional. A maximum of two Quantitative resources can be specified in each RESOURCE line. Upon specifying the second Quantitative resource in a line and pressing Enter, a new line is opened, for specifying additional Quantitative resources.

Each specified Quantitative resource consists of the mandatory subparameters described in Table 210 and may include the optional parameters described in Table 211.

Table 210 Mandatory RESOURCE Subparameters

Subparameter	Description
res_name	User-supplied, descriptive name of 1 through 20 characters to identify the Quantitative resource.
quantity	Quantity of the Quantitative resource required by the job. The specified value must be four digits (leading zeros must be specified).

Table 211 Optional RESOURCE Subparameters

Subparameter	Description
onOk	Whether to keep the Quantitative resource tied to the job if the job ends OK. Valid values are: ' ' (blank) – release the resource The resource is not kept, and is returned to the total quantity available for other jobs. Default. D – discard the resource The resource is not reusable. The quantity of the resource is permanently removed from the total quantity available for other jobs.
onFail	Whether the Quantitative resource remains allocated to the job if the job ends NOTOK. Valid values are: ' ' (blank) – release the resource The resource does not remain allocated to the job. Default. K – keep the resource The resource remains allocated to the job until one of the following occurs: — the job is rerun and ends OK — the job is deleted — the job is FORCEd OK

Subparameter

Description

onOk

Whether to keep the Quantitative resource tied to the job if the job ends OK. Valid values are:

' ' (blank) – release the resource
The resource is not kept, and is returned to the total quantity available for other jobs. Default.
D – discard the resource
The resource is not reusable. The quantity of the resource is permanently removed from the total quantity available for other jobs.

onFail

Whether the Quantitative resource remains allocated to the job if the job ends NOTOK. Valid values are:

' ' (blank) – release the resource
The resource does not remain allocated to the job. Default.
K – keep the resource
The resource remains allocated to the job until one of the following occurs:
— the job is rerun and ends OK

— the job is deleted

— the job is FORCEd OK

Example of RESOURCE Subparameters

TAPE 2 D K

Assume that the total number of TAPE resources is 5.

If the job ends OK, the total number of TAPE resources stays at 3, since 2 TAPE resources are permanently discarded.

If the job is rerun, and there are enough TAPE resources, Control-M allocates a quantity of 2 TAPE resources for the job. The total number of TAPE resources is then reduced to 1.

If the job ends NOTOK, the total number of TAPE resources stays at 5, but the available number of resources will be 3. The job keeps the 2 TAPE resources.

If the job is rerun, Control-M reallocates a quantity of 2 TAPE resources for the job. The total number of TAPE resources stays at 5, and the available number of resources stays at 3.

Parent Topic

Job Production Parameters