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>
      <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/>
      </item>
</criteria>
<criteria>
      <name>Network Serial</name>
      <selector>0x40</selector>
      <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>
</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.