IsPrimaryServer

(RPC Manager Library)

Description: Is Primary Server Active for a Service. This module returns an indication of whether or not the active server for a service is the primary server. Returns "1" if the local workstation is the current server for the specified service.

Returns: Integer

Usage: Steady State or Subroutine call.

Format: \RPCManager\IsPrimaryServer(ServiceName [, OptGUID])

Parameters: ServiceName { text } { required } { no default }

The name by which the service is known.

OptGUID { text } { optional } { default (see note) }

Any optional parameter that provides the GUID of the application in which the service instance is known. 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 AppMod.src.

The return value from this module is a logical value, if true (1) the primary server is the active server for the service, if false (0) a backup or no server is active is active.

If the 16-byte binary format of the GUID is not known, the GetGUID function may be used to obtain it.

Example:

If \RPCManager\IsPrimaryServer("EditLockoutManager") Main;

[

...

]