RMUW gate, GET_NEXT_UOW function
This function returns information about the next unit of work object in the browse.
Input Parameters
- BROWSE_TOKEN
- A token obtained from a previous START_UOW_BROWSE call.
- LINK_ID
- Optional Parameter
- An optional parameter specifying a buffer in which the termid of the link to the coordinating system will be returned.
- LOCAL_ACCESS_ID
- Optional Parameter
- An optional parameter specifying a buffer in which the local access id of resource causing the unit of work to shunt will be returned.
- LOGNAME
- Optional Parameter
- An optional parameter specifying a buffer in which the log name of the coordinating system will be returned.
- OTS_TID
- Optional Parameter
- REMOTE_ACCESS_ID
- Optional Parameter
- An optional parameter specifying a buffer in which the netname of coordinating system will be returned.
- UOW_ID
- Optional Parameter
- An optional parameter specifying the network UOWID to be given to the unit of work object. This parameter will be present if the unit of work being created is part of a distributed unit of work that originated on another system.
Output Parameters
- REASON
- The values for the parameter are:
- BROWSE_END
- INVALID_BROWSE_TOKEN
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
- ACCESS_ID_TYPE
- Optional Parameter
- The type of resource that has caused the unit of work to shunt.
- Values for the parameter are:
- LOCAL
- REMOTE
- AWAITING_FORGET
- Optional Parameter
- The unit of work might have completed syncpoint processing, and be merely waiting for confirmation that subordinates have completed theirs.
- Values for the parameter are:
- NO
- YES
- CHOICE
- Optional Parameter
- The choice of whether the unit of work should commit or backout if requested to take a unilateral decision.
- Values for the parameter are:
- BACKWARD
- FORWARD
- CLIENT_NAME
- Optional Parameter
- The name of the Recovery Manager client that owns the resource that has caused the unit of work to shunt.
- CREATION_TIME
- Optional Parameter
- An 8 byte Store Clock representation of the time the unit of work was created.
- DURATION
- Optional Parameter
- An 8 byte Store Clock representation of the time the unit of work changed state.
- FIRST_UOW_FOR_TXN
- Optional Parameter
- A binary value that indicates whether this is the first unit of work in the CICS transaction.
- Values for the parameter are:
- NO
- YES
- HEURISM
- Optional Parameter
- Whether the unit of work should take a unilateral decision if a failure occurs in the in doubt window.
- Values for the parameter are:
- NO
- YES
- LOCAL_UOW_ID
- Optional Parameter
- An optional parameter to receive the local UOWID.
- OP_ID
- Optional Parameter
- The Operator Id associated with the task that created the unit of work.
- OUT_UOW_TOKEN
- Optional Parameter
- The token used to identify the unit of work object.
- SHUNTED
- Optional Parameter
- The unit of work may or may not be shunted.
- Values for the parameter are:
- NO
- YES
- TERMID
- Optional Parameter
- The termid associated with the task that created the unit of work object.
- TERMINAL_LUNAME
- Optional Parameter
- The terminal LU name associated with the task that created the unit of work object.
- TRANID
- Optional Parameter
- The tranid of the task that created the unit of work object.
- TRANNUM
- Optional Parameter
- The task number of the task that created the unit of work.
- UOW_STATUS
- Optional Parameter
- The status of the unit of work.
- Values for the parameter are:
- BACKWARD
- FORWARD
- HEURISTIC_BACKWARD
- HEURISTIC_FORWARD
- IN_DOUBT
- IN_FLIGHT
- USERID
- Optional Parameter
- The userid associated with the task that created the unit of work object.