(RPC Manager Library)
| Description: | Informs RPC Manager that the synchronization state of a service has been sampled during synchronization, and service RPCs for the specified client should be buffered until synchronization completes. Subroutine call only. |
| Returns: | Nothing |
Usage:  |
Script Only. |
| Function Groups: | Network |
| Related to: | GetClientDiverts |
| Format: |
\RPCManager\SetDivert(Service, IP [, OptGUID]); |
| Parameters: |
| Service |
| Required. The name by which the service is known. |
| MachineName |
| Required. A machine name or IP by which the synchronizing client is known. |
| OptGUID |
| An optional GUID of the application in which the service instance is located. The default is the application to which the caller belongs. |
| Comments: |
This module is a member of the RPC Manager's Library, and must therefore be prefaced by \RPCManager, as shown in the "Format" section. If the application you are developing is a script application, the module call must be prefaced by System\RPCManager, and the System variable must be declared in AppRoot.src. This subroutine is only called by the service instance that is server during synchronization. It initiates service RPC caching on an auxiliary queue for the service. A service calls this after acquisition of the synchronizable state of a service to ensure that all service RPCs after the state has been sampled are preserved. This also turns off server RPC diversion, allowing server RPCs to flow. |
