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.