License Generation and Revocation Error Codes

The following table lists the Sentinel RMS license code generation return codes and their default messages:

NOTE   Error code starting from 80 up to 121 are also returned by the license revocation API included in the lsptgen library.

Error # Return Code Default Message

0

VLScg_SUCCESS

Success.

2

VLScg_NO_FEATURE_NAME

Feature Name must be specified. It cannot be empty.

3

VLScg_INVALID_INT_TYPE

Expected an integer value, found “XXX”.

4

VLScg_EXCEEDS_MAX_VALUE

The value entered is greater than the maximum supported value.

5

VLScg_LESS_THAN_MIN_VALUE

The value entered is less than the minimum supported value.

6

VLScg_EXCEEDS_MAX_STRLEN

The string length entered is greater than the maximum supported string length value.

7

VLScg_NOT_MULTIPLE

The value should be a multiple of “XXX”.

8

VLScg_INVALID_DEATH_YEAR

Expiration date cannot be less than “XXX”.

9

VLScg_INVALID_BIRTH_YEAR

The start year cannot be less than “XXX”.

10

VLScg_INVALID_DATE

Date is not valid.

11

VLScg_INVALID_HEX_TYPE

The wrong value entered. (Should be hexadecimal)

12

VLScg_INVALID_IP_TYPE

The wrong value entered. The IP address should be specified in dot form.

13

VLScg_INVALID_YEAR

Invalid year entered.

14

VLSucg_RESERV_STR_ERR

The string is a reserved string.

15

VLScg_INVALID_RANGE

The value violates the valid range of input.

16

VLScg_INVALID_CHARS

Invalid characters.

17

VLScg_SHORT_STRING

License string \”<value>\” too small to parse.

18

VLScg_PREMATURE_TERM

Premature termination of license code. Please check.

19

VLScg_REMAP_DEFAULT

Failed to remap default strings from a configuration file for license \”<value>\”.

20

VLScg_DECRYPT_FAIL

Decryption failed for license code.

21

VLScg_DYNAMIC_DECRYPT_FAILURE

Decryption failed for dynamically added license code.

22

VLScg_INVALID_CHKSUM

Error occurred either due to invalid lock code or checksum validation failure.

23

VLScg_FIXED_STR_ERROR

Default fixed string error.

24

VLScg_SECRET_DECRYPT_FAILURE

Decryption failed for secrets. Verify the configuration file for readable licenses.

25

VLScg_SIMPLE_ERROR

Error in license code. Please check.

26

VLScg_MALLOC_FAILURE

Out of heap memory.

27

VLScg_INTERNAL_ERROR

Internal error.

28

VLScg_UNKNOWN_LOCK

Unknown lock mechanism.

29

VLScg_VALUE_LARGE

Value: <value> too large

30

VLScg_INVALID_INPUT

Invalid input.

31

VLScg_MAX_LIMIT_ CROSSED

Maximum limit crossed.

32

VLScg_NO_RESOURCES

No resources left.

33

VLScg_BAD_HANDLE

Bad file handle.

34

VLScg_FAIL

Operation failed.

35

VLScg_INVALID_VENDOR_CODE

This error can occur in one of the following scenarios:

>Vendor identification is not valid. Get in touch with the Sentinel RMS SDK sales representative.

>The License Revocation Ticket (LRT)-based revocation method is no longer supported.

36

VLScg_VENDOR_ENCRYPTION_FAIL

Vendor-customized encryption failed.

37

VLScg_INVALID_EXP_DATE

License Expiration Date must be greater than Start Date.

38

VLScg_INVALID_EXP_YEAR

License Expiration Year must be greater than Start Year.

39

VLScg_INVALID_EXP_MONTH

License Expiration Month must be greater than Start Month.

40

VLScg_LICMETER_EXCEPTION

Unknown exception in accessing Sentinel RMS license meter(s).

41

VLScg_LICMETER_DECREMENT_OK

Your license meter(s) have been decremented by the <value> units. You now have the <value> units left out of an initial count of <value> units.

42

VLScg_LICMETER_ACCESS_ERROR

Error accessing license meter key. Make sure the Sentinel System Driver is properly installed and a license meter key is attached to the parallel port or USB port.

43

VLScg_LICMETER_COUNTER_TOOLOW

Too few units left in your Sentinel RMS license meter key to generate requested license. Units required.

44

