VLScgSetServerLockMechanism1

Syntax

int VLScgSetServerLockMechanism1 (VLScg_HANDLE iHandle, codeT *codeP, char *criterion, 	
				   int server);
Argument Description
iHandle

The instance handle for this library.

codeP

The pointer to the codeT struct.

criterion

The locking code criteria to install (in hex).

server

Position in array which is storing the primary locking criteria of the 11 License Managers. Value 0 to "(num_servers) -1" where num_servers is set using VLScgSetNumServers.

Description

Sets the criteria for the primary License Manager.

Installs a License Manager’s primary fingerprint criteria in the code structure. A fingerprint is computed by selecting operating characteristics of the host system and forming a mask with bits set corresponding to those characteristics. The different fingerprinting elements are defined in the VLScg_LOCK_ section of lscgen.h, and includes criteria such as ID Prom, IP address, disk ID, etc.

A License Manager can be locked to either of two groups of fingerprints. The second group is tried if the first fingerprint group fails to match the License Manager’s fingerprint at the end-user site.

Returns

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

Error Code Description

VLScg_INVALID_HEX_TYPE

If criterion is not in hexadecimal format.

VLScg_EXCEEDS_MAX_VALUE

If number of servers exceeds the maximum number of License Managers. The value set using the API VLScgSetNumServers.

VLScg_LESS_THAN_MIN_VALUE

If the number of servers is lower than minimum, which is 5.

VLScg_UNKNOWN_LOCK Specifies that the locking criteria is unknown.

For the complete list of the error codes, refer to License Generation and Revocation Error Codes .