RMLN gate, ADD_LINK function
This function adds a link to a remote system to a unit of work. The unit of work is distributed across more than one system and Recovery Manager will manage the syncpoint processing between systems.
Input Parameters
- CLIENT_NAME
- Name of the communications protocol used on the link.
- RMC_TOKEN
- A token to be passed to the client on all callback functions.
- COORDINATOR
- Optional Parameter
- A parameter specifying whether the remote system is the coordinator of the distributed unit of work.
- Values for the parameter are:
- NO
- YES
- INITIATOR
- Optional Parameter
- A parameter specifying whether the remote system is the initiator of the syncpoint.
- Values for the parameter are:
- NO
- YES
- LAST
- Optional Parameter
- A parameter specifying whether the remote system supports the last agent optimization.
- Values for the parameter are:
- DESIRABLE
- MAYBE
- NO
- 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
- LOGNAME_BUFFER
- Optional Parameter
- An optional parameter specifying a buffer containing the logname of the remote system.
- NO_RESYNC_OUTCOME
- Optional Parameter
- A binary value indicating that the link will not provide a resolution to the distributed unit-of-work during resynchronization.
- Values for the parameter are:
- NO
- YES
- OTS_HOSTNAME_BUFFER
- Optional Parameter
- A buffer in which the TCP/IP host name is supplied.
- OTS_IORSTRING_BUFFER
- Optional Parameter
- A buffer containing the OTS IOR string.
- PRELOGGING
- Optional Parameter
- A parameter specifying whether the client requires to be called with the PERFORM_PRELOGGING callback function.
- Values for the parameter are:
- NO
- YES
- PRESUMPTION
- Optional Parameter
- A parameter specifying whether the remote system assumes the presume abort or presume nothing protocols.
- Values for the parameter are:
- ABORT
- NOTHING
- RECOVERY_STATUS
- Optional Parameter
- A parameter specifying whether recoverable work has taken place as part of the distributed unit of work on the remote system.
- Values for the parameter are:
- NECESSARY
- SYNC_LEVEL_1
- UNNECESSARY
- REMOTE_ACCESS_ID_BUFFER
- Optional Parameter
- A buffer containing the netname of the remote system, or the name of the External Resource Manager.
- SINGLE_UPDATER
- Optional Parameter
- A parameter specifying whether the remote system supports the single updater optimization.
- Values for the parameter are:
- NO
- YES
- 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.
- VOLATILE
- Optional Parameter
- A binary parameter indicating whether the link is volatile.
- Values for the parameter are:
- NO
- YES
Output Parameters
- REASON
- The values for the parameter are:
- CLIENT_UNKNOWN
- INVALID_SYNCPOINT_STATE
- UOW_UNKNOWN
- LINK_TOKEN
- A token that identifies the Recovery Manager Link object.
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.