GetServer

(RPC Manager Library)

Description: Returns the name of the active server for a specified service.
Returns: Text
Usage: Steady State only.
Function Groups: Network
Related to: ConnectToMachine | DisconnectFromMachine | GetServersListed | GetStatus | IsClient | IsPotentialServer | IsPrimaryServer | Register (RPC Manager) | Send | SetRemoteValue | GetGUID
Format: \RPCManager.GetServer(ServiceName [, OptGUID])
Parameters:  
ServiceName
Required. Any text expression giving the name of the service for which to get the active server's name.
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 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 subroutine call must be prefaced by System\RPCManager\, and the System variable must be declared in AppRoot.src.
If the 16-byte binary format of the GUID is not known, the GetGUID function may be used to obtain it.

To obtain a list of service names for your application, open the Trace Viewer Application, connect to RPC Diagnostics, then open the Services Dialog

Example:

  SName = \RPCManager.GetServer("ModemManager");

RPC Manager Service