<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns:MadCap="http://www.madcapsoftware.com/Schemas/MadCap.xsd" MadCap:tocPath="About the RMS License Manager" MadCap:InPreviewMode="false" MadCap:PreloadImages="false" MadCap:RuntimeFileType="Topic" MadCap:TargetType="WebHelp" lang="en-US" xml:lang="en-US" MadCap:PathToHelpSystem="../" MadCap:HelpSystemFileName="Default.xml" MadCap:SearchType="Stem">
    <head>
        <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /><title>Setting Usage Logging</title>
        <link href="SkinSupport/MadCap.css" rel="stylesheet" />
        <link href="Resources/TableStyles/BlackTable.css" rel="stylesheet" />
        <link href="Resources/Stylesheets/SFNT_Flare.css" rel="stylesheet" />
        <script src="SkinSupport/MadCapAll.js">
        </script>
    </head>
    <body>
        <p class="MCWebHelpFramesetLink MCWebHelpFramesetLinkTop" style="display: none;"><a href="../Default_CSH.htm#License Manager Usage Logs.htm" style="font-weight: bold;">Open the Table of Contents</a>
        </p>
        <div class="MCBreadcrumbsBox_0"><span class="MCBreadcrumbsPrefix">You are here: </span><a class="MCBreadcrumbsLink" href="RMS_License_Manager_Overview.htm">About the RMS License Manager</a><span class="MCBreadcrumbsDivider"> &gt; </span><span class="MCBreadcrumbs">License Manager Usage Logs</span>
        </div>
        <h1><a name="kanchor20"></a><a name="kanchor21"></a>License Manager Usage Logs</h1>
        <p>The License Manager can  record all license requests 
 and releases in the usage 
 log file.  Refer to the following sections for details:</p>
        <div class="MCDropDown">
            <div class="MCDropDownHead_0"><a class="MCDropDownHotSpot_0" href="javascript:void(0);" id="MCDropDownHotSpot_1728053639_0" onclick="FMCDropDown( this ); return false;" name="Contents"><img style="border: none;margin-right: 5px;" src="SkinSupport/DropDownClosed.gif" MadCap:altsrc="SkinSupport/DropDownOpen.gif" onload="if ( typeof( FMCPreloadImage ) == 'function' ) { FMCPreloadImage( 'SkinSupport/DropDownOpen.gif' ); }" class="MCDropDownIcon" />Contents of the Usage Log</a>
            </div>
            <div class="MCDropDownBody" id="MCDropDownBody_1728053639_0" style="display: none;">
                <p>The name and location of the usage file is set by the License Manager startup options. The License Manager records all license requests 
 and releases in this file. Usage reports can be generated using <a href="lsusage_Log.htm">lsusage</a>. </p>
                <table style="left: 0px;top: 163px;height: 62px;border-spacing: 0px;mc-table-style: url('Resources/TableStyles/BlackTable.css');margin-left: 0;margin-right: auto;caption-side: top;width: 100%;" cellspacing="0" height="62" class="TableStyle-BlackTable">
                    <col style="width: 137px;" class="Column-Column1" />
                    <col style="width: 697px;" class="Column-Column1" />
                    <thead>
                        <tr class="Head-Header1">
                            <th class="HeadE-Column1-Header1">Element</th>
                            <th class="HeadD-Column1-Header1">Description</th>
                        </tr>
                    </thead>
                    <tr valign="top" class="Body-Body1">
                        <td style="padding-right: 10px;padding-left: 10px;border-left-color: #808080;border-left-width: 1px;border-left-style: Solid;border-right-style: Solid;border-right-color: #808080;border-right-width: 1px;border-bottom-style: Solid;border-bottom-color: #808080;border-bottom-width: 1px;" class="BodyE-Column1-Body1">
                            <p><b>Server-LFE</b>
                            </p>
                        </td>
                        <td style="padding-right: 10px;padding-left: 10px;border-right-style: Solid;border-right-color: #808080;border-right-width: 1px;border-bottom-style: Solid;border-bottom-color: #808080;border-bottom-width: 1px;" class="BodyD-Column1-Body1">
                            <p>Customer-defined log file encryption level as specified by the License Manager -lfe option. See <a href="#Encrypt">Encrypting 
 License Manager Log File Entries</a>.</p>
                        </td>
                    </tr>
                    <tr valign="top" class="Body-Body1">
                        <td style="padding-right: 10px;padding-left: 10px;border-right-style: Solid;border-bottom-style: Solid;border-right-color: #808080;border-right-width: 1px;border-left-color: #808080;border-left-width: 1px;border-left-style: Solid;border-bottom-color: #808080;border-bottom-width: 1px;" class="BodyE-Column1-Body1">
                            <p><b>License-LFE</b>
                            </p>
                        </td>
                        <td style="padding-right: 10px;padding-left: 10px;border-right-style: Solid;border-bottom-style: Solid;border-bottom-color: #808080;border-bottom-width: 1px;border-right-color: #808080;border-right-width: 1px;" class="BodyD-Column1-Body1">
                            <p>Vendor-defined log file encryption level. If this is non-zero, it overrides 
 the Server-LFE.</p>
                        </td>
                    </tr>
                    <tr valign="top" class="Body-Body1">
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-left-style: Solid;border-left-width: 1px;border-left-color: #808080;border-right-width: 1px;border-right-color: #808080;border-right-style: Solid;border-bottom-width: 1px;border-bottom-color: #808080;border-bottom-style: Solid;" class="BodyE-Column1-Body1">
                            <p><b>Date </b>
                            </p>
                        </td>
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-right-width: 1px;border-right-color: #808080;border-right-style: Solid;border-bottom-width: 1px;border-bottom-color: #808080;border-bottom-style: Solid;" class="BodyD-Column1-Body1">
                            <p>The date and time at which the usage log entry is made in the format: Day-of-week Month Date Time 
 (hh:mm:ss) 
 Year</p>
                        </td>
                    </tr>
                    <tr valign="top" class="Body-Body1">
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-left-color: #808080;border-left-width: 1px;border-left-style: Solid;border-right-style: Solid;border-right-color: #808080;border-right-width: 1px;border-bottom-style: Solid;border-bottom-color: #808080;border-bottom-width: 1px;" class="BodyE-Column1-Body1">
                            <p><b>Time-stamp</b>
                            </p>
                        </td>
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-right-style: Solid;border-right-color: #808080;border-right-width: 1px;border-bottom-style: Solid;border-bottom-color: #808080;border-bottom-width: 1px;" class="BodyD-Column1-Body1">
                            <p>The time stamp at which the usage log entry is made.</p>
                        </td>
                    </tr>
                    <tr valign="top" class="Body-Body1">
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-left-style: Solid;border-left-width: 1px;border-left-color: #808080;border-right-width: 1px;border-right-color: #808080;border-right-style: Solid;border-bottom-width: 1px;border-bottom-color: #808080;border-bottom-style: Solid;" class="BodyE-Column1-Body1">
                            <p><b>Feature</b>
                            </p>
                        </td>
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-right-width: 1px;border-right-color: #808080;border-right-style: Solid;border-bottom-width: 1px;border-bottom-color: #808080;border-bottom-style: Solid;" class="BodyD-Column1-Body1">
                            <p>Product feature name.</p>
                        </td>
                    </tr>
                    <tr valign="top" class="Body-Body1">
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-left-color: #808080;border-left-width: 1px;border-left-style: Solid;border-right-style: Solid;border-right-color: #808080;border-right-width: 1px;border-bottom-style: Solid;border-bottom-color: #808080;border-bottom-width: 1px;" class="BodyE-Column1-Body1">
                            <p><b>Ver </b>
                            </p>
                        </td>
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-right-style: Solid;border-right-color: #808080;border-right-width: 1px;border-bottom-style: Solid;border-bottom-color: #808080;border-bottom-width: 1px;" class="BodyD-Column1-Body1">
                            <p>Product version name.</p>
                        </td>
                    </tr>
                    <tr valign="top" class="Body-Body1">
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-left-style: Solid;border-left-width: 1px;border-left-color: #808080;border-right-width: 1px;border-right-color: #808080;border-right-style: Solid;border-bottom-width: 1px;border-bottom-color: #808080;border-bottom-style: Solid;" class="BodyE-Column1-Body1">
                            <p><b><a name="Trans"></a><a name="kanchor22"></a>Trans</b>
                            </p>
                        </td>
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-right-width: 1px;border-right-color: #808080;border-right-style: Solid;border-bottom-width: 1px;border-bottom-color: #808080;border-bottom-style: Solid;" class="BodyD-Column1-Body1">
                            <p>The transaction types are categorized and described below:</p>
                            <p><b><a href="ImplicitEntries.htm">Explicit Entries</a>:</b>
                            </p>
                            <ul>
                                <li class="Table_Bullets" value="1">0 - A license is issued. </li>
                                <li class="Table_Bullets" value="2">1 - A license is denied.</li>
                                <li class="Table_Bullets" value="3">2 - The License Manager has released the issued key for which no update was received from client application.</li>
                                <li class="Table_Bullets" value="4">3 - &#160;A queued key is issued and the client is placed in a queue. When the license would be available (after other clients release any token), this client may get that license.</li>
                                <li class="Table_Bullets" value="5">4 - The queuing request failed.</li>
                                <li class="Table_Bullets" value="6">5 - The queuing request succeeded, however, instead of obtaining a queued key the client receives the normal key and is not placed in the queue.</li>
                                <li class="Table_Bullets" value="7">6 - A queued license is converted to an actual license. This happens when the client obtains the license that was released by some other client (and a queued client may call the VLSgetQueuedClient API to get the key). Thereafter, the client is removed from the queue.</li>
                                <li class="Table_Bullets" value="8">7 - A queued license key that was issued earlier is released as it could not be converted into an actual license key (non-queued key) after a certain time period.</li>
                                <li class="Table_Bullets" value="9">8 - A commuter license is checked out.</li>
                                <li class="Table_Bullets" value="10">9 - A commuter license is checked in. </li>
                            </ul>
                            <p><b><a href="ImplicitEntries.htm">Implicit Entries</a>:</b>
                            </p>
                            <ul>
                                <li class="Table_Bullets" value="1">10 - Implicit license release entry when the License Manager performs cleanup of in use keys before shutdown.</li>
                                <li class="Table_Bullets" value="2">11 - Implicit license release entry when the License Manager reclaims tokens after the key lifetime period has expired. </li>
                                <li class="Table_Bullets" value="3">12 - Implicit license release entry when any of the following transactions takes place:</li>
                                <li class="Bullets_2" value="4">License A is released at midnight when license switches to License B.             <![CDATA[ ]]></li>
                                <li class="Bullets_2" value="5">Or, the license is released after actual revocation takes place for a deferred revocation case. </li>
                                <li class="Bullets_2" value="6">Or, License A is released when  License B is dynamically added.</li>
                                <li class="Table_Bullets" value="7">13 - Implicit license release entry when the usage log file is changed under any of the following scenarios:</li>
                                <li class="Bullets_2" value="8">When the backup usage log file is created (in case of overflow), a license release entry in the backup log file.</li>
                                <li class="Bullets_2" value="9">When the log file is changed by calling the VLSchangeUsageLogFileName API, a license release entry in the previous log file.</li>
                            </ul>
                            <ul>
                                <li class="Table_Bullets" value="1">14 - Implicit license request entry under the scenarios when update calls are converted into request. For example:</li>
                                <li class="Bullets_2" value="2">When clients are running and the heartbeat message is sent after the License Manager restart</li>
                                <li class="Bullets_2" value="3">When heartbeat messages are sent after the <a href="KeyLifetime.htm">key lifetime</a> expiration</li>
                                <li class="Table_Bullets" value="4">15 - Implicit license request entry under any of the following scenarios:</li>
                                <li class="Bullets_2" value="5">When the backup usage log file is created (in case of overflow), a license request entry in the new log file.</li>
                                <li class="Bullets_2" value="6">When the log file is changed by calling the VLSchangeUsageLogFileName API, a license request entry in the new log file.</li>
                                <li class="Table_Bullets" value="7">16 - Implicit release entries in the usage log file of the follower server, when the original leader comes back after going down (in the case of <a href="Overview_Redundantlicserver.htm">redundant License Manager setup).</a></li>
                            </ul>
                        </td>
                    </tr>
                    <tr valign="top" class="Body-Body1">
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-left-color: #808080;border-left-width: 1px;border-left-style: Solid;border-right-style: Solid;border-right-color: #808080;border-right-width: 1px;border-bottom-style: Solid;border-bottom-color: #808080;border-bottom-width: 1px;" class="BodyE-Column1-Body1">
                            <p><b>Numkeys</b>
                            </p>
                        </td>
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-right-style: Solid;border-right-color: #808080;border-right-width: 1px;border-bottom-style: Solid;border-bottom-color: #808080;border-bottom-width: 1px;" class="BodyD-Column1-Body1">
                            <p>The number of licenses in use after the current request/release. (Encrypted 
 if encryption level is set to 3 or 4.)</p>
                        </td>
                    </tr>
                    <tr valign="top" class="Body-Body1">
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-left-style: Solid;border-left-width: 1px;border-left-color: #808080;border-right-width: 1px;border-right-color: #808080;border-right-style: Solid;border-bottom-width: 1px;border-bottom-color: #808080;border-bottom-style: Solid;" class="BodyE-Column1-Body1">
                            <p><b>Keylife </b>
                            </p>
                        </td>
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-right-width: 1px;border-right-color: #808080;border-right-style: Solid;border-bottom-width: 1px;border-bottom-color: #808080;border-bottom-style: Solid;" class="BodyD-Column1-Body1">
                            <p>For how long (in seconds) the license was in use. Only applicable in a license release entry.</p>
                        </td>
                    </tr>
                    <tr valign="top" class="Body-Body1">
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-left-color: #808080;border-left-width: 1px;border-left-style: Solid;border-right-style: Solid;border-right-color: #808080;border-right-width: 1px;border-bottom-style: Solid;border-bottom-color: #808080;border-bottom-width: 1px;" class="BodyE-Column1-Body1">
                            <p><b>User</b>
                            </p>
                        </td>
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-right-style: Solid;border-right-color: #808080;border-right-width: 1px;border-bottom-style: Solid;border-bottom-color: #808080;border-bottom-width: 1px;" class="BodyD-Column1-Body1">
                            <p>The user name of the application associated with the entry. This element can be logged anonymously if the <a href="License_Manager_LSERVOPTS.htm#anonymous">anonymous logging option</a> is set.</p>
                        </td>
                    </tr>
                    <tr valign="top" class="Body-Body1">
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-left-style: Solid;border-left-width: 1px;border-left-color: #808080;border-right-width: 1px;border-right-color: #808080;border-right-style: Solid;border-bottom-width: 1px;border-bottom-color: #808080;border-bottom-style: Solid;" class="BodyE-Column1-Body1">
                            <p><b>Host</b>
                            </p>
                        </td>
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-right-width: 1px;border-right-color: #808080;border-right-style: Solid;border-bottom-width: 1px;border-bottom-color: #808080;border-bottom-style: Solid;" class="BodyD-Column1-Body1">
                            <p>The host name of the application associated with the entry. This element can be logged anonymously if the <a href="License_Manager_LSERVOPTS.htm#anonymous">anonymous logging option</a> is set.</p>
                        </td>
                    </tr>
                    <tr valign="top" class="Body-Body1">
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-left-color: #808080;border-left-width: 1px;border-left-style: Solid;border-right-style: Solid;border-right-color: #808080;border-right-width: 1px;border-bottom-style: Solid;border-bottom-color: #808080;border-bottom-width: 1px;" class="BodyE-Column1-Body1">
                            <p><b>LSver </b>
                            </p>
                        </td>
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-right-style: Solid;border-right-color: #808080;border-right-width: 1px;border-bottom-style: Solid;border-bottom-color: #808080;border-bottom-width: 1px;" class="BodyD-Column1-Body1">
                            <p>The version of the License Manager.</p>
                        </td>
                    </tr>
                    <tr valign="top" class="Body-Body1">
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-left-style: Solid;border-left-width: 1px;border-left-color: #808080;border-right-width: 1px;border-right-color: #808080;border-right-style: Solid;border-bottom-width: 1px;border-bottom-color: #808080;border-bottom-style: Solid;" class="BodyE-Column1-Body1">
                            <p><b>Currency </b>
                            </p>
                        </td>
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-right-width: 1px;border-right-color: #808080;border-right-style: Solid;border-bottom-width: 1px;border-bottom-color: #808080;border-bottom-style: Solid;" class="BodyD-Column1-Body1">
                            <p>The number of licenses handled during the transaction. (Encrypted if 
 encryption level is set to 3 or 4.)</p>
                        </td>
                    </tr>
                    <tr valign="top" class="Body-Body1">
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-left-color: #808080;border-left-width: 1px;border-left-style: Solid;border-right-style: Solid;border-right-color: #808080;border-right-width: 1px;border-bottom-style: Solid;border-bottom-color: #808080;border-bottom-width: 1px;" class="BodyE-Column1-Body1">
                            <p><b>Comment</b>
                            </p>
                        </td>
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-right-style: Solid;border-right-color: #808080;border-right-width: 1px;border-bottom-style: Solid;border-bottom-color: #808080;border-bottom-width: 1px;" class="BodyD-Column1-Body1">
                            <p>The data passed in by the vendor's licensed application. This element can be logged anonymously if the License Manager <a href="License_Manager_LSERVOPTS.htm#anonymous">anonymous logging option</a> is set and vendor has allowed anonymization of comments in the licensed application. </p>
                            <p>The comment  can be fully or partially anonymized depending on the vendor's implementation. </p>
                        </td>
                    </tr>
                </table>
                <p>The information is 
 recorded in the log file one entry per line in the following format. A typical entry might appear as:</p><pre># Startup Sentinel RMS License Manager v8.5.3 Tue Jul 31 12:59:12 2012  1343719752 MACHINE1 1 4292<br /><br />2 3 ODA= Tue Jul 31 13:00:20 2012  1343719820 f1 v1 0 1 0 jsmith MACHINE1 8.5.3 1 my_log_comment - - - - - 0 - - - MA== 918458 MTM0NDYzODI3OA==<br /><br /># Shutdown Sentinel RMS License Manager v8.5.3 Tue Jul 31 13:01:33 2012  1343719893 4292 Mg== 682513</pre>
                <p>If the License Manager is started with <a href="License_Manager_LSERVOPTS.htm#extended">extended log option</a>, an entry in the log file might appear as:</p><pre># Startup Sentinel RMS License Manager v8.5.3 Mon Sep 10 15:35:06 2012  1347271506 MACHINE1 120 3836 <b style="color: #000000;">v1.0</b><br /><br />2 3 ODA= Mon Sep 10 15:35:06 2012  1347271506 f1 v1  <b style="color: #000000;">15</b> 1 0 jsmith MACHINE1 8.5.3 1 my_log_comment - - - - - 0 - - - MA== 151321 MTM0NzQyMjgyNw==<br /><br /># Shutdown Sentinel RMS License Manager v8.5.3 Mon Sep 10 15:35:06 2012  1347271506  3836 Mg== 1992393</pre>
                <p>The table below describes the various fields of the first entry  reading from left 
 to right: </p>
                <table style="left: 0px;top: 13px;border-spacing: 0px;mc-table-style: url('Resources/TableStyles/BlackTable.css');margin-left: 0;margin-right: auto;caption-side: top;width: 100%;" cellspacing="0" class="TableStyle-BlackTable">
                    <col style="width: 167px;" class="Column-Column1" />
                    <col style="width: 235px;" class="Column-Column1" />
                    <col style="width: 419px;" class="Column-Column1" />
                    <thead>
                        <tr class="Head-Header1">
                            <th class="HeadE-Column1-Header1">Fields in Plain Log</th>
                            <th class="HeadE-Column1-Header1">Fields in Extended Log</th>
                            <th class="HeadD-Column1-Header1">Description</th>
                        </tr>
                    </thead>
                    <tr valign="top" class="Body-Body1">
                        <td class="BodyE-Column1-Body1"># Startup Sentinel RMS License Manager v8.5.3 Tue Jul 31 12:59:12 2012  1343719752 MACHINE1 <span style="color: #ff00ff;">1 </span>4292</td>
                        <td class="BodyE-Column1-Body1"># Startup Sentinel RMS License Manager v8.5.3 Mon Sep 10 15:35:06 2012  1347271506 MACHINE1 <span style="color: #ff00ff;">120</span> 3836 <b style="font-weight: normal;font-style: normal;color: #ff0000;">v1.0</b></td>
                        <td class="BodyD-Column1-Body1">
                            <p>License Manager's startup messages.</p>
                            <div class="SFNT_Note">
                                <ul>
                                    <li class="Bullets_1" value="1">The <span style="color: #ff0000;">v1.0</span> value (at the end of the extended log startup message) in the extended log record represents the version of the extended usage log format. Here 1.0 corresponds to the RMS v8.5.3 Windows release, in which the extended log option is introduced.</li>
                                    <li class="Bullets_1" value="2">The timestamp in the startup message represents the time when usage logging has started in the file.</li>
                                    <li class="Table_Bullets" value="3">Here <span style="color: #ff00ff;">1</span> and <span style="color: #ff00ff;">120</span> (appearing after the machine names ‘Machine1’) are the session IDs for each entry, respectively. This session ID represents each session in between the startup and the shutdown message. It reflects the continuity of the sessions between different License Manager restarts. Therefore, if the usage log file name is changed to another name (using the -l option) while re-starting the License Manager, it starts logging with a new (incremented) session ID in the new log file.</li>
                                </ul>
                            </div>
                        </td>
                    </tr>
                    <tr valign="top" class="Body-Body1">
                        <td style="padding-right: 10px;padding-left: 10px;border-left-color: #808080;border-left-width: 1px;border-left-style: Solid;border-right-style: Solid;border-right-color: #808080;border-right-width: 1px;border-bottom-style: Solid;border-bottom-color: #808080;border-bottom-width: 1px;" class="BodyE-Column1-Body1">
                            <p>2</p>
                        </td>
                        <td class="BodyE-Column1-Body1">2</td>
                        <td style="padding-right: 10px;padding-left: 10px;border-right-style: Solid;border-right-color: #808080;border-right-width: 1px;border-bottom-style: Solid;border-bottom-color: #808080;border-bottom-width: 1px;" class="BodyD-Column1-Body1">
                            <p>(Server-LFE) Customer-defined log file encryption level.</p>
                            <p>2 is the default  level for encrypting log file entries (see description below in the next section).</p>
                        </td>
                    </tr>
                    <tr valign="top" class="Body-Body1">
                        <td style="padding-right: 10px;padding-left: 10px;border-right-style: Solid;border-bottom-style: Solid;border-right-color: #808080;border-right-width: 1px;border-left-color: #808080;border-left-width: 1px;border-left-style: Solid;border-bottom-color: #808080;border-bottom-width: 1px;" class="BodyE-Column1-Body1">
                            <p>3</p>
                        </td>
                        <td class="BodyE-Column1-Body1">3</td>
                        <td style="padding-right: 10px;padding-left: 10px;border-right-style: Solid;border-bottom-style: Solid;border-bottom-color: #808080;border-bottom-width: 1px;border-right-color: #808080;border-right-width: 1px;" class="BodyD-Column1-Body1">
                            <p>(License-LFE) Vendor-defined log file encryption level. </p>
                            <p>3 means that vendor has allowed encryption of usage data. Transaction data will be 
 readable other than license usage data can be displayed by lsusage.</p>
                            <p class="SFNT_Note">The log file encryption level 3 will override any level set by the customer.</p>
                        </td>
                    </tr>
                    <tr valign="top" class="Body-Body1">
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-left-style: Solid;border-left-width: 1px;border-left-color: #808080;border-right-width: 1px;border-right-color: #808080;border-right-style: Solid;border-bottom-width: 1px;border-bottom-color: #808080;border-bottom-style: Solid;" class="BodyE-Column1-Body1">
                            <p>Tue Jul 31 13:00:20 2012</p>
                        </td>
                        <td class="BodyE-Column1-Body1">Mon Sep 10 15:35:06 2012</td>
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-right-width: 1px;border-right-color: #808080;border-right-style: Solid;border-bottom-width: 1px;border-bottom-color: #808080;border-bottom-style: Solid;" class="BodyD-Column1-Body1">
                            <p>(Date) Date and time at which the license transaction was made.</p>
                        </td>
                    </tr>
                    <tr valign="top" class="Body-Body1">
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-left-color: #808080;border-left-width: 1px;border-left-style: Solid;border-right-style: Solid;border-right-color: #808080;border-right-width: 1px;border-bottom-style: Solid;border-bottom-color: #808080;border-bottom-width: 1px;" class="BodyE-Column1-Body1">
                            <p>1343719820</p>
                        </td>
                        <td class="BodyE-Column1-Body1">1347271506 </td>
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-right-style: Solid;border-right-color: #808080;border-right-width: 1px;border-bottom-style: Solid;border-bottom-color: #808080;border-bottom-width: 1px;" class="BodyD-Column1-Body1">
                            <p>(Time-stamp) Time-stamp of the transaction record. </p>
                            <p>This timestamp represents the time of creation of the log entry.</p>
                        </td>
                    </tr>
                    <tr valign="top" class="Body-Body1">
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-left-style: Solid;border-left-width: 1px;border-left-color: #808080;border-right-width: 1px;border-right-color: #808080;border-right-style: Solid;border-bottom-width: 1px;border-bottom-color: #808080;border-bottom-style: Solid;" class="BodyE-Column1-Body1">
                            <p>f1 v1</p>
                        </td>
                        <td class="BodyE-Column1-Body1">f1 v1</td>
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-right-width: 1px;border-right-color: #808080;border-right-style: Solid;border-bottom-width: 1px;border-bottom-color: #808080;border-bottom-style: Solid;" class="BodyD-Column1-Body1">
                            <p>(Feature/Ver) 
 Feature name a and 2 version for the first license.</p>
                            <p>4 is both the feature name and version for the second license.</p>
                        </td>
                    </tr>
                    <tr valign="top" class="Body-Body1">
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-left-color: #808080;border-left-width: 1px;border-left-style: Solid;border-right-style: Solid;border-right-color: #808080;border-right-width: 1px;border-bottom-style: Solid;border-bottom-color: #808080;border-bottom-width: 1px;" class="BodyE-Column1-Body1">
                            <p>0</p>
                        </td>
                        <td class="BodyE-Column1-Body1">15</td>
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-right-style: Solid;border-right-color: #808080;border-right-width: 1px;border-bottom-style: Solid;border-bottom-color: #808080;border-bottom-width: 1px;" class="BodyD-Column1-Body1">
                            <p>(Trans) The transaction ID.</p>
                            <p>0 denotes that a license 
 was granted.</p>
                            <p>15 denotes an implicit license request entry as per the scenario described in the transaction ID #15 above. </p>
                        </td>
                    </tr>
                    <tr valign="top" class="Body-Body1">
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-left-style: Solid;border-left-width: 1px;border-left-color: #808080;border-right-width: 1px;border-right-color: #808080;border-right-style: Solid;border-bottom-width: 1px;border-bottom-color: #808080;border-bottom-style: Solid;" class="BodyE-Column1-Body1">
                            <p>1</p>
                        </td>
                        <td class="BodyE-Column1-Body1">1</td>
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-right-width: 1px;border-right-color: #808080;border-right-style: Solid;border-bottom-width: 1px;border-bottom-color: #808080;border-bottom-style: Solid;" class="BodyD-Column1-Body1">
                            <p>(Numkeys) 
 1 token was in use after the request.</p>
                        </td>
                    </tr>
                    <tr valign="top" class="Body-Body1">
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-left-color: #808080;border-left-width: 1px;border-left-style: Solid;border-right-style: Solid;border-right-color: #808080;border-right-width: 1px;border-bottom-style: Solid;border-bottom-color: #808080;border-bottom-width: 1px;" class="BodyE-Column1-Body1">
                            <p>0</p>
                        </td>
                        <td class="BodyE-Column1-Body1">0</td>
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-right-style: Solid;border-right-color: #808080;border-right-width: 1px;border-bottom-style: Solid;border-bottom-color: #808080;border-bottom-width: 1px;" class="BodyD-Column1-Body1">
                            <p>(Keylife) 
 Only applicable for a license release.</p>
                        </td>
                    </tr>
                    <tr valign="top" class="Body-Body1">
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-left-style: Solid;border-left-width: 1px;border-left-color: #808080;border-right-width: 1px;border-right-color: #808080;border-right-style: Solid;border-bottom-width: 1px;border-bottom-color: #808080;border-bottom-style: Solid;" class="BodyE-Column1-Body1">
                            <p>jsmith</p>
                        </td>
                        <td class="BodyE-Column1-Body1">jsmith</td>
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-right-width: 1px;border-right-color: #808080;border-right-style: Solid;border-bottom-width: 1px;border-bottom-color: #808080;border-bottom-style: Solid;" class="BodyD-Column1-Body1">
                            <p>(User) The user requesting the license. </p>
                        </td>
                    </tr>
                    <tr valign="top" class="Body-Body1">
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-left-color: #808080;border-left-width: 1px;border-left-style: Solid;border-right-style: Solid;border-right-color: #808080;border-right-width: 1px;border-bottom-style: Solid;border-bottom-color: #808080;border-bottom-width: 1px;" class="BodyE-Column1-Body1">
                            <p>MACHINE1 </p>
                        </td>
                        <td class="BodyE-Column1-Body1">MACHINE1 </td>
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-right-style: Solid;border-right-color: #808080;border-right-width: 1px;border-bottom-style: Solid;border-bottom-color: #808080;border-bottom-width: 1px;" class="BodyD-Column1-Body1">
                            <p>(Host) The host name of the computer on which the license request was 
 made.</p>
                        </td>
                    </tr>
                    <tr valign="top" class="Body-Body1">
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-left-style: Solid;border-left-width: 1px;border-left-color: #808080;border-right-width: 1px;border-right-color: #808080;border-right-style: Solid;border-bottom-width: 1px;border-bottom-color: #808080;border-bottom-style: Solid;" class="BodyE-Column1-Body1">
                            <p>8.5.3</p>
                        </td>
                        <td class="BodyE-Column1-Body1">8.5.3</td>
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-right-width: 1px;border-right-color: #808080;border-right-style: Solid;border-bottom-width: 1px;border-bottom-color: #808080;border-bottom-style: Solid;" class="BodyD-Column1-Body1">
                            <p>(LSver) The License Manager version.</p>
                        </td>
                    </tr>
                    <tr valign="top" class="Body-Body1">
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-left-color: #808080;border-left-width: 1px;border-left-style: Solid;border-right-style: Solid;border-right-color: #808080;border-right-width: 1px;border-bottom-style: Solid;border-bottom-color: #808080;border-bottom-width: 1px;" class="BodyE-Column1-Body1">
                            <p>1</p>
                        </td>
                        <td class="BodyE-Column1-Body1">1</td>
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-right-style: Solid;border-right-color: #808080;border-right-width: 1px;border-bottom-style: Solid;border-bottom-color: #808080;border-bottom-width: 1px;" class="BodyD-Column1-Body1">
                            <p>(Currency) The number of license requested for that key. Only 1 license was handled in both the transactions.</p>
                        </td>
                    </tr>
                    <tr valign="top" class="Body-Body1">
                        <td style="padding-right: 10px;padding-left: 10px;border-left-color: #808080;border-left-width: 1px;border-left-style: Solid;border-right-style: Solid;border-right-color: #808080;border-right-width: 1px;border-bottom-style: Solid;border-bottom-color: #808080;border-bottom-width: 1px;" class="BodyE-Column1-Body1">my_log_comment </td>
                        <td class="BodyE-Column1-Body1">my_log_comment </td>
                        <td style="padding-right: 10px;padding-left: 10px;border-right-style: Solid;border-right-color: #808080;border-right-width: 1px;border-bottom-style: Solid;border-bottom-color: #808080;border-bottom-width: 1px;" class="BodyD-Column1-Body1">The log comment specified by the vendor. </td>
                    </tr>
                    <tr valign="top" class="Body-Body1">
                        <td style="padding-right: 10px;padding-left: 10px;border-left-color: #808080;border-left-width: 1px;border-left-style: Solid;border-right-style: Solid;border-right-color: #808080;border-right-width: 1px;border-bottom-style: Solid;border-bottom-color: #808080;border-bottom-width: 1px;" class="BodyE-Column1-Body1"># Shutdown Sentinel RMS License Manager v8.5.3 Tue Jul 31 13:01:33 2012  1343719893 4292 Mg== 682513</td>
                        <td class="BodyE-Column1-Body1"># Shutdown Sentinel RMS License Manager v8.5.3 Mon Sep 10 15:35:06 2012  1347271506  3836 Mg== 1992393</td>
                        <td style="padding-right: 10px;padding-left: 10px;border-right-style: Solid;border-right-color: #808080;border-right-width: 1px;border-bottom-style: Solid;border-bottom-color: #808080;border-bottom-width: 1px;" class="BodyD-Column1-Body1">License Manager's shutdown messages.</td>
                    </tr>
                </table>
                <p class="SFNT_Note">If the Sentinel RMS  usage log file contains characters that 
 are not 7-bit ASCII (for example, if a user name contains multi-byte characters 
 such as Japanese Kanji 
 characters), those characters will not be viewable when looking directly 
 at the log file. However, if you use the lsusage -c 
 option to create CSV-format 
 output from the log file, you will be able to view the multi-byte 
 characters if you view the CSV-format 
 file with an appropriate text editor on an operating system that displays 
 the multi-byte language. Also, when <a href="License_Manager_LSERVOPTS.htm#anonymous">anonymous usage logging option</a> is enabled, that multi byte user and host names will be logged anonymously.<br /><br />You can also create Microsoft Access reports 
 from the CSV-format file that can be viewed on a computer using the appropriate 
 multi-byte operating system. (For information on creating reports from 
 log file CSV-format output, see <a href="Creating_LicManager_Use_Reports.htm">Creating 
 License Manager Use Reports</a>)</p>
            </div>
        </div>
        <div class="MCDropDown">
            <div class="MCDropDownHead_0"><a class="MCDropDownHotSpot_0" href="javascript:void(0);" id="MCDropDownHotSpot_1728053639_1" onclick="FMCDropDown( this ); return false;" name="Managing"><img style="border: none;margin-right: 5px;" src="SkinSupport/DropDownClosed.gif" MadCap:altsrc="SkinSupport/DropDownOpen.gif" onload="if ( typeof( FMCPreloadImage ) == 'function' ) { FMCPreloadImage( 'SkinSupport/DropDownOpen.gif' ); }" class="MCDropDownIcon" />Managing the Size of the Usage Log File
 </a>
            </div>
            <div class="MCDropDownBody" id="MCDropDownBody_1728053639_1" style="display: none;">
                <p>Sentinel RMS writes records to the log file until it reaches its maximum 
 size. If you don’t 
 have much disk space, you can restrict the size of the log. The maximum number   of usage log files created by the License Manager is 100 files and the default value for maximum size is 50,00000 bytes (approximately 4.76MB).</p>
                <p>The default maximum size can be 
 changed using the -z 
 option in the LSERVOPTS environment variable or at command-line. Once 
 the maximum size is reached, the contents of the current log file will 
 be saved into a backup file unless the no-backup -x option has been used 
 in the LSERVOPTS environment variable or at command line. If -x has been 
 selected, the License Manager will simply stop logging when the maximum 
 size is reached. For information on the License Manager -x and -z 
 options and for more detail on how log file backups are created, see <a href="License_Manager_LSERVOPTS.htm">License Manager - Commonly 
 Used Variables</a>. Though it is best to use the 
 -z option to 
 specify the maximum size limit for the log file and to leave automatic 
 backup of log file enabled. Under some cases, as a part of your 
 payment arrangement with your vendor, your vendor may recommend you to not use  the -x option to stop log file backups. </p>
                <p>If disk space is not an issue, you may want to set the maximum size of your 
 log file fairly high to minimize the number of backup files created. For a site with a 2 megabyte log file limit 
 and no other License Manager options, LSERVOPTS would just be set to -z 
 2m. </p>
                <h3 class="SpacedHead">RECOMMENDATION: </h3>
                <p class="SpacedPara2">Please note the following recommendation regarding the management and backup of the License Manager usage log files. Suppose you have set the maximum size as 2 MB. While creating logs, if the size reaches 2 MB, the License Manager starts adding suffix at the end of the usage file name as 00, 01.. till 99, Example: <i>lserv.log.00, lserv.log.01, lserv.log.02...lserv.log.99</i>. Once this limit reaches, the License Manager starts generating the same log file name series and overwrites the existing usage files. Example: the log file creation will begin from<i> lserv.log.00.....lserv.log.99</i>; after reaching <i>lserv.log.99</i>, the License Manager would again start logging from <i>lserv.log.00</i>—hence overwriting the previous <i>lserv.log.00.</i> In order to preserve the log files, write a script that should first backup the 1st 100 log files. Once the limit of 100 is reached, these log files (<i>lserv.log.00</i> to <i>lserv.log.99</i>) should be backed to another location and must be deleted from the original location.<i>&#160;</i> <![CDATA[ ]]></p>
            </div>
        </div>
        <div class="MCDropDown">
            <div class="MCDropDownHead_0"><a class="MCDropDownHotSpot_0" href="javascript:void(0);" id="MCDropDownHotSpot_1728053639_2" onclick="FMCDropDown( this ); return false;" name="Encrypt"><img style="border: none;margin-right: 5px;" src="SkinSupport/DropDownClosed.gif" MadCap:altsrc="SkinSupport/DropDownOpen.gif" onload="if ( typeof( FMCPreloadImage ) == 'function' ) { FMCPreloadImage( 'SkinSupport/DropDownOpen.gif' ); }" class="MCDropDownIcon" />Encrypting 
 Log File Entries<br /></a>
            </div>
            <div class="MCDropDownBody" id="MCDropDownBody_1728053639_2" style="display: none;">
                <p class="Cell_Body" style="margin-top: 6pt;margin-bottom: 6pt;">For security reasons, you may wish to encrypt 
 part or all of a license transaction record in the License Manager log 
 file. To set the encryption level, use the <span class="Code">-lfe</span> 
 License Manager startup option, with any of the following levels:  </p>
                <table style="left: 0px;top: 550px;border-spacing: 0px;mc-table-style: url('Resources/TableStyles/BlackTable.css');margin-left: 0;margin-right: auto;caption-side: top;width: 100%;" cellspacing="0" class="TableStyle-BlackTable">
                    <col style="width: 122px;" class="Column-Column1" />
                    <col style="width: 79.191%;" class="Column-Column1" />
                    <thead>
                        <tr class="Head-Header1">
                            <th class="HeadE-Column1-Header1">Encryption Level</th>
                            <th class="HeadD-Column1-Header1">Description</th>
                        </tr>
                    </thead>
                    <tr valign="top" class="Body-Body1">
                        <td style="padding-right: 10px;padding-left: 10px;border-left-style: Solid;border-right-style: Solid;border-bottom-style: Solid;border-bottom-color: #000000;border-bottom-width: 1px;border-right-color: #000000;border-right-width: 1px;border-left-color: #000000;border-left-width: 1px;" class="BodyE-Column1-Body1">
                            <p style="margin-top: 0pt;">1</p>
                        </td>
                        <td style="padding-right: 10px;padding-left: 10px;border-right-style: Solid;border-bottom-style: Solid;border-bottom-color: #000000;border-bottom-width: 1px;border-right-color: #000000;border-right-width: 1px;" class="BodyD-Column1-Body1">
                            <p style="margin-top: 0pt;">Allows no encryption. Transaction data will be logged for this license code with no encryption.</p>
                        </td>
                    </tr>
                    <tr valign="top" class="Body-Body1">
                        <td style="padding-right: 10px;padding-left: 10px;border-left-style: Solid;border-right-style: Solid;border-bottom-style: Solid;border-bottom-color: #000000;border-bottom-width: 1px;border-right-color: #000000;border-right-width: 1px;border-left-color: #000000;border-left-width: 1px;" class="BodyE-Column1-Body1">
                            <p style="margin-top: 0pt;">2</p>
                        </td>
                        <td style="padding-right: 10px;padding-left: 10px;border-right-style: Solid;border-bottom-style: Solid;border-bottom-color: #000000;border-bottom-width: 1px;border-right-color: #000000;border-right-width: 1px;" class="BodyD-Column1-Body1">
                            <p style="margin-top: 0pt;">No encryption, <span style="background-color: #ffffff;">tags each record with checksum.</span> Transaction data will be readable by the customer, but tampering with or deleting an entry can be detected if the appropriate usage utility (lsusage) is run on the log file.</p>
                        </td>
                    </tr>
                    <tr valign="top" class="Body-Body1">
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-left-style: Solid;border-right-style: Solid;border-bottom-style: Solid;border-bottom-color: #000000;border-bottom-width: 1px;border-right-color: #000000;border-right-width: 1px;border-left-color: #000000;border-left-width: 1px;" class="BodyE-Column1-Body1">
                            <p style="margin-top: 0pt;">3</p>
                        </td>
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-right-style: Solid;border-bottom-style: Solid;border-bottom-color: #000000;border-bottom-width: 1px;border-right-color: #000000;border-right-width: 1px;" class="BodyD-Column1-Body1">
                            <p style="margin-top: 0pt;">Encrypt usage only. 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 if the appropriate usage utility (lsusage or vusage) is run on the log file.</p>
                        </td>
                    </tr>
                    <tr valign="top" class="Body-Body1">
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-left-style: Solid;border-right-style: Solid;border-bottom-style: Solid;border-right-color: #000000;border-right-width: 1px;border-left-color: #000000;border-left-width: 1px;border-bottom-color: #000000;border-bottom-width: 1px;" class="BodyE-Column1-Body1">
                            <p style="margin-top: 0pt;">4</p>
                        </td>
                        <td colspan="1" rowspan="1" style="padding-right: 10px;padding-left: 10px;border-right-style: Solid;border-bottom-style: Solid;border-bottom-color: #000000;border-bottom-width: 1px;border-right-color: #000000;border-right-width: 1px;" class="BodyD-Column1-Body1">
                            <p style="margin-top: 0pt;">Encrypt entire record. All transaction data for the license code will be encrypted. Tampering with or deleting an entry will not be prevented, but can be detected if the appropriate usage utility (lsusage) is run on the log file.</p>
                        </td>
                    </tr>
                </table>
                <p>The vendor can also set the encryption level in the license, between 1 to 4. The vendor's setting will always override any level specified by you (see the possible scenarios in the examples below). As a result, all entries for that license code will be encrypted to the level set by vendor,
 regardless of your encryption level settings. You may only set the encryption 
 level of transaction records for license codes for which your vendor has 
 allowed user-defined encryption. <br />Few examples of log encryption levels: </p>
                <ul>
                    <li class="Table_Bullets" value="1">Vendor = Not set, System administrator = 1-4, Conclusion = 1</li>
                    <li class="Table_Bullets" value="2">Vendor = 0, System administrator = Not set, Conclusion = 2</li>
                    <li class="Table_Bullets" value="3">Vendor = 0, System administrator = 1-4, Conclusion = 1-4 as set by the administrator</li>
                    <li class="Table_Bullets" value="4">Vendor = 1-4, System administrator = 1-4, Conclusion = As set by the vendor</li>
                    <li class="Table_Bullets" value="5">Vendor = 1-4 System administrator = Not set, Conclusion = As set by the vendor</li>
                </ul>
                <p>To learn more about lsusage, we recommend you to read through <a href="lsusage_Log.htm">lsusage 
 - Display the Usage Log File.</a><span style="color: #ff0000;font-weight: bold;"> <![CDATA[ ]]></span></p>
            </div>
        </div>
        <p>&#160;</p>
        <script type="text/javascript" src="SkinSupport/MadCapBodyEnd.js">
        </script>
    </body>
</html>