RMUW gate, INQUIRE_UOW function

This function is used to query information about a particular unit of work.

Input Parameters

LINK_ID
Optional Parameter
A buffer in which the termid of the link to the coordinating system will be returned.
LOCAL_ACCESS_ID
Optional Parameter
A buffer in which the local access id of resource causing the unit of work to shunt will be returned.
LOG_CHAIN_TOKEN
Optional Parameter
A token that identifies the log chain whose unit of work object is to be queried.
LOGNAME
Optional Parameter
A buffer in which the log name of the coordinating system will be returned.
OTS_TID
Optional Parameter
The Open Transaction Environment (OTE) identifier of the unit of work.
REMOTE_ACCESS_ID
Optional Parameter
A buffer in which the netname of coordinating system will be returned.
TRANSACTION_TOKEN
Optional Parameter
A token that identifies the transaction whose unit of work object is to be queried.
UOW_ID
Optional Parameter
A buffer in which the network UOWID will be returned.
UOW_TOKEN
Optional Parameter
A token that identifies the unit of work object being queried.

Output Parameters

REASON
The values for the parameter are:
  • NOT_FOUND
RESPONSE
The domian's response to the call.
Values for the parameter are:
  • OK
  • EXCEPTION
  • DISASTER
  • INVALID
  • KERNERROR
  • PURGED
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
Indicates that the unit of work has completed syncpoint processing, and is just waiting for confirmation that subordinates have completed theirs.
Values for the parameter are:
  • NO
  • YES
CHOICE
Optional Parameter
The choice that has been made as to 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 indicating if this is the first unit of work for the transaction.
Values for the parameter are:
  • NO
  • YES
HEURISM
Optional Parameter
Binary value indicating 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
The local unit of work id.
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
A binary value indicating if the unit of work has been 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 transaction 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_RMUWinquire_uow.html | Timestamp icon Last updated: Monday, 5 June 2017