241 lines
8.6 KiB
HTML
241 lines
8.6 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>Send License (SNDLIC)</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="SNDLIC.Top_Of_Page"></a>
|
|
<h2>Send License (SNDLIC)</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="#SNDLIC.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#SNDLIC.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#SNDLIC.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="SNDLIC"></a>
|
|
<p>The Send License (SNDLIC) command provides the capability to send one or more license keys from the central site system to one or more managed systems. Only the license keys matching the system serial number will be added to the managed system license repository.
|
|
</p>
|
|
<p><b>Notes:</b>
|
|
</p>
|
|
<ol>
|
|
<li>A change request is automatically submitted which can be viewed to determine the status of this command. A message is returned identifying the name of the change request.
|
|
</li>
|
|
<li>All the existing records in the central site license repository containing the license key information for the specified product will be sent to the specified managed system or systems. Only those ones that match the system serial number are added to the managed system license repository.
|
|
</li>
|
|
</ol>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ol>
|
|
<li>This command is shipped with public authority of *EXCLUDE.
|
|
</li>
|
|
<li>If a node list (NODL) value is specified, the node list can only contain entries that have a value of *SNA for the address type.
|
|
</li>
|
|
<li>The license key information for the specified product and managed system must exist in the central site license repository.
|
|
</li>
|
|
</ol>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SNDLIC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="SNDLIC.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="#SNDLIC.PRDID"><b>PRDID</b></a></td>
|
|
<td valign="top">Product ID</td>
|
|
<td valign="top"><i>Character value</i>, *ALL</td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#SNDLIC.LICTRM"><b>LICTRM</b></a></td>
|
|
<td valign="top">License term</td>
|
|
<td valign="top"><i>Character value</i>, *ALL</td>
|
|
<td valign="top">Required, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="4"><a href="#SNDLIC.NODL"><b>NODL</b></a></td>
|
|
<td valign="top">Managed systems node list</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="4">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Node list</td>
|
|
<td valign="top">
|
|
Single values: <b><u>*NONE</u></b><br>Other values: <i>Qualified object name</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Qualifier 1: Node list</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top" style="padding-left:10pt">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top" rowspan="3"><a href="#SNDLIC.CPNAME"><b>CPNAME</b></a></td>
|
|
<td valign="top">Managed system node names</td>
|
|
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 50 repetitions): <i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Network identifier</td>
|
|
<td valign="top">
|
|
<i>Communications name</i>, <b><u>*NETATR</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Control point</td>
|
|
<td valign="top">
|
|
<i>Communications name</i></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SNDLIC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="SNDLIC.PRDID"></a>
|
|
<h3>Product ID (PRDID)</h3>
|
|
<p>Specifies the 7-character identifier of the product for which the license key information will be distributed.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>The license keys for all the products existing in the central site license repository will be distributed.
|
|
</dd>
|
|
<dt><b><i>product-ID</i></b></dt>
|
|
<dd>Specifies the 7-character identifier of the product for which the license key information will be distributed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SNDLIC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SNDLIC.LICTRM"></a>
|
|
<h3>License term (LICTRM)</h3>
|
|
<p>Specifies the license term for which the licenses key information will be sent.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>The product licenses for all license term found will be sent.
|
|
</dd>
|
|
<dt><b><i>license-term</i></b></dt>
|
|
<dd>Specify the license term in one of the following formats:
|
|
<dl>
|
|
<dt><b>Vx</b></dt>
|
|
<dd>The authorized usage limit is valid for the entire version of the product or feature.
|
|
</dd>
|
|
<dt><b>VxRy</b></dt>
|
|
<dd>The authorized usage limit is valid for the entire release of the product or feature.
|
|
</dd>
|
|
<dt><b>VxRyMz</b></dt>
|
|
<dd>The authorized usage limit is valid only for a modification of the product.
|
|
</dd>
|
|
</dl>
|
|
<p>where x and y can be a number from 0 through 9, and z can be a number 0 through 9 or a letter A through Z.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SNDLIC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SNDLIC.NODL"></a>
|
|
<h3>Managed systems node list (NODL)</h3>
|
|
<p>Node list object name that contains a list of systems which are the destinations for the request. Cannot be specified if control point names (CPNAME parameter) are also specified.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>The systems on which this activity is to be performed are not identified by a node list. Individual control point names must be specified.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible library values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b>*LIBL</b></dt>
|
|
<dd>All of the libraries in the user and system portions of the job's library list are searched for the node list object.
|
|
</dd>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is used to locate the node list object.
|
|
</dd>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>Only the library named in this keyword is searched.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible value for the node list name is:
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>node-list-name</i></b></dt>
|
|
<dd>Node list object name which contains the list of systems on which the command is to be performed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SNDLIC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SNDLIC.CPNAME"></a>
|
|
<h3>Managed system node names (CPNAME)</h3>
|
|
<p>The APPN control point names of the managed systems on which this activity is to be performed. Control point names cannot be specified if the node list (NODL) parameter is specified.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>The systems on which this activity is to be performed are not identified individually. A node list must be specified.
|
|
</dd>
|
|
<dt><b>*NETATR</b></dt>
|
|
<dd>The network ID of the local system will be used. This useful when the node being specified is in the same network as the local system.
|
|
</dd>
|
|
<dt><b><i>network-identifier</i></b></dt>
|
|
<dd>The APPN network identifier of the managed system on which the activity is to be performed, it is a character field of length 8.
|
|
</dd>
|
|
<dt><b><i>control-point-name</i></b></dt>
|
|
<dd>The APPN control point name of the managed system on which the activity is to be performed, it is a character field of length 8.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SNDLIC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="SNDLIC.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
SNDLIC PRDID(1ACCOUN) LICTRM(V4) CPNAME((*NETATR SYS1))
|
|
</pre>
|
|
</p>
|
|
<p>Send the licenses for 1ACCOUN product with license term V4, and add the licenses matching the system serial number to the repository of system SYS1.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SNDLIC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="SNDLIC.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p>None
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SNDLIC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|