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.


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