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.


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