licenseInfo—License Information Supported in On-premises modeSupported in Lease modeSupported in Connected (Cloud LM) mode

NOTE   Since v9.2.0, the macro for obtaining License Information is SNTL_QUERY_LICENSE_INFO_VERSION(v). Here, v represents the query version. Specify version under the double quotes, such as "1.0". The earlier macro SNTL_QUERY_LICENSE_INFO is deprecated hereafter.

NOTE   From RMS v9.5, query version 1.1 has been introduced to support license hard limit up to 4,294,967,294. This is applicable to license version 20 and above.

Query

<?xml version="1.0" encoding="UTF-8"?>
<sentinelQuery query="licenseInfo" version="1.1"/>

Scope

<?xml version="1.0" encoding="UTF-8"?>
<sentinelScope>
	<feature index="0">
		<name>F1</name>
		<version>V1</version>
	</feature>
	<license index="0">
		<hash/>
	</license>
</sentinelScope>
Element Description

feature index

Used to specify a particular feature-version combination.

name

The feature name identifier for the license code.

version

Version of the feature.

license index Used to specify index of a particular license for a specific feature-version combination.
hash The license hash identifier for a specific license code.

Description

Retrieves information of all the licenses, of a specific feature name-version combination, loaded in the memory.

To fetch the license information, it is mandatory to pass both the feature parameters and license parameters under scope xml.

Feature Parameters:

>Both the feature name and feature version are mandatory if feature name and feature version are included in the license. If only feature name is included, then only feature name is necessary.

>If feature version is included in the license, then specify it along with feature name under scope to obtain feature information. Otherwise, it can be skipped.

>Feature index alone is sufficient to obtain a feature's information. Otherwise, you can specify feature name and/or feature version under scope xml.

>When all the three elements (feature index, feature name, and feature version) are passed, feature index is ignored.

License Parameters:

Specify either the license index or license hash.

Obtaining a List of Licenses

>The license index argument should be used in a loop to get information of the licenses of a specific feature-version combination. So as long as the license index is valid, the API will return the SNTL_SUCCESS status code. Otherwise, it will return the SNTL_NO_MORE_LICENSES status code.

>You can also loop through the features in the license table. Either a feature name-version combination or feature index can be used to reach a particular feature available.

>Using a combination of feature index and license index, you can loop through the features and for each feature all the licenses added.

Output

<?xml version="1.0" encoding="UTF-8"?>
<sentinelInfo>
	<feature>
		<featureName>F1</featureName>
		<featureVersion>V1</featureVersion>
		<licType>0</licType>
		<trialDaysCount>0</trialDaysCount>
		<numLicenses>5</numLicenses>
		<isNodeLocked>2</isNodeLocked>
		<sharingCrit>0</sharingCrit>
		<lockingCrit>0</lockingCrit>
		<holdingCrit>0</holdingCrit>
		<numSubnets>0</numSubnets>
		<siteLicenseInfo>*.*.*.*</siteLicenseInfo>
		<holdTime>0</holdTime>
		<vendorInfo>string</vendorInfo>
		<clLockInfo>string</clLockInfo>
		<keyLifeTime>300</keyLifeTime>
		<sharingLimit>0</sharingLimit>
		<softNumLicenses>2097150</softNumLicenses>
		<isStandalone>0</isStandalone>
		<checkTimeTamper>0</checkTimeTamper>
		<isAdditive>1</isAdditive>
		<numServers>1</numServers>
		<isRedundant>0</isRedundant>
		<majorityRule>0</majorityRule>
		<logEncryptLevel>1</logEncryptLevel>
		<serverLockingInfo>$$$0$$$</serverLockingInfo>
		<isCommuter>0</isCommuter>
		<commuterMaxCheckoutDays>0</commuterMaxCheckoutDays>
		<commutedFromServer>string</commutedFromServer>
		<gracePeriodFlag>0</gracePeriodFlag>
		<gracePeriodCalendarDays>0</gracePeriodCalendarDays>
		<gracePeriodElapsedHours>0</gracePeriodElapsedHours>
		<localRequestLockCritFlag>0</localRequestLockCritFlag>
		<localRequestLockCritRequired>4</localRequestLockCritRequired>
		<localRequestLockCritFloat>0</localRequestLockCritFloat>
		<localRequestLockCritMinNum>1</localRequestLockCritMinNum>
		<licenseVersion>155254784</licenseVersion>
		<plainVendorInfo>string</plainVendorInfo>
		<trialElapsedHours>0</trialElapsedHours>
		<trialExecutionCount>0</trialExecutionCount>
		<trialCalendarPeriodLeft>0</trialCalendarPeriodLeft>
		<trialElapsedPeriodLeft>0</trialElapsedPeriodLeft>
		<trialExecutionsLeft>0</trialExecutionsLeft>
		<trialCurrentStatus>0</trialCurrentStatus>
		<licenseHash>D3C802D6979EA395</licenseHash>
		<licenseStorage>C:\Users\sfntapac\Desktop\9_1_build86_server\WinNT\lservrc</licenseStorage>
		<licenseState>1</licenseState>
		<licensePrecedence>0</licensePrecedence>
		<vmDetection>0</vmDetection>
		<deferredRevocationTime>0</deferredRevocationTime>
		<birthTime>1451644800</birthTime>
		<deathTime>1483210800</deathTime>
		<eid>string</eid>
		<pid>0</pid>
		<fid>0</fid>
		<aid>string</aid>
		<cloudUsageFlag>0</cloudUsageFlag>
		<licSource>0</licSource>
		<trialDays>0</trialDays>
		<trialSeconds>0</trialSeconds>
		<trialDaysLeft>0</trialDaysLeft>
		<trialSecondsLeft>0</trialSecondsLeft>
		<activationBirthTime>0</activationBirthTime>
		<activationExpiryTime>0</activationExpiryTime>
		<licenseVendorInfo>licenseInfo</licenseVendorInfo>
		<userAccountLimit>0</userAccountLimit>
	</feature>
