|
|
|
|
|
(From Forecast only) Indicates the name and quantity of Quantitative resources required by the job.
Additional information |
Description |
|
|---|---|---|
Usage |
Optional. |
|
Format |
Each Quantitative resource is specified using the mandatory sub-parameters described below. |
|
Case Sensitive |
Yes. However, if the Uppercase Only check box was selected in the Add Control‑M Definition window, you cannot use lowercase characters. |
|
Invalid Characters |
|
|
Variable Name |
Yes. Variable system variables (but not other types of variables) can be specified as the entire value for this parameter. |
|
Alternate names |
|
|
Sub-parameters |
||
Name |
Name of the Quantitative resource. The following special suffixes can be appended to the specified resource name: EXAMPLE: $ represents any single character. TAPE$ can represent TAPE1 or TAPE2. However, if the job requires two TAPE$ units, it can only use two TAPE1 units or two TAPE2 units, not one of each. (The $ can only assume value 1 or 2 for the job; it cannot represent both.)
|
|
Length |
From 1 through 64 characters z/OS: 1 through 20 characters |
|
Case Sensitive |
Yes. However, if the Uppercase Only check box was selected in the Add Control‑M Definition window, you cannot use lowercase characters. |
|
Invalid Characters |
Blanks; single quotation marks. |
|
Quantity |
Amount of the resource that is required. Valid values for this field are from 1 through 9999. |
|
When a Quantitative resource is specified for a job, Control‑M determines whether a sufficient quantity of the specified resource is available before submitting the job. When the job is submitted, the specified quantity of resource is assigned to that job and is not available to other jobs. When the job finishes executing, the resource is made available to other jobs.
NOTE: A maximum of 99 Quantitative resources can be specified for a job.
The Quantitative Resources parameter is used to control the use of Quantitative resources in the installation (for example, tape drives, CPU utilization).
For load balancing, Quantitative resources are used to specify the resources that must be available on the agent computer selected by Control‑M to execute the job.
EXAMPLE: Specifying two tape drives
A Control‑M installation has 10 tape drives available for production. A job that requires the use of two tape drives is defined with a Quantitative Resources parameter specifying the number of tape drives required:
Quantitative Resources TAPE 2
Control‑M determines whether two tape drives are available. If the drives are available, and all other submission criteria for the job have been satisfied, the tape drives are allocated to the job, and the job is submitted for execution. The total number of free tape drives is now eight. When the job finishes executing, the two tape drives are returned to the pool of available resources.
EXAMPLE: Quantitative resource requirement that cannot be fulfilled
Given the following situation:
Job A requires two tape drives and contains the following parameter (all other submission criteria for the job have been satisfied):
Quantitative Resources TAPE 2
As long as two tape drives are not available, Job A is not submitted for execution.
If another tape drive is released by a different job, or if an authorized user increases the number of existing tape drives so that two are available, Control‑M submits the job for execution.
EXAMPLE: Defining a quantitative resource with a mask character
A Control‑M installation is defined as having the following Quantitative resources: three units of TAPE1 and three units of TAPE2. A job requiring three tape drives contains the following parameter:
Quantitative Resources TAPE$ 3
The job is submitted for execution when three units of the same type are available (that is, either three units of TAPE1 or three units of TAPE2) since the mask character $ can only represent a single value for a given job.
EXAMPLE: Defining multiple quantitative resources with mask characters
A job requires two tape drives and a printer:
Quantitative Resources TAPE$ 2 PRINT$ 1
Two units of TAPE1 and one unit of PRINT2 are available. However, the job is not submitted until a unit of PRINT1 becomes available since the mask character $ can only represent a single value for a given job. In this instance, $ represents the number 1.
EXAMPLE: Load balancing
A job to be submitted by the load-balancing mechanism requires 10 units of the Quantitative resource CPU:
Quantitative Resources CPU@ 10
The job is submitted to an agent computer possessing at least 10 available units of the specified resource.
Parent Topic |