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 |