RMLN gate, INITIATE_RECOVERY function
This function identifies a Recovery Manager Link object in an in doubt failed unit of work and marks it as being resynchronized.
Input Parameters
- CLIENT_NAME
- Name of the communications protocol used on the link.
- DIRECTION
- Parameter specifying whether to commit (FORWARD), backout (BACKWARD) or obey the ACTION attribute in the definition of the originating transaction.
- Values for the parameter are:
- INBOUND
- OUTBOUND
- COORDINATOR_LINK
- Optional Parameter
- A binary value indicating whether the remote system is the coordinator of the distributed unit of work.
- Values for the parameter are:
- YES
- LINK_ID_BUFFER
- Optional Parameter
- A buffer containing the termid of the session to the remote system, or the External Resource Manager qualifier.
- LINK_ID_SOURCE
- Optional Parameter
- An optional parameter specifying whether the local or remote system allocated the session.
- Values for the parameter are:
- LOCAL
- REMOTE
- LOCAL_UOW_ID
- Optional Parameter
- The local UOWID of the required unit of work.
- OTS_IORSTRING_BUFFER
- Optional Parameter
- A buffer containing the OTS IOR string.
- REMOTE_ACCESS_ID_BUFFER
- Optional Parameter
- A buffer containing the netname of the remote system, or the name of the External Resource Manager.
- 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:
- LINK_ACTIVE
- LINK_UNKNOWN
- RECOVERY_ALREADY_IN_PROG
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
- COORDINATOR
- Optional Parameter
- Whether the remote system is the coordinator of the distributed unit of work.
- Values for the parameter are:
- NO
- YES
- FAILURE_TIME
- Optional Parameter
- An 8 byte Store Clock representation of the in doubt failure time.
- INITIATOR
- Optional Parameter
- Whether the remote system is the initiator of the syncpoint of the distributed unit of work.
- Values for the parameter are:
- NO
- YES
- LINK_TOKEN
- Optional Parameter
- A token identifying the new Recovery Manager Link object.
- PRESUMPTION
- Optional Parameter
- Whether the remote system assumes the presume abort or presume nothing protocols.
- Values for the parameter are:
- ABORT
- NOTHING
- UOW_STATUS
- Optional Parameter
- The status of the unit of work.
- Values for the parameter are:
- BACKWARD
- FORWARD
- HEURISTIC_BACKWARD
- HEURISTIC_FORWARD
- INDOUBT
- UOW_TOKEN
- Optional Parameter
- A token identifying the unit of work object.