ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/sndprd.htm

461 lines
16 KiB
HTML
Raw Permalink Normal View History

2024-04-02 14:02:31 +00:00
<!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 Product (SNDPRD)</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="SNDPRD.Top_Of_Page"></a>
<h2>Send Product (SNDPRD)</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="#SNDPRD.PARAMETERS.TABLE">Parameters</a><br>
<a href="#SNDPRD.COMMAND.EXAMPLES">Examples</a><br>
<a href="#SNDPRD.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="SNDPRD"></a>
<p>The Send Product (SNDPRD) command provides the capability to send a product, packaged with the iSeries product packaging support, from the central site system to one or more managed systems.
</p>
<p><b>Note:</b>
</p>
<p>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.
</p>
<p><b>Restrictions:</b>
</p>
<ol>
<li>This command is shipped with public authority of *EXCLUDE.
</li>
<li>Because this command calls the PKGPRDDST and ADDPRDCRQA commands, you must be authorized to use these commands. You must have *ALL authority to folders.
</li>
<li>If a NODL value is specified, the node list can only contain entries that have a value of *SNA for the address type.
</li>
<li>The Managed System Services licensed program and the i5/OS product cannot be specified.
</li>
</ol>
<p><b>Notes:</b>
</p>
<ol>
<li>This command packages the product for distribution if it is not already packaged.
</li>
<li>If the product was packaged for distribution before but the PKGPRDDST(*REPLACE) parameter was specified, this command packages the product for distribution again. It replaces the previous packaged product.
</li>
<li>When it is requested to send the license key of the product, a record with the license key information must exist in the central site license repository by the time this activity runs.
</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, but only those that match the system serial number are added to the managed system license repository.
</li>
</ol>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDPRD.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="SNDPRD.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="#SNDPRD.PRDID"><b>PRDID</b></a></td>
<td valign="top">Product ID</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#SNDPRD.RLS"><b>RLS</b></a></td>
<td valign="top">Release level</td>
<td valign="top"><i>Character value</i>, <b><u>*ONLY</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDPRD.OPTION"><b>OPTION</b></a></td>
<td valign="top">Product option</td>
<td valign="top">1-99, <b><u>*BASE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDPRD.LODTYPE"><b>LODTYPE</b></a></td>
<td valign="top">Product load type</td>
<td valign="top"><b><u>*ALL</u></b>, *CODE, *LNG</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDPRD.LODID"><b>LODID</b></a></td>
<td valign="top">Load ID</td>
<td valign="top">2900-2999, <b><u>*ALL</u></b>, *CODE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDPRD.TGTRLS"><b>TGTRLS</b></a></td>
<td valign="top">Target release</td>
<td valign="top"><b><u>*CURRENT</u></b>, *PRV, V5R2M0, V5R3M0, V5R4M0</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="4"><a href="#SNDPRD.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="#SNDPRD.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>
<tr>
<td valign="top"><a href="#SNDPRD.INSTALL"><b>INSTALL</b></a></td>
<td valign="top">Install</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDPRD.KEEPCLGE"><b>KEEPCLGE</b></a></td>
<td valign="top">Keep catalog entry</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDPRD.SNDLICKEY"><b>SNDLICKEY</b></a></td>
<td valign="top">Send license key</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDPRD.PKGPRDDST"><b>PKGPRDDST</b></a></td>
<td valign="top">Package product</td>
<td valign="top"><b><u>*NOREPLACE</u></b>, *REPLACE</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#SNDPRD.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="SNDPRD.PRDID"></a>
<h3>Product ID (PRDID)</h3>
<p>Specifies the 7-character identifier of the product to be sent.
</p>
<p>The possible value is:
</p>
<dl>
<dt><b><i>product-ID</i></b></dt>
<dd>Specify the 7-character product ID that is used in the activity.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDPRD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDPRD.RLS"></a>
<h3>Release level (RLS)</h3>
<p>Specifies which version, release, and modification level of the product is used.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*ONLY</u></b></dt>
<dd>Only one version, release, and modification level is used for the product option.
</dd>
<dt><b><i>release-level</i></b></dt>
<dd>Specify the release level in the format VxRxMy, where Vx is the version number, and My is the modification number. Valid values for <i>x</i> range from 0 through 9. Valid values for <i>y</i> range from 0 through 9 and the letters A through Z.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDPRD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDPRD.OPTION"></a>
<h3>Product option (OPTION)</h3>
<p>Specifies which of the optional parts of the product given in the PRDID parameter are used.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*BASE</u></b></dt>
<dd>Only the base part of the product is used.
</dd>
<dt><b><i>product-option-number</i></b></dt>
<dd>Specify the option number for the product load being saved. Valid values are from 1 through 99.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDPRD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDPRD.LODTYPE"></a>
<h3>Product load type (LODTYPE)</h3>
<p>Specifies the product load objects being used.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>Code and language objects specified on the LODID parameter are used.
</dd>
<dt><b>*CODE</b></dt>
<dd>The program objects associated with this product load are used.
</dd>
<dt><b>*LNG</b></dt>
<dd>The objects associated with the NLV identified on the LODID parameter are used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDPRD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDPRD.LODID"></a>
<h3>Load ID (LODID)</h3>
<p>Specifies the load identifier used.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All languages for this product option are saved.
</dd>
<dt><b>*CODE</b></dt>
<dd>The code load is to be used.
</dd>
<dt><b><i>product-load-ID</i></b></dt>
<dd>Specify the load ID of the product when LODTYPE(*LNG) or LODTYPE(*ALL) is used. The load ID must be one of the valid IBM national language versions and be specified in the form 29xx. The value of x can be from 0 through 9.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDPRD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDPRD.TGTRLS"></a>
<h3>Target release (TGTRLS)</h3>
<p>Specifies the release of the operating system on which you intend to use the product.
</p>
<dl>
<dt><b><u>*CURRENT</u></b></dt>
<dd>The product is used on the release of the operating system currently running on your system.
</dd>
<dt><b>*PRV</b></dt>
<dd>The product is to be used on the previous release.
</dd>
<dt><b><i>release-level</i></b></dt>
<dd>Specify the release level in the VxRxMx format. The product can be used on a system with the specified release or with any later release of the operating system installed.
<p>Valid values depend on the current version, release, and modification level, and they change with each new release.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDPRD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDPRD.NODL"></a>
<h3>Managed systems node list (NODL)</h3>
<p>Specify the node list object name that contains a list of systems which are the destinations for the request. Node list name cannot be specified if a value is specified for the control point name (CPNAME) parameter.
</p>
<p>The possible value is:
</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>Specify that only the library named in this parameter is searched.
</dd>
</dl>
<p>The possible node list name value is:
</p>
<dl>
<dt><b><i>node-list-name</i></b></dt>
<dd>Specify the 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="#SNDPRD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDPRD.CPNAME"></a>
<h3>Managed system node names (CPNAME)</h3>
<p>Specifies the APPN control point names of the managed systems on which this request is to be performed. Control point names cannot be specified if a node list is specified.
</p>
<p>The possible value is:
</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>
</dl>
<p>The possible values are:
</p>
<dl>
<dt><b>*NETATR</b></dt>
<dd>The network ID of the local system is used. This is 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>Specify the APPN network identifier of the managed system on which the activity is to be performed. It is an 8-character field.
</dd>
</dl>
<p>The possible control point name value is:
</p>
<dl>
<dt><b><i>control-point-name</i></b></dt>
<dd>Specify the APPN control point name of the managed system on which the activity is to be performed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDPRD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDPRD.INSTALL"></a>
<h3>Install (INSTALL)</h3>
<p>Specifies that the product is installed on the managed system when it arrives.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>The product is not installed.
</dd>
<dt><b>*YES</b></dt>
<dd>The product is installed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDPRD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDPRD.KEEPCLGE"></a>
<h3>Keep catalog entry (KEEPCLGE)</h3>
<p>Specifies if the catalog entry and associated save file corresponding to the product is kept on the specified system or systems. This is only valid if INSTALL(*YES) was specified.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>The catalog entry and associated save file are not kept.
</dd>
<dt><b>*YES</b></dt>
<dd>The catalog entry and associated save file are kept.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDPRD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDPRD.SNDLICKEY"></a>
<h3>Send license key (SNDLICKEY)</h3>
<p>Specifies if the license key is to be sent with the product.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*YES</u></b></dt>
<dd>The license key is sent with the product.
</dd>
<dt><b>*NO</b></dt>
<dd>The license key is not sent with the product.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDPRD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDPRD.PKGPRDDST"></a>
<h3>Package product (PKGPRDDST)</h3>
<p>Specifies that the product is packaged for distribution before it is sent. This parameter specifies whether to replace the packaged product if it already exists in the distribution repository.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*NOREPLACE</u></b></dt>
<dd>Specify that the existing packaged product is not replaced.
</dd>
<dt><b>*REPLACE</b></dt>
<dd>Specify that the existing packaged product is replaced.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDPRD.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="SNDPRD.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Sending a Product</b>
</p>
<p>
<pre>
SNDPRD PRDID(1ACCOUN) RLS(V5R2M0) OPTION(*BASE)
LODTYPE(*ALL) LODID(*ALL) CPNAME((*NETATR SYS1))
INSTALL(*YES) SNDLICKEY(*YES)
</pre>
</p>
<p>This command sends the 1ACCOUN product base option release V5R2M0 for both the program and the language parts, and install it on the iSeries server SYS1. The license key for this product is also sent and is added to the managed system license repository.
</p>
<p><b>Example 2: Sending but Not Installing an Option</b>
</p>
<p>
<pre>
SNDPRD PRDID(1CHECKS) RLS(V5R2M0) OPTION(0010)
LODTYPE(*ALL) LODID(*ALL)
CPNAME((*NETATR SYS2)) SNDLICKEY(*YES)
</pre>
</p>
<p>This command sends both the program and the language parts of the 1CHECKS product option 10, release V5R2M0, but does not install the product on the iSeries server SYS2. The license key for this product is also sent and is added to the managed system license repository.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDPRD.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="SNDPRD.ERROR.MESSAGES">Error messages</a> </h3>
<p>None
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDPRD.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>