</sentinelInfo>
Element Description
Feature Information
featureName The name of the feature.
featureVersion The version of the feature.
License Type Information
licType

Contains any of the following information regarding the license type:

0 - Normal

1 - Trial

isStandalone

Contains any of the following information regarding the license type:

0 - Network license

1- Standalone license

2 - Repository license

isAdditive

Contains any of the following information regarding the license type:

0 - Additive license

1 - Exclusive license

2 - Aggregate license

3 - Cloud LM license

Number of Licenses Information
numLicenses Total hard limit for this feature. From RMS 9.5 onwards, query v1.1 supports license hard limit up to 4,294,967,294. This is applicable to license version 20 (or above).
softNumLicenses Total soft limit (for alerts) on the number of concurrent users of this feature. From RMS 9.5 onwards, query v1.1 supports soft limit up to 4,294,967,294. This is applicable to license version 20 (or above).
userAccountLimit

Applicable to SCL Add-on for RMS only for Connected (Cloud LM) mode with version 23 and later licenses. Stores the maximum number of named users that can consume this license.

License Lifetime Information
keyLifeTime Total license lifetime (in seconds) for this feature .
License Locking Information
isNodeLocked

Contains any of the following information regarding the locking scheme of the feature:

0 - Client-server-locked

1 - Server-locked

2 - Unlocked

3 - Client locked

lockingCrit

Contains any of the following information regarding the locking criteria applicable to the license:

0 - No locking

1 - SNTL_LOCK_ID_PROM

2 - SNTL_LOCK_IP_ADDR

4 - SNTL_LOCK_DISK_ID

8 - SNTL_LOCK_HOSTNAME

16 - SNTL_LOCK_ETHERNET

128 - SNTL_LOCK_PORTABLE_SERV

256 - SNTL_LOCK_CUSTOM

1024 - SNTL_LOCK_CUSTOMEX

2048 - SNTL_LOCK_HARD_DISK_SERIAL

4096 - SNTL_LOCK_CPU_INFO

8192 - SNTL_LOCK_UUID

Or and ORed value representing any of the criteria combinations

