XMIQ gate, GET_NEXT_TRANSACTION function
The GET_NEXT_TRANSACTION function of the XMIQ gate is used to inquire upon the next transaction in a transaction browse.
Input Parameters
- BROWSE_TOKEN
- Token identifying this browse of the transaction definitions.
- ATTACH_PARMS
- Optional Parameter
- Parameters to be passed to the attached transaction.
Output Parameters
- REASON
- The following values are returned when RESPONSE is DISASTER:
- ABEND
- LOOP
- The following values are returned when RESPONSE is EXCEPTION:
- BROWSE_END
- The following values are returned when RESPONSE is INVALID:
- INVALID_BROWSE_TOKEN
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
- ATTACH_TIME
- Optional Parameter
- The time when the transaction was attached.
- CICS_UOW_ID
- Optional Parameter
- The CICS Unit Of Work Identifier associated with the transaction.
- CONFDATA
- Optional Parameter
- The value of the CONFDATA attribute specified in the transaction definition.
- Values for the parameter are:
- NO
- YES
- DS_TASK_TOKEN
- Optional Parameter
- A token that identifies the dispatcher task associated with the transaction.
- DTIMEOUT
- Optional Parameter
- The deadlock timeout value for the transaction.
- DYNAMIC
- Optional Parameter
- Whether the transaction is defined to be dynamic.
- Values for the parameter are:
- NO
- YES
- ENTRYPOINT_RES_TOKEN
- Optional Parameter
- An 8-byte token that represents the application entry point.
- FACILITY_NAME
- Optional Parameter
- The name of the principal facility associated with the transaction.
- FACILITY_TOKEN
- Optional Parameter
- A token that represents the principal facility associated with the transaction.
- FACILITY_TYPE
- Optional Parameter
- The type of the principal facility associated with the transaction.
- Values for the parameter are:
- IPECI
- NONE
- START
- TD
- TERMINAL
- INITIAL_PROGRAM
- Optional Parameter
- Initial program of transaction.
- NETNAME
- Optional Parameter
- The network name of a terminal principal facility.
- OPERATION_NAME
- Optional Parameter
- The name of the application operation for which the TRANSACTION is declared as an application entry point.
- ORIGINAL_TRANSACTION_ID
- Optional Parameter
- The transid that was used to attach the transaction.
- OUT_TRANSACTION_TOKEN
- Optional Parameter
- The token that represents this transaction.
- PHASE
- Optional Parameter
- The phase of the transaction.
- Values for the parameter are:
- BIND
- INIT
- PRE_INIT
- TERM
- PRIMARY_CLIENT_TOKEN
- Optional Parameter
- A token representing the client for which the transaction was attached.
- PRIMARY_CLIENT_TYPE
- Optional Parameter
- The type of client for which the transaction was attached.
- Values for the parameter are:
- APPC_SESSION
- BRIDGE
- IIRR
- IP_ECI
- LU61_SESSION
- MRO_SESSION
- NONE
- RRS_UR
- RZ_INSTORE_TRPORT
- SCHEDULER
- SOCKET
- START
- START_TERMINAL
- TERMINAL
- TRANDATA
- WEB
- XM_RUN_TRANSACTION
- RE_ATTACHED_TRANSACTION
- Optional Parameter
- Indicates if the transaction was reattached.
- Values for the parameter are:
- NO
- YES
- REMOTE
- Optional Parameter
- Whether the transaction is remote.
- Values for the parameter are:
- NO
- YES
- REMOTE_NAME
- Optional Parameter
- The name of a remote transaction on the remote system.
- REMOTE_SYSTEM
- Optional Parameter
- The system that a remote transaction is to be routed to.
- RESOURCE_NAME
- Optional Parameter
- The name of a resource that a suspended transaction is waiting for.
- RESOURCE_TYPE
- Optional Parameter
- The type of resource that a suspended transaction is waiting for.
- RESTART
- Optional Parameter
- Whether the transaction is restartable.
- Values for the parameter are:
- NO
- YES
- RESTART_COUNT
- Optional Parameter
- Contains the number of times this transaction instance has been restarted.
- SPURGE
- Optional Parameter
- Whether the transaction is system-purgeable.
- Values for the parameter are:
- NO
- YES
- START_CODE
- Optional Parameter
- Indicates the reason for the attach of the transaction.
- Values for the parameter are:
- C
- DF
- QD
- S
- SD
- SZ
- T
- TT
- STATUS
- Optional Parameter
- The status of the transaction.
- Values for the parameter are:
- READY
- RUNNING
- SUSPENDED
- SUSPEND_TIME
- Optional Parameter
- Contains the length of time that the transaction has currently been suspended for.
- SYSTEM_TRANSACTION
- Optional Parameter
- Whether the transaction has been attached by CICS.
- Values for the parameter are:
- NO
- YES
- TASK_PRIORITY
- Optional Parameter
- The combined priority of the transaction.
- TCLASS
- Optional Parameter
- Whether the transaction belongs to a tclass.
- TCLASS_NAME
- Optional Parameter
- The name of the tclass that the transaction belongs to.
- TPURGE
- Optional Parameter
- Whether the transaction can be purged after a terminal error.
- Values for the parameter are:
- NO
- YES
- TRAN_PRIORITY
- Optional Parameter
- Transaction priority
- TRAN_ROUTING_PROFILE
- Optional Parameter
- Profile to be used to route a remote transaction to a remote system.
- TRANDEF_TOKEN
- Optional Parameter
- The token representing the returned transaction definition.
- TRANNUM
- Optional Parameter
- Is the transaction number assigned to the newly attached transaction.
- TRANSACTION_GROUP_ID
- Optional Parameter
- The identifier of the transaction's monitoring group.
- TRANSACTION_ID
- Optional Parameter
- Transaction identifier
- USERID
- Optional Parameter
- The userid of the user associated with the transaction.