366 lines
14 KiB
HTML
366 lines
14 KiB
HTML
|
|
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html>
|
|
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
|
|
<title>Change License Information (CHGLICINF)</title>
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
|
</head>
|
|
<body bgcolor="white">
|
|
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<a name="CHGLICINF.Top_Of_Page"></a>
|
|
<h2>Change License Information (CHGLICINF)</h2>
|
|
<table width="100%">
|
|
<tr>
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
|
|
<b>Threadsafe: </b>No
|
|
</td>
|
|
<td valign="top" align="right">
|
|
<a href="#CHGLICINF.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CHGLICINF.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CHGLICINF.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CHGLICINF"></a>
|
|
<p>The Change License Information (CHGLICINF) command allows a user to change the following license information for a product or feature:
|
|
</p>
|
|
<ul>
|
|
<li>The usage limit for products that do not have keyed compliance (keyed compliance requires that you have a software license key from the software provider in order to change the usage limit of the license information)
|
|
</li>
|
|
<li>The threshold
|
|
</li>
|
|
<li>The users to notify when the threshold is exceeded, when an attempt to exceed the usage limit is made, or when the usage limit is changed
|
|
</li>
|
|
<li>The logging of usage requests.
|
|
</li>
|
|
</ul>
|
|
<p><b>Restriction:</b> This command is shipped with public *EXCLUDE authority.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGLICINF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CHGLICINF.PARAMETERS.TABLE">Parameters</a></h3>
|
|
<table border="1" cellpadding="4" cellspacing="0">
|
|
<!-- col1="10" col2="15" col3="30" col4="10" -->
|
|
<tr>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGLICINF.PRDID"><b>PRDID</b></a></td>
|
|
<td valign="top">Product identifier</td>
|
|
<td valign="top"><i>Character value</i></td>
|
|
<td valign="top">Required, Key, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGLICINF.LICTRM"><b>LICTRM</b></a></td>
|
|
<td valign="top">License term</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*ONLY</u></b></td>
|
|
<td valign="top">Optional, Key, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGLICINF.FEATURE"><b>FEATURE</b></a></td>
|
|
<td valign="top">Feature</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>5001</u></b></td>
|
|
<td valign="top">Optional, Key, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGLICINF.USGLMT"><b>USGLMT</b></a></td>
|
|
<td valign="top">Usage limit</td>
|
|
<td valign="top">0-999999, <b><u>*SAME</u></b>, *NOMAX, *ALTUSGLMT</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CHGLICINF.ALTUSGLMT"><b>ALTUSGLMT</b></a></td>
|
|
<td valign="top">Alternate usage limit</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Identified usage</td>
|
|
<td valign="top">
|
|
0-999999, <b><u>*SAME</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Unidentified usage</td>
|
|
<td valign="top">
|
|
0-999999, <b><u>*SAME</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGLICINF.THRESHOLD"><b>THRESHOLD</b></a></td>
|
|
<td valign="top">Threshold</td>
|
|
<td valign="top">0-999999, <b><u>*SAME</u></b>, *CALC, *USGLMT</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CHGLICINF.MSGQ"><b>MSGQ</b></a></td>
|
|
<td valign="top">Message queue</td>
|
|
<td valign="top">Single values: <b><u>*SAME</u></b>, *NONE, *OPSYS<br>Other values (up to 5 repetitions): <i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Message queue</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#CHGLICINF.LOG"><b>LOG</b></a></td>
|
|
<td valign="top">Log</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *NO, *YES</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGLICINF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CHGLICINF.PRDID"></a>
|
|
<h3>Product identifier (PRDID)</h3>
|
|
<p>Specifies the seven-character identifier (ID) of the product for which license information is to be changed.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGLICINF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGLICINF.LICTRM"></a>
|
|
<h3>License term (LICTRM)</h3>
|
|
<p>Specifies the license term for which license information is to be changed.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ONLY</u></b></dt>
|
|
<dd>Only one license term of the product is on the system and that license term identifies the product to be changed.
|
|
</dd>
|
|
<dt><b><i>license-term</i></b></dt>
|
|
<dd>Specify the license term in Vx, VxRy, or VxRyMz format, where x and y can be a number from 0 through 9 and z can be a number from 0 through 9 or a letter from A through Z. Use the Work with License Information (WRKLICINF) command to determine the license term.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGLICINF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGLICINF.FEATURE"></a>
|
|
<h3>Feature (FEATURE)</h3>
|
|
<p>Specifies the feature of the product specified on the <b>Product identifier (PRDID)</b> parameter for which license information is to be changed. You can use the Work with License Information (WRKLICINF) command to identify the feature number of the product.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>5001</u></b></dt>
|
|
<dd>The license information for the feature 5001 is to be changed.
|
|
</dd>
|
|
<dt><b><i>feature</i></b></dt>
|
|
<dd>Specify the feature for which license information is to be changed. Valid values range from 5001 through 9999.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGLICINF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGLICINF.USGLMT"></a>
|
|
<h3>Usage limit (USGLMT)</h3>
|
|
<p>Specifies the maximum number of users (usage limit) for this product or feature. The software provider authorizes the usage limit. For a concurrent usage limit, this is the maximum number of jobs allowed to access the product or feature at any given time. For a registered usage limit, this is the maximum number of license users that can be registered to use this product or feature.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>To change the usage limit for products using keyed compliance, you must use the Add License Key Information (ADDLICKEY) command.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
<dt><b>*NOMAX</b></dt>
|
|
<dd>The number of users is not limited.
|
|
</dd>
|
|
<dt><b>*ALTUSGLMT</b></dt>
|
|
<dd>The usage limit is the sum of the identified usage and the unidentified usage specified on the <b>Alternate usage limit (ALTUSGLMT)</b> parameter.
|
|
</dd>
|
|
<dt><b><i>usage-limit</i></b></dt>
|
|
<dd>Specify the maximum number of users for this product or feature. Valid values range from 0 through 999999.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGLICINF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGLICINF.ALTUSGLMT"></a>
|
|
<h3>Alternate usage limit (ALTUSGLMT)</h3>
|
|
<p>The alternate usage limit specifies the identified usage and the unidentified usage for this product or feature. The usage limit becomes the sum of the identified and unidentified usage.
|
|
</p>
|
|
<p>The possible identified usage values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
<dt><b><i>identified-usage</i></b></dt>
|
|
<dd>Specify the maximum number of users that can be counted by this product or feature. Valid values range from 0 through 999999.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible unidentified usage values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
<dt><b><i>unidentified-usage</i></b></dt>
|
|
<dd>Specify the maximum number of users that cannot be counted by this product or feature. Valid values range from 0 through 999999.
|
|
<p>
|
|
<b>Note: </b>The number of users specified for unidentified usage will always exist as part of the current usage for this product or feature.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGLICINF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGLICINF.THRESHOLD"></a>
|
|
<h3>Threshold (THRESHOLD)</h3>
|
|
<p>Specifies the threshold for this product or feature. When the number of users for this product exceeds the threshold, a message is sent to the system operator's message queue (QSYS/QSYSOPR) and to the message queues specified on the <b>Message queue (MSGQ)</b> parameter.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>If you specify a value equal to the usage limit, no threshold messages are sent. Messages are sent only when an attempt to exceed the usage limit is made, or when the usage limit is changed.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
<dt><b>*CALC</b></dt>
|
|
<dd>The system calculates the threshold for this product or feature. The calculated threshold is equal to 90 percent of the usage limit (maximum number of users specified on the <b>Usage limit (USGLMT)</b> parameter). If the usage limit is 1 or *NOMAX, the threshold is equal to the usage limit.
|
|
</dd>
|
|
<dt><b>*USGLMT</b></dt>
|
|
<dd>The threshold for this product or feature is equal to its usage limit.
|
|
</dd>
|
|
<dt><b><i>threshold</i></b></dt>
|
|
<dd>Specify the threshold for this product or feature. Valid values range from 0 through 999999.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGLICINF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGLICINF.MSGQ"></a>
|
|
<h3>Message queue (MSGQ)</h3>
|
|
<p>Specifies the qualified names of a maximum of five message queues to which messages are sent if (1) the threshold is exceeded, (2) an attempt to exceed the usage limit is made, or (3) the usage limit is changed. These messages are also sent to the system operator's message queue (QSYS/QSYSOPR).
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>Messages are sent only to the system operator's message queue (QSYS/QSYSOPR).
|
|
</dd>
|
|
<dt><b>*OPSYS</b></dt>
|
|
<dd>Messages are sent to the message queues defined in the license information for the operating system.
|
|
</dd>
|
|
</dl>
|
|
<p>The name of the message queue can be qualified by one of the following library values:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the thread is searched. If no library is specified as the current library for the thread, the QGPL library is searched.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>Specify the name of the library to be searched.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b><i>message-queue-name</i></b></dt>
|
|
<dd>Specify the name of the message queue to which messages are sent.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGLICINF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGLICINF.LOG"></a>
|
|
<h3>Log (LOG)</h3>
|
|
<p>Specifies whether to record requests to use the product or feature when the usage count is equal to the usage limit. If requests are recorded, they are recorded in the QLZALOG journal in QUSRSYS.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>The requests made when the usage count is equal to the usage limit are not recorded.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>The requests made when the usage count is equal to the usage limit are recorded. When a license request is made and the usage count is equal to the usage limit, the user requesting a license and all current license users are recorded in the QLZALOG journal in QUSRSYS.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGLICINF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGLICINF.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Changing the Usage Limit for a Product with One License Term on the System</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CHGLICINF PRDID(1MYPROD) LICTRM(*ONLY)
|
|
USGLMT(35) THRESHOLD(30)
|
|
MSGQ(MYLIB/MYMSGQ) LOG(*NO)
|
|
</pre>
|
|
</p>
|
|
<p>This command allows you to change the usage limit for the product with product identifier 1MYPROD which has only one license term installed on this system. After this command is run, 35 users will be authorized to use this product. When the usage count reaches 31, messages will be sent to the system operator's message queue and the message queue MYMSGQ in the library MYLIB stating that the threshold has been exceeded. Requests for a license when the usage count is equal to the usage limit will not be recorded. However, changes to the usage limit will be recorded in the QLZALOG journal in QUSRSYS.
|
|
</p>
|
|
<p><b>Example 2: Changing the Usage Limit for a Product with More Than One License Term on the System</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CHGLICINF PRDID(2MYPROD) LICTRM(V2)
|
|
USGLMT(50) THRESHOLD(*USGLMT)
|
|
MSGQ(*NONE) LOG(*YES)
|
|
</pre>
|
|
</p>
|
|
<p>This command allows you to change the usage limit for the product with product identifier 2MYPROD and license term Version 2. After this command is run, 50 users will be authorized to use this product. No threshold messages will be sent. (However, messages will be sent to the system operator whenever the usage limit is changed or the usage count reaches or exceeds the usage limit.) A request for a license when the usage count is equal to the usage limit will be recorded in the QLZALOG journal in QUSRSYS.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGLICINF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGLICINF.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF9E2C</b></dt>
|
|
<dd>LICTRM(*ONLY) cannot be specified.
|
|
</dd>
|
|
<dt><b>CPF9E2D</b></dt>
|
|
<dd>Usage limit cannot be less than current usage.
|
|
</dd>
|
|
<dt><b>CPF9E27</b></dt>
|
|
<dd>Usage limit cannot be changed for *KEYED compliance product.
|
|
</dd>
|
|
<dt><b>CPF9E28</b></dt>
|
|
<dd>Message queue *OPSYS not allowed for operating system.
|
|
</dd>
|
|
<dt><b>CPF9E30</b></dt>
|
|
<dd>License information not changed.
|
|
</dd>
|
|
<dt><b>CPF9E88</b></dt>
|
|
<dd>Alternate usage limit cannot be less than current usage.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGLICINF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|