VLScgSetSoftLimit

Syntax

int VLScgSetSoftLimit (VLScg_HANDLE iHandle, codeT *codeP, char *info);
Argument Description

iHandle

The instance handle for this library.

codeP

A pointer to the codeT struct.

info

Sets soft limit. Should be from 0 to VLScg_NOLIMIT_STRING for no limit. VLScg_NOLIMIT_STRING is not allowed if the license is a commuter license.

NOTE   From RMS v9.5, the maximum value for VLScg_NOLIMIT_STRING can be 4,294,967,294. This is applicable for license version 20 and above.

Description

The soft limit number defines a threshold at which a warning can be issued that the maximum number of licenses is being approached. Must be less than the maximum number of users (the hard limit).

Returns

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

Error Code Description

VLScg_INVALID_INT_TYPE

If the value of info is not numeric.

VLScg_EXCEEDS_MAX_VALUE

If the value exceeds maximum number of license tokens allowed. Maximum value for long codes is 32766 and maximum value for short codes is 254.

VLScg_LESS_THAN_MIN_VALUE

If the value is less than 0.

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