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.


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