clientInfo—Client Information

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.