(RPC Manager Library)
| Description: | Instructs RPC Manager that the local service instance does not consider itself a good server candidate, prompting it to evaluate an alternate candidate server for driver service. If one is found, the service will change over to the more viable driver. |
| Returns: | Nothing |
Usage:  |
Script Only. (Subroutine call only) |
| Function Groups: | Network |
| Related to: | |
| Format: |
\RPCManager\RecommendAlternate(Service [, OptGUID]); |
| Parameters: |
| Service |
| The name by which the service is known. |
| OptGUID |
| An optional parameter that is any expression giving the 16-byte binary form of the globally unique identifier (GUID) for the application in which the service instance is located. The default is the application to which the caller belongs. |
| Comments: |
This subroutine 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 subroutine call must be prefaced by System\RPCManager\, and the System variable must be declared in AppRoot.src. If all candidate servers for the service have called 'RecommendAlternate' and none have called 'RecommendPrimary', the RPCManager will clear the 'Alternate' flag of the highest priority server, forcing it to identify as the best candidate. |