VLScg_LICMETER_CORRUPT

Your license meter key is corrupted.

45

VLScg_LICMETER_VERSION_MISMATCH

Your license meter key has an invalid version.

46

VLScg_LICMETER_EMPTY

All <value> units of your license meter key have been used up. License generation will fail.

47

VLScg_PORTSERV_ EXCEPTION

Unknown exception in accessing the Computer ID (CID) keys.

48

VLScg_PORTSERV_ ACCESS_ERROR

Error in accessing the CID keys(s). Please make sure one is attached.

49

VLScg_PORTSERV_VERSION_MISMATCH

Your License Manager has an invalid version for commuter licenses.

50

VLScg_PORTSERV_CORRUPT

Your CID key is corrupted.

51

VLScg_EXPIRED_LICENSE

Your software license has expired.

52

VLScg_INVALID_LICTYPE

Invalid License Type.

53

VLScg_INVALID_TRIALDAYS

Invalid Trial Days.

54

VLScg_INVALID_TRIAL_COUNT

Invalid Trial License Count.

55

VLScg_TRIALMETER_EMPTY

All units of your trial license in the meter key have been used up.

56

VLScg_TRIAL_SUCCESS

Your trial license meter(s) have been decremented by <value> units. You now have <value> units left.

57

VLScg_NO_NETWORK_AUTHORIZATION

Your meter key is not authorized to generate network licenses.

58

VLScg_NO_ENABLE_FEATURE

No feature is enabled.

59

VLScg_VI18N_INITIALIZE_FAIL

Error in updating locale.

60

VLScg_INVALID_NUM_SERVERS

Invalid number of License Managers.

61

VLScg_NO_CAPACITY_AUTHORIZATION

Your license meter(s) have no authorization to generate capacity licenses.

70

VLScg_LICMETER_NOT_SUPPORTED

Your license meter is not supported.

71

VLScg_INCORRECT_BASE_FEATURE_VAL

The base feature is too high for supporting the desired number of multiple features.

72

VLScg_ENCRYPTION_FAIL

License code encryption failed.

73

VLScg_INVALID_CAPACITY_SETTINGS

Invalid capacity setting is done in code structure.

74

VLScg_EXP_DATE_BEFORE_START_DATE

The license expiration date is set before the license start date.

