375 lines
14 KiB
HTML
375 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>Install Remote Product (INSRMTPRD)</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="INSRMTPRD.Top_Of_Page"></a>
|
|
<h2>Install Remote Product (INSRMTPRD)</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="#INSRMTPRD.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#INSRMTPRD.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#INSRMTPRD.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="INSRMTPRD"></a>
|
|
<p>The Install Remote Product (INSRMTPRD) command provides the capability to install a product, packaged using the IBM System Manager for i5/OS licensed program, 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 *EXCLUDE authority.
|
|
</li>
|
|
<li>To run this command, you must have the authority necessary to use the Add Product Change Request Activity (ADDPRDCRQA) command.
|
|
</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 product and the i5/OS licensed product cannot be specified.
|
|
</li>
|
|
</ol>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#INSRMTPRD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="INSRMTPRD.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="#INSRMTPRD.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="#INSRMTPRD.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="#INSRMTPRD.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="#INSRMTPRD.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="#INSRMTPRD.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="#INSRMTPRD.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="#INSRMTPRD.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="#INSRMTPRD.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="#INSRMTPRD.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>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#INSRMTPRD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="INSRMTPRD.PRDID"></a>
|
|
<h3>Product ID (PRDID)</h3>
|
|
<p>Specifies the 7-character identifier of the product to be installed.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>product-ID</i></b></dt>
|
|
<dd>Specify the 7-character product ID that is installed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#INSRMTPRD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="INSRMTPRD.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>The release level is determined by searching the system for a product definition for the given product ID. The release level is taken from the product definition. This value is not valid if more than one product definition exists for the same product ID.
|
|
</dd>
|
|
<dt><b><i>version-release-modification</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> are the numbers 0 through 9. Valid values for <i>y</i> are the numbers 0 through 9 and the letters A through Z.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#INSRMTPRD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="INSRMTPRD.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 range from 1 through 99.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#INSRMTPRD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="INSRMTPRD.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 object associated with this product load are used.
|
|
</dd>
|
|
<dt><b>*LNG</b></dt>
|
|
<dd>The objects associated with the national language version (NLV) identified on the LODID parameter are used.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#INSRMTPRD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="INSRMTPRD.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 used.
|
|
</dd>
|
|
<dt><b><i>product-load-ID</i></b></dt>
|
|
<dd>Specify when LODTYPE(*LNG) or LODTYPE(*ALL) is specified, the load ID must be one of the valid IBM national language versions and be specified in the form 29xx, where xx is any value from zero through 9.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#INSRMTPRD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="INSRMTPRD.TGTRLS"></a>
|
|
<h3>Target release (TGTRLS)</h3>
|
|
<p>Specifies the release of the operating system on which you intend to use the object. This parameter is ignored for objects with global names that are in the SystemView distribution repository or for actions other than send or retrieve.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*CURRENT</u></b></dt>
|
|
<dd>The object is used on the release of the operating system currently running on your system. If V5R4M0 is running on your system, *CURRENT means that you intend to use the object on a system with V5R4M0 installed. The object can also be used on a system with any later release of the operating system installed.
|
|
</dd>
|
|
<dt><b>*PRV</b></dt>
|
|
<dd>The object is intended for a system that is at the previous release level compared to the local system.
|
|
<p><b>Note:</b> Modification levels are not supported. To specify the previous release with a modification level other than 0, such as V5R3M4, specify the value for the release rather than the special value *PRV.
|
|
</p>
|
|
</dd>
|
|
<dt><b><i>release-level</i></b></dt>
|
|
<dd>Specify the release level in the VxRxMx format. The object is 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="#INSRMTPRD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="INSRMTPRD.NODL"></a>
|
|
<h3>Managed systems node list (NODL)</h3>
|
|
<p>Specifies that the node list parameter is the object name that contains a list of systems which are the destinations for the activity. It cannot be specified if control point name (CPNAME) parameter is 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>Specify the name of the library to be 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 containing the list of systems on which the activity is to be performed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#INSRMTPRD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="INSRMTPRD.CPNAME"></a>
|
|
<h3>Managed system node names (CPNAME)</h3>
|
|
<p>Specifies the APPN control point names of the managed systems on which this activity is to be performed. Control point names cannot be specified if a node list is specified. If ACTION(*RTV) is used, only one control point name can be specified.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>The systems on which this activity is performed are not identified individually. A node list must be specified.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible network identifier 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.
|
|
</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="#INSRMTPRD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="INSRMTPRD.KEEPCLGE"></a>
|
|
<h3>Keep catalog entry (KEEPCLGE)</h3>
|
|
<p>Specifies if the distribution catalog entry and its associated save file corresponding to the product is kept on the specified system.
|
|
</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="#INSRMTPRD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="INSRMTPRD.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Installing a Product</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
INSRMTPRD PRDID(1ACCOUN) RLS(V5R2M0) OPTION(*BASE)
|
|
LODTYPE(*ALL) LODID(*ALL) CPNAME((*NETATR SYS1))
|
|
</pre>
|
|
</p>
|
|
<p>This command installs 1ACCOUN product with the release V5R2M0 of the base option for both the program and the language parts on the iSeries SYS1.
|
|
</p>
|
|
<p><b>Example 2: Installing an Option</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
INSRMTPRD PRDID(1CHECKS) RLS(V5R2M0) OPTION(10)
|
|
LODTYPE(*ALL) LODID(*ALL) CPNAME((*NETATR SYS2))
|
|
</pre>
|
|
</p>
|
|
<p>This command installs option 10 of the 1CHECKS product, release V5R2M0, for both the program and the language parts on the iSeries SYS2.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#INSRMTPRD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="INSRMTPRD.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p>None
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#INSRMTPRD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|