BRIQ gate, INQUIRE_CONTEXT function
The INQUIRE_CONTEXT of the BRIQ gate is called to inquire on bridge state data.
Input Parameters
- TRANSACTION_TOKEN
- Optional Parameter
- The XM transaction token for the task to be inquired upon.
Output Parameters
- REASON
- The following values are returned when RESPONSE is DISASTER:
- ABEND
- The following values are returned when RESPONSE is EXCEPTION:
- BAD_TOKEN
- NO_TRANSACTION_ENVIRONMENT
- The following values are returned when RESPONSE is INVALID:
- INVALID_FORMAT
- INVALID_FUNCTION
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
- BFB_TOKEN
- Optional Parameter
- The address of the BFB that was constructed or is to be re-used to satisfy this allocate.
- BRDATA
- Optional Parameter
- Data passed to the bridge exit during attach.
- BRIDGE_ENVIRONMENT
- Optional Parameter
- Indicates whether the task was started with a bridge facility.
- Values for the parameter are:
- NO
- YES
- BRIDGE_EXIT_PROGRAM
- Optional Parameter
- The name of the bridge exit program (if CONTEXT is BRIDGE or BREXIT).
- BRIDGE_FORMATTER_PROGRAM
- Optional Parameter
- If CONTEXT(BREXIT) or CONTEXT(BRIDGE) is specified, the name of the bridge formatter user-replaceable program which is used to handle API commands emulated by the bridge.
- BRIDGE_TRANSACTION_ID
- Optional Parameter
- The transaction that started the task running in a bridge environment.
- CALL_EXIT_FOR_SYNC
- Optional Parameter
- Indicates if the bridge exit will be called for processing an explicit or implicit syncpoint
- Values for the parameter are:
- NO
- YES
- CONTEXT
- Optional Parameter
- The current program link level
- Values for the parameter are:
- BREXIT: a bridge exit or formatter is in control
- BRIDGE: a task with a bridge exit is in control
- NORMAL: the task is not running in a bridge environment.
- FACILITYTOKEN
- Optional Parameter
- The 8 byte token used to represent the bridge session
- IDENTIFIER
- Optional Parameter
- Data created by the bridge exit for problem determination purposes.
- START_CODE
- Optional Parameter
- The emulated startcode of the user transaction
- START_TYPE
- Optional Parameter
- Indicates how the task was started in the bridge environment.
- Values for the parameter are:
- LINK: the task was started using the Link3270 bridge.
- START: the task was started using the START BREXIT mechanism.