306 lines
12 KiB
HTML
306 lines
12 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>Remove License Key Information (RMVLICKEY)</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="RMVLICKEY.Top_Of_Page"></a>
|
|
<h2>Remove License Key Information (RMVLICKEY)</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="#RMVLICKEY.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#RMVLICKEY.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#RMVLICKEY.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="RMVLICKEY"></a>
|
|
<p>The Remove License Key Information (RMVLICKEY) command can be used to remove software license key information from the license repository for products with keyed compliance. Products with "keyed compliance" require that you have a software license key from the software provider in order to change the usage limit or the expiration date of the license information.
|
|
</p>
|
|
<p>Removing license information from the repository does not affect installed licenses. Any license that is currently being used to access the product on this system remains valid and usable.
|
|
</p>
|
|
<p><b>Restrictions:</b> This command is shipped with public *EXCLUDE authority.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVLICKEY.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="RMVLICKEY.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="#RMVLICKEY.LICKEYINP"><b>LICKEYINP</b></a></td>
|
|
<td valign="top">License key input</td>
|
|
<td valign="top"><b><u>*LICKEYFILE</u></b>, *PROMPT</td>
|
|
<td valign="top">Optional, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RMVLICKEY.PRDID"><b>PRDID</b></a></td>
|
|
<td valign="top">Product identifier</td>
|
|
<td valign="top"><i>Character value</i>, *ALL</td>
|
|
<td valign="top">Optional, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RMVLICKEY.LICTRM"><b>LICTRM</b></a></td>
|
|
<td valign="top">License term</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*ALL</u></b></td>
|
|
<td valign="top">Optional, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RMVLICKEY.FEATURE"><b>FEATURE</b></a></td>
|
|
<td valign="top">Feature</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*ALL</u></b></td>
|
|
<td valign="top">Optional, Positional 4</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RMVLICKEY.SERIAL"><b>SERIAL</b></a></td>
|
|
<td valign="top">System serial number</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*LOCAL</u></b>, *REMOTE, *ALL</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#RMVLICKEY.LICKEYFILE"><b>LICKEYFILE</b></a></td>
|
|
<td valign="top">License key file</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: License key file</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="#RMVLICKEY.LICKEYMBR"><b>LICKEYMBR</b></a></td>
|
|
<td valign="top">License key member</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*FIRST</u></b>, *LAST</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVLICKEY.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="RMVLICKEY.LICKEYINP"></a>
|
|
<h3>License key input (LICKEYINP)</h3>
|
|
<p>Specifies how the software license key information to be removed is supplied.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LICKEYFILE</u></b></dt>
|
|
<dd>The software license key information is taken from the file specified on the LICKEYFILE parameter.
|
|
</dd>
|
|
<dt><b>*PROMPT</b></dt>
|
|
<dd>The software license key information is supplied through prompting.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVLICKEY.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RMVLICKEY.PRDID"></a>
|
|
<h3>Product identifier (PRDID)</h3>
|
|
<p>Specifies the seven-character identifier of the product for which software license key information is removed.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>The software license key information for all product identifiers is removed.
|
|
</dd>
|
|
<dt><b><i>generic*-product-identifier</i></b></dt>
|
|
<dd>Specify the generic identifier of the products to be removed. A generic product identifier is specified in the same manner as a generic name.
|
|
<p>A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. The asterisk substitutes for any valid characters. A generic name specifies all objects with names that begin with the generic prefix for which the user has authority. If an asterisk is not included with the generic (prefix) name, the system assumes it to be the complete object name.
|
|
</p>
|
|
</dd>
|
|
<dt><b><i>product-identifier</i></b></dt>
|
|
<dd>Specify the seven-character identifier of the product.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVLICKEY.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RMVLICKEY.LICTRM"></a>
|
|
<h3>License term (LICTRM)</h3>
|
|
<p>Specifies the license term for which software license key information is removed.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>The software license key information for all license terms found on the system are removed.
|
|
</dd>
|
|
<dt><b><i>license-term</i></b></dt>
|
|
<dd>Specify the license term in Vx, VxRy, or VxRyMz format, where x or y can be a number from 0 through 9, and z can be a number 0 through 9 or a letter A through Z.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVLICKEY.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RMVLICKEY.FEATURE"></a>
|
|
<h3>Feature (FEATURE)</h3>
|
|
<p>Specifies the feature of the product specified on the PRDID parameter for which the software license key information is removed.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>The software license key information for all features of the product is removed.
|
|
</dd>
|
|
<dt><b><i>feature</i></b></dt>
|
|
<dd>Specify the number of the feature for which software license key information is removed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVLICKEY.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RMVLICKEY.SERIAL"></a>
|
|
<h3>System serial number (SERIAL)</h3>
|
|
<p>Specify the serial number of the system for which software license key information is removed.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LOCAL</u></b></dt>
|
|
<dd>The software license key information for the local system is removed.
|
|
</dd>
|
|
<dt><b>*REMOTE</b></dt>
|
|
<dd>The software license key information to be removed is for remote systems only and depends on the value specified for the <b>License key input (LICKEYINP)</b> parameter.
|
|
<ul>
|
|
<li>If LICKEYINP(*PROMPT) is specified, the software license key information for all remote systems is removed.
|
|
</li>
|
|
<li>If LICKEYINP(*LICKEYFILE) is specified, the software license key information for the remote systems named in the file specified on the LICKEYFILE parameter is removed.
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>The software license key information to be removed is for all systems and depends on the value specified for the LICKEYINP parameter.
|
|
<ul>
|
|
<li>If LICKEYINP(*PROMPT) is specified, the software license key information for all systems is removed.
|
|
</li>
|
|
<li>If LICKEYINP(*LICKEYFILE) is specified, the software license key information for all the remote systems named in the file specified on the LICKEYFILE parameter is removed.
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
<dt><b><i>system-serial-number</i></b></dt>
|
|
<dd>Specify the serial number of the system for which software license key information is removed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVLICKEY.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RMVLICKEY.LICKEYFILE"></a>
|
|
<h3>License key file (LICKEYFILE)</h3>
|
|
<p>Specifies the qualified name of the file in which the software license key information to be removed is located. This input file must be in the format of QSYS/QALZAKEY, and can be created by using the LICKEYFILE parameter on the Display License Key Information (DSPLICKEY) command.
|
|
</p>
|
|
<p>The name of the license key file 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>
|
|
<p>The possible value is:
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>license-key-file</i></b></dt>
|
|
<dd>Specify the name of the file that contains the software license key information.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVLICKEY.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RMVLICKEY.LICKEYMBR"></a>
|
|
<h3>License key member (LICKEYMBR)</h3>
|
|
<p>Specifies the name of the member in which the software license key information to be removed is located. This member is in the file specified on the LICKEYFILE parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*FIRST</u></b></dt>
|
|
<dd>The oldest member in the file is used.
|
|
</dd>
|
|
<dt><b>*LAST</b></dt>
|
|
<dd>The newest member in the file is used.
|
|
</dd>
|
|
<dt><b><i>license-key-member</i></b></dt>
|
|
<dd>Specify the name of the member that contains the software license key information.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVLICKEY.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="RMVLICKEY.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Removing License Key Information from Prompt Input</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RMVLICKEY LICKEYINP(*PROMPT) PRDID(1MYPROD)
|
|
LICTRM(V3) FEATURE(5001)
|
|
SERIAL(1234567)
|
|
</pre>
|
|
</p>
|
|
<p>This command removes from the license repository the software license key information for the product 1MYPROD, the license term V3, and the feature 5001 for the system with serial number 1234567.
|
|
</p>
|
|
<p><b>Example 2: Removing License Key Information from File Input</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RMVLICKEY LICKEYINP(*LICKEYFILE) SERIAL(*REMOTE)
|
|
LICKEYFILE(*LIBL/MYKEYFILE) LICKEYMBR(*LAST)
|
|
</pre>
|
|
</p>
|
|
<p>This command removes from the license repository the software license key information for all the remote systems found in the newest created member of the file MYKEYFILE.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVLICKEY.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="RMVLICKEY.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF9E55</b></dt>
|
|
<dd>License Repository object damaged.
|
|
</dd>
|
|
<dt><b>CPF9E57</b></dt>
|
|
<dd>&1 license key information records removed, &2 not removed.
|
|
</dd>
|
|
<dt><b>CPF9E58</b></dt>
|
|
<dd>License key information not found.
|
|
</dd>
|
|
<dt><b>CPF9E69</b></dt>
|
|
<dd>License key information not found in license key file.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVLICKEY.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|