clientInfo—Client Information Supported in On-premises modeSupported in Lease modeSupported in Connected (Cloud LM) mode

NOTE   Since v9.2.0, the macro for obtaining Client Information is SNTL_QUERY_CLIENT_INFO_VERSION(v). Here, v represents the query version. Specify version under the double quotes, such as "1.0". The earlier macro SNTL_QUERY_CLIENT_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="clientInfo" version="1.1"/>

Scope

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

name

(Mandatory) Name of the feature. An IN parameter.

version

Version of the feature. An IN parameter.

client index

(Mandatory) Used to specify a particular client. An IN parameter.

Output

<?xml version="1.0" encoding="UTF-8"?>
<sentinelInfo>
	<client>
		<userName>sfntapac</userName>
		<hostId>2147483647</hostId>
		<group>DefaultGrp</group>
		<holdTime>0</holdTime>
		<keyId>2</keyId>
		<hostName>NOI1-502223</hostName>
		<xDisplayName>local</xDisplayName>
		<sharedIdName>default-sharing-ID</sharedIdName>
		<vendorDefinedSharingId>default-sharing-ID</vendorDefinedSharingId>
		<numUnits>1</numUnits>
		<isHolding>1</isHolding>
		<isSharing>0</isSharing>
		<sharedClientCount>0</sharedClientCount>
		<isCommuted>0</isCommuted>
		<totalTeamTokensResv>0</totalTeamTokensResv>
		<reservedTeamTokensInUse>0</reservedTeamTokensInUse>
		<unreservedTeamTokensInUse>0</unreservedTeamTokensInUse>
		<startTime>1469598309</startTime>
		<endTime>1469598609</endTime>
		<clientVendorUsageData/>
		<vendorUsageData/>
	</client>
</sentinelInfo> 
Element Description
Client Information
userName The login name of the user using the application. In case of standalone licensing, the “default-sharing-ID” string will be returned.
hostId The host ID of the computer on which the user is working.
keyId The internal ID of the license currently issued to the user’s application. After starting up, the License Manager issues licenses with unique IDs until it is restarted.
numUnits

The total number of units consumed by the current client being queried. Starting from v9.5, license version 20 or above, query v1.1 supports a hard limit of up to 4,294,967,294.

License Duration Information
startTime The time at which the current license code was issued by the License Manager.
endTime The time at which the user’s current license will expire if not renewed.
License Sharing Related
isSharing

NOTE   This field is deprecated. Use 'sharedClientCount' in place of this field.

Total number of clients sharing this particular license, including the current client being queried. If sharing is disabled, isSharing will be 0.

sharedClientCount Total number of clients sharing this particular license, including the current client being queried. If sharing is disabled, sharedClientCount will be 0.
hostName Name of the host/computer where the user is running the application. In case of standalone licensing, the “default-hostname” string will be returned.
xDisplayName Name of the X display where the user is displaying the application In case of standalone licensing, the “default x-display name” string will be returned.
sharedIdName

NOTE   This field is deprecated. Use 'vendorDefinedSharingId' in place of this field.

A special vendor-defined ID that can be used for license sharing decisions.

vendorDefinedSharingId A special vendor-defined ID that can be used for license sharing decisions. The maximum length of the string is set to 31 characters. In case of standalone licensing, the “default-sharing-ID” string will be returned.
License Holding Information
isHolding Returns 0, if the user’s current license is held after expiration. Otherwise returns 1.
holdTime Specifies the hold time, in seconds, if any.
Commuter Information
isCommuted Returns 1, if the user has checked out the license from the network. Otherwise returns 0.
Group Reservation Related
group Name of the reserved group to which the user belongs. If the user does not belong to an explicitly named group, DefaultGrp is returned.
totalTeamTokensResv Total reserved units. 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).
reservedTeamTokensInUse Units given to teams from reserved pool.
unreservedTeamTokensInUse Units given to teams from unreserved pool.
clientVendorUsageData

NOTE   This field is deprecated. Use 'vendorUsageData' in place of this field.


The vendor usage data set during login or refresh.
vendorUsageData

The vendor usage data set during login or refresh.

Although you can set a string of up to 255 characters long during login or refresh, only up to 100 characters are shown here.

If no vendorUsageData is set in the refresh call, then the same vendorUsageData set during login is shown here. Similar behavior applies to auto-refresh calls.