<?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="Setting Group Reservations" 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>Understanding the Reservation File</title>
        <link href="SkinSupport/MadCap.css" rel="stylesheet" />
        <link href="Resources/Stylesheets/SFNT_Flare.css" rel="stylesheet" />
        <script src="SkinSupport/MadCapAll.js" type="text/javascript">
        </script>
    </head>
    <body>
        <p class="MCWebHelpFramesetLink MCWebHelpFramesetLinkTop" style="display: none;"><a href="../Default_CSH.htm#Understanding the Reservation File.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="Setting_Group_Reservations.htm">Setting Group Reservations</a><span class="MCBreadcrumbsDivider"> &gt; </span><span class="MCBreadcrumbs">Understanding the Reservation File</span>
        </div>
        <h1><a name="kanchor72"></a><a name="kanchor73"></a>Understanding the Reservation File</h1>
        <p>The reservation file tells how many license tokens are reserved for 
 members of different groups. For example, the Sales department could be 
 a group with ten members for which 15 license tokens are reserved. The 
 members might be network users or specific computers on the network. The 
 reservation file might also tell that certain members of the group are 
 excluded from taking license tokens.</p>
        <p>When the License Manager receives a request, it checks whether the user 
 making the request belongs to a group. If so, and license tokens are available 
 for that group, the License Manager will issue the token(s) 
 and decrement the token count on the License Manager. Otherwise, requests 
 will be serviced with tokens that have not been reserved and that are 
 available. Users for whom tokens have been reserved have first call on 
 available tokens.</p>
        <p>At start up, the License Manager consults the environment variable, LSRESERV, 
 for the path and file name of the reservation file. If the variable is 
 not set, the local directory is searched for the file, <span style="font-style: italic;">lsreserv</span>. 
 If no file is found, the License Manager assumes that no reservations exist.</p>
        <h3>Reservation File Characteristics</h3>
        <p>The following apply to groups:</p>
        <ul>
            <li class="Bullets_1" value="1">A maximum of 256 groups, 
 each with 1000 members—user names, host IDs, IP addresses (IPv4 and IP v6)—are supported. </li>
            <li class="Bullets_1" value="2">Groups must be mutually 
 exclusive. Different groups for the same feature should not have common 
 users or computers. </li>
            <li class="Bullets_1" value="3">Group names and member 
 names cannot exceed 64 characters each. </li>
            <li class="Bullets_1" value="4">The number of license 
 tokens reserved for a feature cannot exceed the number of concurrent copies 
 specified in the license code for that feature.</li>
            <li class="Bullets_1" value="5">If you want to exclude 
 all members of a group from using license tokens for a feature, you can 
 specify 0 tokens.</li>
            <li class="Bullets_1" value="6">If the number of license 
 tokens reserved is greater than the number of concurrent copies specified 
 for the feature in the license code, the number of tokens specified in 
 the license code will be used. </li>
            <li class="Bullets_1" value="7">Incorrect DNS settings affect the group reservation behavior. The group reservation file can contain IP addresses. If an IP address is meant to be included, then the licenses should be first obtained from the reserved pool (followed by the free pool). And, if the IP address is meant to be excluded, then no license should be granted (from free or reserved pool). However, if the above behavior is found violated, the system administrator must check the DNS settings to verify that correct hostname-IP address mappings of the client and License Manager systems.</li>
            <li class="Bullets_1" value="8">The capacity desired 
 by a group for a specific feature cannot exceed the capacity of the defined 
 for that specific feature.</li>
            <li class="Bullets_1" value="9">A non-capacity feature 
 will not have any capacity related information in the reservation file. 
 </li>
        </ul>
        <p>&#160;</p>
        <script type="text/javascript" src="SkinSupport/MadCapBodyEnd.js">
        </script>
    </body>
</html>