VLSgetLicSharingServerList

Syntax

int VLSgetLicSharingServerList (	 	 
unsigned char	 	*feature_name,
unsigned char 	 	*feature_version,
int	 	server_list_len,
char	 	*server_list,
int	 	*num_servers );

Argument	Description
feature_name	Name of the feature.
feature_version	Version of the feature.
server_list	A list containing the names of License Managers (hostNames or IP addresses). >The format for an individual server is: [server hostname/IP address]~[A/I/U]. >Each server name is separated by a single space. >The feature node state on the server can take one of the following values: •A (Active) •I (Inactive) •U (Unknown)
server_list_len	License Manager will retrieve all the License Managers names. If the list is larger than the specified limit, it will be truncated.
num_servers	Identifies the number of License Managers.

Description

Returns the names of License Managers that are sharing tokens for a given feature name and version. The server_name_list contains License Manager names (hostNames or IP addresses).

Returns

This API returns the list of servers in the pool along with the state of the feature node on each server.

Important

>When the API is successful, status code LS_SUCCESS is returned.

>When the API is not successful, one of the following error codes is returned.

Error Code	Description
VLS_CALLING_ERROR	>feature_name is NULL >feature_version is NULL >server_list is NULL >server_list_len is zero. >License Manager’s name is NULL or an empty string. >Both feature name and version cannot be NULL at the same time.
LS_BUFFER_TOO_SMALL	server_list_len is smaller than License Manager name that will be returned.
VLS_NO_SUCH_FEATURE	License Manager does not have a license that matches the requested feature, version and capacity.
VLS_FEATURE_INACTIVE	Feature is inactive on specified License Manager.
VLS_SERVER_SYNC_IN_ PROGRESS	License Manager synchronization in process.
VLS_NON_REDUNDANT_ FEATURE	Feature is non-redundant and thus cannot be used in this redundancy-related operation.
VLS_DIFF_LIB_VER	Version mismatch between License Manager API and client API.
VLS_NO_SERVER_RUNNING	License Manager on specified host is not available for processing the license operation requests.
VLS_HOST_UNKNOWN	Invalid hostName is specified.
VLS_BAD_SERVER_MESSAGE	Message returned by the License Manager could not be understood.
LS_NO_NETWORK	Generic error indicating that the network is unavailable in servicing license operation.
LS_UNRESOLVED_HOSTNAME	Host name given is not correct.
LS_BAD_PARAMETER	License Manager’s name is NULL or an empty string.
VLS_NON_REDUNDANT_SRVR	The License Manager is non-redundant, and therefore does not support this operation.

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