RMLN gate, SET_LINK function

This function is used to set characteristics of a Recovery Manager Link object.

Input Parameters

LINK_TOKEN
A token identifying the Recovery Manager Link object.
ACCESSIBLE
Optional Parameter
A parameter specifying that the communications link to the remote system has failed.
Values for the parameter are:
  • NO
  • SHUNTED
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
FORGET
Optional Parameter
A parameter specifying whether all obligations to the remote system with respect to recovery have been discharged.
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
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.
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
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
RESOLVE_TO_CURRENT_LINK
Optional Parameter
Up to two Recovery Manager Link objects may be associated with a token. This optional parameter specifies whether to return information about the most recent or not.
Values for the parameter are:
  • NO
  • YES
RESYNC_SCHEDULED
Optional Parameter
A parameter specifying whether resynchronization activity has been scheduled.
Values for the parameter are:
  • NO
  • YES
SINGLE_UPDATER
Optional Parameter
A parameter specifying whether the remote system supports the single updater optimization.
Values for the parameter are:
  • NO
  • YES
UNSHUNTED
Optional Parameter
A parameter specifying whether the unit of work is not currently shunted.
Values for the parameter are:
  • NO
  • YES

Output Parameters

REASON
The values for the parameter are:
  • COORDINATOR_ALREADY
  • INITIATOR_ALREADY
  • INVALID_SYNCPOINT_STATE
  • LINK_UNKNOWN
RESPONSE
Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.


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