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.

Table 1. CP_SR_EVENT Object Fields
FieldTypeLen DescriptionAPPSELAPPFLD
SUBSYSTEM_NAME CHAR4Subsystem name ON
SR_NAMECHAR44 Name of special resourceRN
AVAILABLECHAR1 Resource availability (Y|N|K|R) NO
QUANTITYBIN31 Number available (1-999999) NO
QUANTITY_OPTION CHAR8Quantity option (KEEP|RESET)NO
DEVIATIONBIN 31Number to deviate (-999999 to 999999)N O
DEVIATION_OPTIONCHAR 8Deviation option (KEEP|RESET)N O
CREATECHAR 1Create resource if undefined (Y|N)N O
Note:
  1. SUBSYSTEM_NAME. See the explanation of this field2.
  2. 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.
  3. 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.
  4. 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.
  5. 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.

  6. 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.