75 VLScg_INVALID_TRIALHOURS Invalid trial elapsed hours.
77 VLScg_GETLOCK_FAIL Process lock request failed.
78 VLScg_GETLOCK_TIMEOUT Process lock request timeout.
79 VLScg_VENDOR_DECRYPTION_FAIL Vendor decryption failed.
80 VLScg_RT_VERSION_MISMATCH Version value found in the revocation ticket does not match with that specified in request structure.
81 VLScg_RT_REHOST_LINE_CORRUPT One or more operation-specific information in the revocation ticket is invalid.
82 VLScg_RT_TRANSACTION_ID_MISMATCH The transaction ID value found in the revocation ticket does not match with that specified in request structure.
83 VLScg_RT_LOCK_CODE_MISMATCH The locking code value found in the revocation ticket does not match with that specified in the request structure.
84 VLScg_RT_REQUESTED_ACTION_NOT_PERFORMED One or more operation(s) specified in the request structure is/are not performed at the client-side as corresponding information is not found in a revocation ticket.
85 VLScg_RT_NON_REQUESTED_ACTION_PERFORMED The request structure does not specify one or more operation(s) corresponding to which information is found in a revocation ticket.
86 VLScg_RT_ACTION_STATUS_NOT_SUCCESS The requested operation is not successfully performed at the client-end.
87 VLScg_RT_REQUEST_EMPTY The request structure does not specify any operation.
88 VLScg_RT_REQUEST_LINE_INVALID The request structure specified an invalid operation.
89 VLScg_RT_REHOST_TICKET_INVALID_TLV_STRUCT The revocation ticket is invalid.
90 VLScg_RT_REHOST_TAG_MISSING The rehost tag is not found in the revocation ticket.
91 VLScg_RT_VERSION_TAG_MISSING The version tag is not found in the revocation ticket.
92 VLScg_RT_TRANSACTION_ID_TAG_MISSING The transaction ID tag is not found in the revocation ticket.
93 VLScg_RT_LOCK_SELECTOR_TAG_MISSING The locking code criteria tag is not found in the revocation ticket.
94 VLScg_RT_LOCK_SELECTOR_MISMATCH The lock selector value found in the revocation ticket does not match with that specified in the request structure.
95 VLScg_RT_LOCK_CODE_TAG_MISSING The locking code tag is not found in the revocation ticket.
96 VLScg_RT_REHOST_LINE_TAG_MISSING The rehost line tag is not found in the revocation ticket.
97 VLScg_RT_HASH_TAG_MISSING The hashtag is not found in the revocation ticket.
98 VLScg_RT_TIME_STAMP_MISMATCH The timestamp value found in the revocation ticket does not match with that specified in the request structure.
99 VLScg_RT_TIME_STAMP_TAG_MISSING The timestamp tag is not found in the revocation ticket.
100 VLScg_RT_VERIFY_SINGLE_ERROR The revocation ticket reported a single error.
101 VLScg_RT_VERIFY_MULTIPLE_ERRORS The revocation ticket reported multiple errors.
102 VLScg_RT_BUFFER_TOO_SMALL The buffer is too small.
103 VLScg_RT_PARAMETERS_ERROR A parameter-related error is encountered.
104 VLScg_RT_ALLOCATE_MEMORY_FAILURE A memory allocation failure.
105 VLScg_RT_UNSUPPORTED_OPERATION_TYPE The operation type is not supported.
106 VLScg_RT_INVALID_REQUEST_DATA An invalid rehost request data.
107 VLScg_RT_TAG_NOT_FOUND The tag cannot be found in TLV.
108 VLScg_BUFFER_TOO_SMALL The buffer is too small.
109 VLScg_RT_INSUFFICIENT_TOKENS_TO_REVOKE The license tokens available for revocation are less than the number specified in the permission ticket.
110 VLScg_RT_MIXED_OPERATION_TYPE_UNSUPPORTED You cannot revoke standalone and network licenses using a single permission ticket.
111 VLScg_RT_INFINITE_LIC_FINITE_REQ Network licenses with infinite tokens cannot be partially revoked. Full revocation is required.
112 VLScg_RT_RDNT_LIC_UNSUPPORED The permission ticket cannot be generated for redundant licenses.
113 VLScg_RT_CORRUPT_ORIG_REQ The permission ticket provided for verification is corrupt.
114 VLScg_RT_CUSTOM_DATA_TAG_MISSING The custom defined data tag is not found in the revocation ticket.
115 VLScg_RT_CUSTOM_DATA_MISMATCH The custom defined data included in the permission ticket and revocation ticket does not match.
116 VLScg_RT_REVOCATION_TYPE_MISMATCH Either standalone revoke request is provided to verify with a network revocation ticket or vice versa.
117 VLScg_TOO_MANY_OPERATIONS_FOR_SINGLE_PT

The number of operations specified in the permission ticket exceeds the maximum limit.

This error can occur in one of the following scenarios:

> For standalone licenses, the length of the permission ticket exceeds 65535 bytes.

> For network licenses, a permission ticket contains over 15 operations.

118 VLScg_VENDOR_ID_MISMATCH Vendor ID mismatch. The permission ticket cannot be generated for licenses of other vendors.
119 VLScg_CODGEN_VERSION_UNSUPPORTED The permission ticket generation not supported for licenses earlier than version 11.
120 VLScg_DEFERRED_REVOKE_DAYS_INVALID The deferred revoke days can be a value between 1-30 days.
121 VLScg_OLD_PT_GENERATION_UNSUPPORTED Older structures introduced before v8.5.3 (VPT_REQUEST and VPT_REQUEST_EXT) cannot be passed to generate a permission ticket using the new API VLSgeneratePermissionTicketExt2.
122 VLScg_INVALID_LICENSE The license string is invalid. Hence, it cannot be used for PT generation.
123 VLScg_PT_VERSION_UNSUPPORTED The API for verification of revoked licenses does not support older permission tickets that are not generated using the VLSgeneratePermissionTicketExt2 API.
124 VLScg_MISSING_RTS The number of valid revocation tickets passed in the API is lesser than the number of locking codes in the permission ticket.
125 VLScg_INVALID_VENDOR_INFO Invalid vendor information in the license generator binary.
130 VLScg_RESERV_CHAR_ERR The reserved characters are used. Refer to Reserved Characters and Strings.
131 VLScg_LOWER_THAN_MIN_STRLEN The string length is lower than the minimum allowed.