Current plan special resource event object
This option is valid for
the current plan special resource event
object:
- CREATE request with key type SAME.
The default key type is SAME.
| Field | Type | Len | Description | APPSEL | APPFLD |
|---|---|---|---|---|---|
| SUBSYSTEM_NAME | CHAR | 4 | Subsystem name | O | N |
| SR_NAME | CHAR | 44 | Name of special resource | R | N |
| AVAILABLE | CHAR | 1 | Resource availability (Y|N|K|R) | N | O |
| QUANTITY | BIN | 31 | Number available (1-999999) | N | O |
| QUANTITY_OPTION | CHAR | 8 | Quantity option (KEEP|RESET) | N | O |
| DEVIATION | BIN | 31 | Number to deviate (-999999 to 999999) | N | O |
| DEVIATION_OPTION | CHAR | 8 | Deviation option (KEEP|RESET) | N | O |
| CREATE | CHAR | 1 | Create resource if undefined (Y|N) | N | O |
Note:
- SUBSYSTEM_NAME. See the explanation of this field2.
- AVAILABLE updates the Available field of the special resource, which overrides interval and default values. Specify Y (YES) to make the resource available or N (NO) to make it unavailable. Specify R (RESET) to set the availability status to the planned status in the current plan, or K (KEEP) to leave availability unchanged.
- QUANTITY and QUANTITY_OPTION fields are mutually exclusive. They update the Quantity field in the special resource, which overrides interval and default values. Use QUANTITY to set a numeric value or QUANTITY_OPTION to specify KEEP or RESET. If you specify both fields, message EQQE056W is written to the controller message log and the event is ignored.
- DEVIATION and DEVIATION_OPTION fields are mutually exclusive. Use DEVIATION to set a numeric value or QUANTITY_OPTION to specify KEEP or RESET. If you specify both fields, message EQQE056W is written to the controller message log and the event is ignored. The deviation field in the special resource can contain a positive or negative number, which varies the total amount of the resource. HCL Workload Automation for Z determines the total amount by adding together the quantity and the deviation. For example, if you specify -2 and the current quantity is 10, the total amount that operations can allocate reduces to 8.
- CREATE specifies
if HCL Workload Automation for Z should
create a resource in the current
plan if the resource does not exist. NO indicates that the resource
should not be added to the resource definitions of the receiving HCL Workload Automation for Z subsystem.
If the resource is already defined in the receiving subsystem, NO
has no effect. You can specify NO if the resource is being used only
as a means to generate an event for ETT: the event is generated even
if the resource does not exist.
If YES is specified and the DYNAMICADD keyword of the RESOPTS initialization statement is set to YES or EVENT, a resource definition is created in the receiving HCL Workload Automation for Z subsystem if the resource is not already defined.
- When you set the quantity or availability of a resource through the API (or other interfaces such as the SRSTAT TSO command or the MCP dialog), the specified value lasts over interval boundaries, even though the next interval can specify a different value. Specify RESET to restore the planned value.