VLSshutDown

Syntax

LS_STATUS_CODE VLSshutDown (	 	 
char	 	*hostname ); 	 	 

Argument	Description
hostname	The host name of the computer running the License Manager.

Description 

Shuts down License Manager at specified hostname. 

A client can send this message to the License Manager in order to shut the License Manager down.

NOTE   Once shut down, there is no automatic way of restarting the License Manager through any client message. Any applications that may be running at that time could stop running after a while, as the license renewal messages will fail once the License Manager goes down. The License Manager does not check for running applications prior to shutting down.

The following permissions tests must succeed in order for this call to be successful:

>The client and License Manager must be running on the same network domain name.

>User identification of the License Manager process should match the client, or client must be run by superuser (root) as shown in the following table:

License Manager	Operating System	Windows (Admin)	UNIX (non-root)	UNIX (root)	Linux ARM (root)
Client	UNIX (non-root)	—	Same UserName or UserId	—	—
	Windows	Yes	Yes	Yes	Yes
	UNIX (root)	Yes	Yes	Yes	Yes

Returns 

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

Error Codes	Description
VLS_CALLING_ERROR	hostName parameter is NULL.
LS_NORESOURCES	An error occurred in attempting to allocate memory needed by function.
VLS_NO_SERVER_ RUNNING	License Manager on specified host is not available for processing the license operation requests.
VLS_NO_SERVER_ RESPONSE	Communication with License Manager has timed out.
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 for servicing the license operation.

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