RMLN gate, GET_NEXT_LINK function

This function returns information about the next Recovery Manager Link object in a browse.

Input Parameters

LINK_BROWSE_TOKEN
Optional Parameter
A token identifying a browse of all the Recovery Manager Link objects belonging to a particular Recovery Manager client.
LINK_ID_BUFFER
Optional Parameter
A buffer containing the termid of the session to the remote system, or the External Resource Manager qualifier.
LOGNAME_BUFFER
Optional Parameter
An optional parameter specifying a buffer containing the logname of the remote system.
OTS_HOSTNAME_BUFFER
Optional Parameter
A buffer in which the TCP/IP host name is returned.
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_BROWSE_TOKEN
Optional Parameter
A token identifying a browse of all the Recovery Manager Link objects belonging to a particular unit of work object.

Output Parameters

REASON
The values for the parameter are:
  • END_BROWSE
  • INVALID_BROWSE
  • UOW_UNKNOWN
RESPONSE
Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
ACCESSIBLE
Optional Parameter
Whether the communications link to the remote system is active or not.
Values for the parameter are:
  • NO
  • SHUNTED
  • YES
CLIENT_NAME
Optional Parameter
The name of the Recovery Manager client that owns the resource that has caused the unit of work to shunt.
COORDINATOR
Optional Parameter
Whether the remote system is the coordinator of the distributed unit of work.
Values for the parameter are:
  • NO
  • YES
FORGET
Optional Parameter
Whether all obligations to the remote system with respect to recovery have been discharged.
Values for the parameter are:
  • NO
  • YES
HEURISM
Optional Parameter
Whether the unit of work should take a unilateral decision if a failure occurs in the in doubt window.
Values for the parameter are:
  • NO
  • YES
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
LAST
Optional Parameter
Whether the remote system supports the last agent optimization.
Values for the parameter are:
  • MAYBE
  • NO
  • YES
LINK_ID_SOURCE
Optional Parameter
Whether the local or remote system allocated the session.
Values for the parameter are:
  • LOCAL
  • REMOTE
LINK_TOKEN
Optional Parameter
A token identifying the new Recovery Manager Link object.
LOCAL_UOW_ID
Optional Parameter
An optional parameter to receive the local UOWID.
LOGICAL_SERVER
Optional Parameter
The logical server associated with the link.
MARK
Optional Parameter
Whether the Recovery Manager Link object has been marked during resynchronization.
Values for the parameter are:
  • NO
  • YES
PRESUMPTION
Optional Parameter
Whether the remote system assumes the presume abort or presume nothing protocols.
Values for the parameter are:
  • ABORT
  • NOTHING
PUBLIC_ID
Optional Parameter
The public identifier of the RequestStream associated with the link.
RECOVERY_STATUS
Optional Parameter
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
RESYNC_SCHEDULED
Optional Parameter
Whether resynchronization activity has been scheduled.
Values for the parameter are:
  • NO
  • YES
RMC_TOKEN
Optional Parameter
A token to be passed to the client on all callback functions.
SINGLE_UPDATER
Optional Parameter
Whether the remote system supports the single updater optimization.
Values for the parameter are:
  • NO
  • YES
UNSHUNTED
Optional Parameter
Whether the unit of work is not currently shunted.
Values for the parameter are:
  • NO
  • YES
UOW_TOKEN
Optional Parameter
A token identifying the unit of work object.


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