RSSR gate, START_RECORDING function
START_RECORDING starts the recording of region status data into a coupling facility data table (CFDT).
Input parameters
- FILE_NAME
- Specifies a 16-character file name.
- POOL_NAME
- Specifies an 8-character pool name.
- REGION_NAME
- Specifies an 8-character region name.
- THRESHOLD_PERCENTAGE
- Specifies the threshold percentage, as a halfword binary value. The value specified must be in the range 0 - 31.
- <UPPER_TIER_PERCENTAGE>
- Specifies the upper-tier percentage, as a halfword binary value. The value specified must be in the range 0 - 31.
- <LOWER_TIER_PERCENTAGE>
- Specifies the lower-tier percentage, as a halfword binary value. The value specified must be in the range 0 - 31.
- <STATUS_BLOCK_TOKEN>
- The token that identifies a status block where the region status is to be copied.
- <FAILURE_ECB_PTR>
- The token that identifies the address of an ECB to be posted when connection to the CFDT server is lost.
Output parameters
- REASON
- One of the following values is returned when RESPONSE is DISASTER:
- ABEND
- LOOP
- LOCK_FAILURE
- One of the following values is returned when RESPONSE is EXCEPTION:
- RECORDING_NOT_ACTIVE
- INCORRECT_POOL_NAME
- TARGET_NOT_KNOWN
- SERVER_FAILED
- One of the following values is returned when RESPONSE is INVALID:
- INVALID_FORMAT
- INVALID_FUNCTION
- RECORDING_ACTIVE
- The following value is returned when RESPONSE is PURGED:
- TASK_CANCELLED
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.