The INQUIRE_ACTIVATION call

The INQUIRE_ACTIVATION function is provided on the DFHBABRX macro call. Use the INQUIRE_ACTIVATION call to obtain the activity name and the process type for the business transaction activity of the current transaction.

INQUIRE_ACTIVATION

  DFHBABRX [CALL,]
      [CLEAR,]
      [IN,
      FUNCTION(INQUIRE_ACTIVATION),
      [TRANSACTION_TOKEN(name8),]]
      [RETURNED_ACTIVITYID(buffer_descriptor)]
      [RETURNED_PROCESS_NAME(buffer_descriptor)]
      [OUT,
      [ACTIVITY_NAME(name16)]
      [PROCESS_TYPE(name8)]
      RESPONSE (name1 | *),
      REASON (name1 | *)] 

This command is threadsafe.

ACTIVITY_NAME(name16)
Returns the 16-character, user-assigned, name of the BTS activity.
PROCESS_TYPE(name8)
Returns the 8-character identifier of the type definition of the BTS process.
RETURNED_ACTIVITYID(buffer_descriptor)
Returns the 52-character, CICS-assigned, identifier of the BTS activity. RETURNED_ACTIVITYID is an output parameter ( BAM returns it ) and the data type is buffer, so the caller must supply an area to be used as a buffer as input to the call.
RETURNED_PROCESS_NAME(buffer_descriptor)
Returns the 36-character name of the BTS process. RETURNED_PROCESS_NAME is an output parameter ( BAM returns it ) and the data type is buffer, so the caller must supply an area to be used as a buffer as input to the call.
TRANSACTION_TOKEN(name8)
Specifies the transaction token for the task being inquired on.

RESPONSE and REASON values for INQUIRE_ACTIVATION

RESPONSE REASON
OK None
EXCEPTION ACTIVITY_NOT_FOUND
DISASTER None
INVALID INVALID_BUFFER_LENGTH
KERNERROR None
PURGED None
For more detail, refer to the explanation of RESPONSE and REASON in Making an XPI call.


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