lockCodeInfo—Locking Code Information

NOTE   The macro for obtaining Locking Code Information is SNTL_QUERY_LOCK_CODE_INFO_VERSION(v). Here, v represents the query version. Specify version under the double quotes, such as "1.0". This macro is introduced in v9.2.0.

Query

<?xml version="1.0" encoding="UTF-8"?>

<sentinelQuery query="lockCodeInfo" version="1.0"/>

Scope

The scopes below are segregated for two cases—Case A and Case B.

In case A, the fingerprint XML of a different system is provided to generate locking code. This is helpful in scenarios when the locking code is generated for another/remote system.

In case B, the fingerprint XML is not required in scope as it obtains the locking code of the same system.

Case A: Locking Code Scope for the Specified Fingerprint

NOTE   In the scope XML below, make sure that you have removed the start and end elements of <sentinelInfo> in fingerprintInfo output. The highlighted part below is an example of how to use fingerprint XML in scope.

<?xml version="1.0" encoding="UTF-8"?>
<sentinelScope>
	<lockSelector>0x4</lockSelector>
	<!-- The lock selector is mandatory.-->
	<fingerprint checksum="" version="1.1" type="SentinelRMS">
		<criteria>
			<name>ID Prom</name>
			<selector>0x1</selector>
			<hash/>
			<item>
				<rawValue/>
				<hashValue/>
			</item>
		</criteria>
		<criteria>
			<name>IP Address</name>
			<selector>0x2</selector>
			<hash>75DCBFE70A7366F4</hash>
			<item>
				<rawValue>10.164.109.117</rawValue>
				<hashValue>75DCBFE70A7366F4</hashValue>
			</item>
		</criteria>
		<criteria>
			<name>Disk ID</name>
			<selector>0x4</selector>
			<hash>8D5F5B56D5355955</hash>
			<item>
				<rawValue>0xB6ED695</rawValue>
				<hashValue>8D5F5B56D5355955</hashValue>
			</item>
		</criteria>
		<criteria>
			<name>Host Name</name>
			<selector>0x8</selector>
			<hash>291A411F41A79533</hash>
			<item>
				<rawValue>NOI-7RNMDC2</rawValue>
				<hashValue>291A411F41A79533</hashValue>
			</item>
		</criteria>
		<criteria>
			<name>Ethernet Address</name>
			<selector>0x10</selector>
			<hash>CF954AC701644C95</hash>
			<hash>A59E2C88CE2DD1F5</hash>
			<item>
				<rawValue>E4-B3-18-1E-89-21</rawValue>
				<hashValue>CF954AC701644C95</hashValue>
			</item>

			<item>
				<rawValue>84-7B-EB-41-81-CE</rawValue>
				<hashValue>A59E2C88CE2DD1F5</hashValue>
			</item>
		</criteria>
		<criteria>
			<name>Network IPX</name>
			<selector>0x20</selector>
			<hash/>
			<item>
				<rawValue/>
				<hashValue/>
			</item>
		</criteria>
		<criteria>
			<name>Network Serial</name>
			<selector>0x40</selector>
			<hash/>
			<item>
				<rawValue/>
				<hashValue/>
			</item>
		</criteria>
		<criteria>
			<name>Portable Serv</name>
			<selector>0x80</selector>
			<hash/>
			<item>
				<rawValue/>
				<hashValue/>
			</item>
		</criteria>
		<criteria>
			<name>Custom</name>
			<selector>0x100</selector>
			<hash/>
			<item>
				<rawValue/>
				<hashValue/>
			</item>
		</criteria>
		<criteria>
			<name>CPU Id</name>
			<selector>0x200</selector>
			<hash/>
			<item>
				<rawValue/>
				<hashValue/>
			</item>
		</criteria>
		<criteria>
			<name>Custom Ex</name>
			<selector>0x400</selector>
			<hash/>
			<item>
				<rawValue/>
				<hashValue/>
			</item>
		</criteria>
		<criteria>
			<name>Hard Disk Serial</name>
			<selector>0x800</selector>
			<hash>B03D05E1DE3B068D</hash>
			<item>
				<rawValue>JF364N981610300GY</rawValue>
				<hashValue>B03D05E1DE3B068D</hashValue>
			</item>
		</criteria>
		<criteria>
			<name>CPU Info</name>
			<selector>0x1000</selector>
			<hash>3378D2D541F1E3B4</hash>
			<item>
				<rawValue>GenuineIntel Intel(R) Core(TM) i7-6820HQ CPU @ 2.70GHz 6 14 3</rawValue>
				<hashValue>3378D2D541F1E3B4</hashValue>
			</item>
		</criteria>
		<criteria>
			<name>UUID</name>
			<selector>0x2000</selector>
			<hash>DAE464D249707089</hash>
			<item>
				<rawValue>4C4C4544-0052-4E10-804D-B7C04F444332</rawValue>
				<hashValue>DAE464D249707089</hashValue>
			</item>
		</criteria>
	</fingerprint>
</sentinelScope>

Case B: Locking Code Scope Without Specifying Fingerprint

Uses the system fingerprint information for generating the locking code.

<?xml version="1.0"?>
<sentinelScope>
	<!-- Null or empty scope is not allowed.-->
	<lockSelector>0x4</lockSelector> <! -- The lock selector is mandatory.-->
</sentinelScope>

NOTE   By default, decimal values are accepted for specifying a lockSelector value in the query scope. To provide hexadecimal values, prefix the input value with 0x.

Output

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<sentinelInfo>
	<lockCode>
		<selector>0x4</selector>
		<value>*1BQZLC7J4NX9PFP</value>
	</lockCode>
</sentinelInfo>

Element	Description
Locking Code Information
selector	The locking criterion (in hexadecimal).
value	A 16-byte long readable string that identifies a computer. However, this string is actually a 64-bit hash value based on SHA-256 algorithm.