clLockInfo Locking information of clients in a space-separated string of host IDs and/or IP addresses. If licenses-per-node restrictions have been specified, they are also returned in parentheses with each host ID/IP address. For instance, clLockInfo could be: 0x8ef38b91(20#) 0xa4c7188d 0x51f8c94a(10#).
serverLockingInfo Stores the License Manager locking information.
License Sharing Information
sharingCrit

Contains the license sharing criteria, which can be one of the following values:

0 - No sharing

1 - License sharing on the basis of a common user name.

2 - License sharing on the basis of the system where the licensed feature is being run.

3 - License sharing on the basis of the X-display ID of a UNIX system.

4 - License sharing on the basis of a custom license sharing mechanism you implemented, which is set using the SNTL_ATTR_APPCONTEXT_VENDOR_DEFINED_SHARINGID application context attribute.

sharingLimit The limit on how many copies of the licensed application can share the same license.
License Holding Information
holdingCrit

Contains the license holding criteria, which can be one of the following values:

0 - No held licenses.

1 - The client application specifies the hold time.

2 - The license code specifies the hold time.

holdTime The hold time specified for licenses issued for this feature.
Site Information
numSubnets The number of subnets provided for the site.
siteLicenseInfo A space-separated list of subnet wildcard specifications.
Time Tampering Information
checkTimeTamper

Contains the clock tampering detection policy which can be one of the following values:

0 - Detection of time tampering is allowed

1 - Time tampering is not detected

License Manager Redundancy Information
isRedundant

Contains any of the following values about the License Manager redundancy setting:

0 - License is non-redundant

1 - License is redundant

majorityRule

Contains any of the following values about the applicability of the majority rule (on or off):

0 - No majority

1 - Majority

numServers

The number of redundant License Managers forming the pool.

Commuter Information
isCommuter

Whether license commute action is allowed or not. Contains any of the following value:

0 - Commute action is not allowed.

1 - Commute action is allowed.

commuterMaxCheckoutDays The maximum number of days a commuter license can be checked out for.
commutedFromServer

The License Manager from which the commuted license is obtained.

To obtain information about the commuter license installed on the local system, set no-net as the contact server.

commutedKeys The number of commuter keys that have been checked out. From RMS 9.5 onwards, query v1.1 supports license hard limit up to 4,294,967,294. This is applicable to license version 20 (or above).
commuterKeysLeft The number of commuter keys left. From RMS 9.5 onwards, query v1.1 supports license hard limit up to 4,294,967,294. This is applicable to license version 20 (or above).
Usage Log Information
logEncryptLevel

Contains any of the following values about the encryption level in the network license for the License Manager’s usage log file:

0 - The system administrator is allowed to set the encryption level.

1 - Transaction data will be logged for this license code with no encryption.

2 - Transaction data will be readable by the customer, but tampering with or deleting an entry can be detected.

3 - Transaction data will be readable by the customer except for license usage data (which will be encrypted), but tampering with or deleting an entry can be detected.

4 - All transaction data for the license code will be encrypted. Tampering with or deleting an entry will not be prevented, but can be detected.

License Queuing Information
avgQueueTime Average time the past or present clients are in the queue. (Not implemented.)
queueLength Length of the queue.
totLicReqd Required number of licenses for all queued clients.
Local License Locking-Related Information*
localRequestLockCritFlag

Contains the flag value that defines whether the local license request locking criteria is used or not for the commuter, repository, and grace license:

0 - Local license request criteria is not used

1 - Local license request criteria is used

localRequestLockCritRequired The ORed decimal value of necessary criteria that must be met for making the licenses available to a local client.
localRequestLockCritFloat The ORed decimal value of desired criteria that must be met for making the licenses available to a local client.
localRequestLockCritMinNum The minimum number of locking license criteria that must be met for making the licenses available to a local client.
Grace Information  
gracePeriodFlag

Contains the flag value that defines whether grace period for a license is available or not:

0 - Grace period is not allowed

1 - Standard grace period is provided

gracePeriodCalendarDays The number of days the grace period will last for.
gracePeriodElapsedHours The number of hours the grace period will last for.
Vendor Info
vendorInfo The vendor-defined information string.
plainVendorInfo The public vendor information included in the license.
licenseVendorInfo The license vendor information included in the license (applicable to version 19 licenses and above).
License Version Information
licenseVersion

Contains the Sentinel RMS license version. The possible values are:

>4294967295 - License version not defined

>0 - License version earlier than 7.0

>117440512 - RMS SDK v7.0 license - License v7

>117637120 - RMS SDK v7.3.0 license - License v8

>117637121 - RMS SDK v7.3.0.1 license - License v9

>134217728 - RMS SDK v8.0.0 license - License v10

>135266304 - RMS SDK v8.1.0 license - License v11

>136511488 - RMS SDK v8.2.3 license - License v12

>138412032 - RMS SDK v8.4.0 license - License v13

>139460608 - RMS SDK v8.5.0 license - License v14

>140509184 - RMS SDK v8.6.0 license - License v15

>150994944 - RMS SDK v9.0.0 license - License v16

>152043520 - RMS SDK v9.1.0 license - License v17

>153092096 - RMS SDK v9.2.0 license - License v18

>155254784 - RMS SDK v9.4.1 license - License v19

>156237824 - RMS SDK v9.5.0 license - License v20

> 158334976 - RMS SDK v9.7.0 license - License v21

> 268435456 - RMS SDK v10.0.0 license - License v22

>270532608 - RMS SDK v10.2.0 license - License v23

License Validity Information
birthTime

>For On-premises mode, this is the license start date in time_t.

>For Lease mode, this represents the start time of the lease period (and not of the license).

deathTime

>For On-premises mode, this is the license expiration date in time_t.

>For Lease mode, this represents the expiration time of the lease period (and not of the license).

activationBirthTime

activationBirthTime and activationExpiryTime denote the duration of the complete license. These do not denote the lease time period (lease time period is denoted by attributes birthTime and deathTime).

For example, activationBirthTime (2021-06-16T11:13:00Z) and activationExpiryTime (2022-06-15T11:13:00Z) denote the license duration of one year. The lease period duration—denoted by the birthTime (2021-06-17T07:52:00Z) and deathTime (2021-09-15T08:07:00Z values—is three months.

The activationBirthTime and activationExpiryTime attributes are filled only for lease licenses. These attributes are applicable for v17 and above licenses. Currently, for on-premise modes, licenses generated using Sentinel EMS, activationBirthTime and activationExpiryTime values are not filled.

activationExpiryTime
Trial License-Related Information
trialDays The number of trial days set. Valid only if trial days is enforced.
trialSeconds The number of trial hours set, converted into seconds. Valid only if trial hours is enforced.
trialDaysLeft The remaining number of trial days. Valid only if trial days is enforced.
trialSecondsLeft The remaining number of trial hours (in seconds). Valid only if trial hours is enforced.
trialCurrentStatus

Contains any of the following values about the status of the trial license at the given time:

>0 - The license has never been requested and therefore the trial period has not yet begun.

>1 - License is requested at least once, but some trial usage is still left.

>2 - Usage limit of trial license is exhausted.

trialDaysCount

Obsolete. Instead see "trialDays."

trialElapsedHours Obsolete. Instead see "trialSeconds."
trialCalendarPeriodLeft Obsolete. Instead see "trialDaysLeft."
trialElapsedPeriodLeft Obsolete. Instead see "trialSecondsLeft."
trialExecutionCount The number of executions count set. However, this is not supported as of now.
trialExecutionsLeft The remaining number of executions. However, this is not supported as of now.
Other License Related Information
licenseHash The license hash identifier for the license code.
licenseStorage The file location where the license is stored.
licenseState Indicates whether this license is a part of the license table node or not.
licensePrecedence Indicates the priority of a particular trial license amongst the set of licenses having same feature-version combination.
VM-Related Information
vmDetection

Contains any of the following values about the VM detection policy:

0 - license requests are allowed.

1- license requests are not allowed.

Sentinel EMS-Related Information
eid Entitlement ID (EID) used to identify entitlements.
fid Feature ID. This field is applicable to the Lease mode.

pid

Reserved for future use.
aid

Authorization ID. It is a unique identifier auto-generated for each licensed feature in an entitlement. It is used for tracking the usage associated with a feature-entitlement combination.

This field is applicable to v16 (and later) Sentinel RMS licenses activated using Sentinel EMS.

NOTE    This field is not the same as the Activation ID of Sentinel EMS. The field may be renamed in the upcoming releases.

cloudUsageFlag

This field is applicable for all deployment modes. It decides whether the Cloud-based usage data is being generated or not. The possible values are:

>0 - The Cloud-based usage data is not generated.

>1 - The Cloud-based usage data is being generated.

licSource

This field decides whether the license is applicable for the Lease mode or not.

> 1 - License is supported for the Lease mode.

>0 - License is not supported for the Lease mode.

License Revocation Information
deferredRevocationTime Any value other than zero denotes that the license has deferred revocation period associated. The value will be the time in seconds (since EPOCH) after which revocation will take place.

NOTE   To obtain information about the commuter license installed on the local system, set
no-net as the contact server.