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.


dfhs3_RSSRstart_recording.html | Timestamp icon Last updated: Monday, 5 June 2017