RSSR gate, INQUIRE_TARGET_STATUS function

INQUIRE_TARGET_STATUS retrieves information about target region status.

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.
<STATUS_BLOCK_TOKEN>
The token that identifies a status block where the region status is to be copied.

Output parameters

<SOS>
Specifies whether a target region is short-on-storage in the CICS environment.
The values of this parameter are:
  • NO
  • YES
<MAXTASK>
Specifies whether a target region is at maxtask within the CICS environment.
The values of this parameter are:
  • NO
  • YES
<SDUMPACTIVE>
Specifies whether a system dump is active in the target region.
The values of this parameter are:
  • NO
  • YES
<TDUMPACTIVE>
Specifies whether a transaction dump is active in the target region.
The values of this parameter are:
  • NO
  • YES
<CURRENT_TASK_COUNT>
The number of running tasks used to evaluate the load on the current routing target.
<MAX_TASK_COUNT>
The defined maximum number of active tasks that can concurrently run in the routing target.
<THRESHOLD_PERCENTAGE>
The threshold percentage of the target region, as a halfword binary value.
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_RSSRinquire_target_status.html | Timestamp icon Last updated: Monday, 5 June 2017