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.


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