VLSsetServerLogState

Syntax

int VLSsetServerLogState (	 	 
int	 	event,
int	 	state );

Argument	Description
event	The event you want to log. Event may be: >LOG_SRVR_UP (the License Manager is running) >LOG_LDR_ELECT (a pool leader has been elected) >LOG_HRT_BT (License Manager heartbeat) >LOG_BORROW_REQ_RESP (token borrowing request and response) >LOG_USG_NOTIFY (follower notifies pool leader of token use) >LOG_CHNG_DIST_CRT (token distribution criteria has changed) >LOG_DIST_CRT_SYNC (the pool servers are synchronizing distribution criteria) >LOG_CFG_FILE (the LSERVRLF file changed) >LOG_SRVR_DOWN (License Manager is down) >LOG_MOD_SERVER (addition or deletion of a License Manager to or from the pool) >LOG_ADD_DEL_LIC (redundant license has been added or deleted to or from the pool)
state	Logging state: VLS_ON or VLS_OFF.

Argument

Description

event

The event you want to log. Event may be:

>LOG_SRVR_UP (the License Manager is running)

>LOG_LDR_ELECT (a pool leader has been elected)

>LOG_HRT_BT (License Manager heartbeat)

>LOG_BORROW_REQ_RESP (token borrowing request and response)

>LOG_USG_NOTIFY (follower notifies pool leader of token use)

>LOG_CHNG_DIST_CRT (token distribution criteria has changed)

>LOG_DIST_CRT_SYNC (the pool servers are synchronizing distribution criteria)

>LOG_CFG_FILE (the LSERVRLF file changed)

>LOG_SRVR_DOWN (License Manager is down)

>LOG_MOD_SERVER (addition or deletion of a License Manager to or from the pool)

>LOG_ADD_DEL_LIC (redundant license has been added or deleted to or from the pool)

state

Logging state: VLS_ON or VLS_OFF.

Description

Turns logging on or off for the given event. The License Manager to be contacted is selected by VLSgetContactServer, so you must set the License Manager’s name before calling VLSsetServerLogState.

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.
VLS_DIFF_LIB_VER	Version mismatch between License Manager API and client API.
VLS_FEATURE_INACTIVE	The given feature is inactive on the specified License Manager.
VLS_MSG_TO_LEADER	The request has been sent to the leader License Manager.
VLS_NOT_AUTHORIZED	The user making the request is invalid.
VLS_BAD_SERVER_ MESSAGE	A message returned from the License Manager could not be understood.

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