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.