VLSgetPoolServerList

Syntax

int VLSgetPoolServerList (	 	 
char	 	*outBuf,
int	 	outBufSz );

Argument	Description
outBuf	The output buffer.
outBufSz	The output buffer size.

Description

Returns a list of License Managers in the pool and their status—whether that server is active (running) or not. For example:

LEADER1~UP,LEADER2~UP,LEADER3~UP,

If a non-redundant License Manager is contacted, the VLS_NON_REDUNDANT_SRVR error code is returned.

You must set the License Manager’s name before calling VLSgetPoolServerList. The License Manager to be contacted is selected by VLSgetContactServer or the environment variable set.

Returns

The status code LS_SUCCESS is returned if successful. Otherwise, it will return the following error codes:

Error Code	Description
VLS_CALLING_ERROR	License Manager’s name is NULL or an empty string.
LS_BUFFER_TOO_SMALL	The output buffer is too small.
VLS_SERVER_SYNC_IN_PROGRESS	License Manager synchronization in process.
VLS_DIFF_LIB_VER	Version mismatch between License Manager API and client API.
LS_NORESOURCES	Insufficient resources (such as memory) as available to complete the request.
VLS_NON_REDUNDANT_SRVR	The License Manager is non-redundant, and therefore does not support this operation.
VLS_ LEADER_NOT_PRESENT	Unknown leader.

For a complete list of the error codes, see Licensing Library Error and Result Codes.