880 lines
32 KiB
HTML
880 lines
32 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>Add Product CRQ Activity (ADDPRDCRQA)</title>
|
|
</head>
|
|
<body bgcolor="white">
|
|
<a name="ADDPRDCRQA.Top_Of_Page"></a>
|
|
<h2>Add Product CRQ Activity (ADDPRDCRQA)</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="#ADDPRDCRQA.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#ADDPRDCRQA.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#ADDPRDCRQA.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="ADDPRDCRQA"></a>
|
|
<p>The Add Product Change Request Activity (ADDPRDCRQA) command adds an activity to a change request description which performs a product distribution function. The activity can be conditioned so that it runs after one or more other activities have completed (successfully or unsuccessfully). The activity can also be scheduled to run at a future date and time.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ol>
|
|
<li>This command is shipped with public *EXCLUDE authority.
|
|
</li>
|
|
<li>You must have *CHANGE authority to the change request description object and *EXECUTE authority to the library.
|
|
</li>
|
|
<li>The product must have been previously packaged for distribution. You can use the Package Product for Distribution (PKGPRDDST) command to package the product.
|
|
</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>
|
|
</ol>
|
|
<p><b>Notes:</b>
|
|
</p>
|
|
<p>The following notes provide information on how the command works.
|
|
</p>
|
|
<ol>
|
|
<li>Authorization to the product specified on the activity is not verified until the activity runs.
|
|
</li>
|
|
<li>All conditions must be satisfied before the activity can be performed.
|
|
</li>
|
|
<li>The start times indicate when the activity can be started. Actual start times can be later due to network and system delays.
|
|
</li>
|
|
<li>Action *DLTCLGE only deletes the save file containing the licensed program and deletes the distribution catalog entry that maps this save file. It does not delete the product.
|
|
</li>
|
|
<li>If TGTRLS(*ONLY) is specified, the action parameter must be a value other than *INS.
|
|
</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 is 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="#ADDPRDCRQA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="ADDPRDCRQA.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" rowspan="3"><a href="#ADDPRDCRQA.CRQD"><b>CRQD</b></a></td>
|
|
<td valign="top">Change request description</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Change request description</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="#ADDPRDCRQA.ACTIVITY"><b>ACTIVITY</b></a></td>
|
|
<td valign="top">Activity</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*GEN</u></b>, *LAST</td>
|
|
<td valign="top">Optional, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDPRDCRQA.ACTION"><b>ACTION</b></a></td>
|
|
<td valign="top">Action</td>
|
|
<td valign="top">*SND, *RTV, *DLTCLGE, *INS, *SNDINS</td>
|
|
<td valign="top">Optional, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDPRDCRQA.PRDID"><b>PRDID</b></a></td>
|
|
<td valign="top">Product ID</td>
|
|
<td valign="top"><i>Character value</i></td>
|
|
<td valign="top">Optional, Positional 4</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDPRDCRQA.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="#ADDPRDCRQA.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="#ADDPRDCRQA.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="#ADDPRDCRQA.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="#ADDPRDCRQA.TGTRLS"><b>TGTRLS</b></a></td>
|
|
<td valign="top">Target release</td>
|
|
<td valign="top"><b><u>*CURRENT</u></b>, *PRV, V5R2M0, V5R3M0, V5R4M0, *ONLY</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="4"><a href="#ADDPRDCRQA.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="#ADDPRDCRQA.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="#ADDPRDCRQA.KEEPCLGE"><b>KEEPCLGE</b></a></td>
|
|
<td valign="top">Keep catalog entry</td>
|
|
<td valign="top">*YES, <b><u>*NO</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDPRDCRQA.SNDLICKEY"><b>SNDLICKEY</b></a></td>
|
|
<td valign="top">Send license key</td>
|
|
<td valign="top">*YES, <b><u>*NO</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="5"><a href="#ADDPRDCRQA.RMTSTRTIME"><b>RMTSTRTIME</b></a></td>
|
|
<td valign="top">Start time on managed system</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="5">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Time zone</td>
|
|
<td valign="top">
|
|
<b><u>*LCLSYS</u></b>, *MGDSYS</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Start after</td>
|
|
<td valign="top">
|
|
<i>Element list</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 1: Time</td>
|
|
<td valign="top">
|
|
<i>Time</i>, <b><u>*CURRENT</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 2: Date</td>
|
|
<td valign="top">
|
|
<i>Date</i>, <b><u>*CURRENT</u></b>, *NEXT</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDPRDCRQA.TEXT"><b>TEXT</b></a></td>
|
|
<td valign="top">Text 'description'</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*GEN</u></b>, *BLANK</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="5"><a href="#ADDPRDCRQA.COND"><b>COND</b></a></td>
|
|
<td valign="top">Activity conditions</td>
|
|
<td valign="top">Single values: *NONE<br>Other values (up to 5 repetitions): <i>Element list</i></td>
|
|
<td valign="top" rowspan="5">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Activity</td>
|
|
<td valign="top">
|
|
<i>Generic name, name</i>, <b><u>*PRV</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Relational operator</td>
|
|
<td valign="top">
|
|
<b><u>*EQ</u></b>, *GT, *LT, *LE, *NE, *GE</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 3: End code</td>
|
|
<td valign="top">
|
|
0-99, <b><u>*SUCCESS</u></b>, *FAIL, *NOTRUN, *ANY</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 4: Condition mode</td>
|
|
<td valign="top">
|
|
<b><u>*ALLNODES</u></b>, *SAMENODE</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="7"><a href="#ADDPRDCRQA.STRTIME"><b>STRTIME</b></a></td>
|
|
<td valign="top">Activity start time</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="7">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Start after</td>
|
|
<td valign="top">
|
|
<i>Element list</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 1: Time</td>
|
|
<td valign="top">
|
|
<i>Time</i>, <b><u>*CURRENT</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 2: Date</td>
|
|
<td valign="top">
|
|
<i>Date</i>, <b><u>*CURRENT</u></b>, *NEXT</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Start before</td>
|
|
<td valign="top">
|
|
<i>Element list</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 1: Time</td>
|
|
<td valign="top">
|
|
<i>Time</i>, <b><u>*ANY</u></b>, *CURRENT</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 2: Date</td>
|
|
<td valign="top">
|
|
<i>Date</i>, <b><u>*ANY</u></b>, *CURRENT, *NEXT</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDPRDCRQA.HOLD"><b>HOLD</b></a></td>
|
|
<td valign="top">Hold activity</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="#ADDPRDCRQA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="ADDPRDCRQA.CRQD"></a>
|
|
<h3>Change request description (CRQD)</h3>
|
|
<p>Specifies the change request description object name.
|
|
</p>
|
|
<p>The possible library values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All of the libraries in the user and system portions of the job's library list are searched.
|
|
</dd>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is used to locate the object.
|
|
</dd>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>Specify that only the library named in this parameter is searched.
|
|
</dd>
|
|
<dt><b><i>change-request-description</i></b></dt>
|
|
<dd>Specify the name of the change request description object.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDPRDCRQA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDPRDCRQA.ACTIVITY"></a>
|
|
<h3>Activity (ACTIVITY)</h3>
|
|
<p>Specifies the name of the activity to add to the change request description.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*GEN</u></b></dt>
|
|
<dd>An activity name is generated. The activity name is of the form QACTxxxxxx where xxxxxx is the first multiple of ten not already being used.
|
|
</dd>
|
|
<dt><b>*LAST</b></dt>
|
|
<dd>The activity is the last to run in the change request. When *LAST is specified for the activity (ACTIVITY) parameter, the condition (COND) parameter and the start time (STRTIME) parameter cannot be specified. Only one activity named *LAST can exist in the change request description.
|
|
</dd>
|
|
<dt><b><i>activity-name</i></b></dt>
|
|
<dd>Specify a 10-character activity name.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDPRDCRQA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDPRDCRQA.ACTION"></a>
|
|
<h3>Action (ACTION)</h3>
|
|
<p>Specifies the product distribution function that is to be performed.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*SND</b></dt>
|
|
<dd>Send the product to the specified managed systems.
|
|
</dd>
|
|
<dt><b>*RTV</b></dt>
|
|
<dd>Retrieve the product from the specified managed system.
|
|
</dd>
|
|
<dt><b>*DLTCLGE</b></dt>
|
|
<dd>Delete the catalog entry and its associated save file which contains the product packaged for distribution from the specified managed systems.
|
|
</dd>
|
|
<dt><b>*INS</b></dt>
|
|
<dd>Install the product on the specified managed systems.
|
|
</dd>
|
|
<dt><b>*SNDINS</b></dt>
|
|
<dd>Send and install the specified product on the specified managed systems.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDPRDCRQA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDPRDCRQA.PRDID"></a>
|
|
<h3>Product ID (PRDID)</h3>
|
|
<p>Specifies the 7-character identifier of the product for which the action is performed.
|
|
</p>
|
|
<p>The possible product ID 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="#ADDPRDCRQA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDPRDCRQA.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 of the product that is installed on your system.
|
|
</dd>
|
|
<dt><b><i>release-level</i></b></dt>
|
|
<dd>Specify the release level in the format VxRxMy, where Vx is the version number, Rx is the release number, and My is the modification number. Valid values for x are the numbers 0 through 9. Valid values for y range from the numbers 0 through 9 and the letters A through Z.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDPRDCRQA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDPRDCRQA.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 used. Valid values range from 1 through 99.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDPRDCRQA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDPRDCRQA.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 national language version (NLV) identified on the LODID parameter are used.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDPRDCRQA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDPRDCRQA.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 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 0 through 9.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDPRDCRQA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDPRDCRQA.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>*ONLY</u></b></dt>
|
|
<dd>The release is determined by the release of the existing product. This value is not valid if more than one release exists for the same product.
|
|
</dd>
|
|
<dt><b>*CURRENT</b></dt>
|
|
<dd>The product is to be 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 with modification level 0 of the operating system.
|
|
</dd>
|
|
<dt><b><i>release-level</i></b></dt>
|
|
<dd>Specify the release level in the format VxRxMx. The product can be used on a system with the specified release or with any later release of the operating system installed. Valid values depend on the current version, release, and modification level, and can change with each new release.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDPRDCRQA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDPRDCRQA.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. This parameter cannot be specified if the control point (CPNAME) parameter or ACTION(*RTV) is 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 specified 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>
|
|
<dt><b><i>node-list-name</i></b></dt>
|
|
<dd>Specify the node list object name containing the list of systems on which the command is to be performed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDPRDCRQA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDPRDCRQA.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 to be performed are not identified individually. A node list must be specified.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible network identifier value is:
|
|
</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="#ADDPRDCRQA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDPRDCRQA.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 systems. This is only valid if ACTION(*INS) or ACTION(*SNDINS) is 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="#ADDPRDCRQA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDPRDCRQA.SNDLICKEY"></a>
|
|
<h3>Send license key (SNDLICKEY)</h3>
|
|
<p>Specifies if the license key is to be sent with the product.
|
|
</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="#ADDPRDCRQA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDPRDCRQA.RMTSTRTIME"></a>
|
|
<h3>Start time on managed system (RMTSTRTIME)</h3>
|
|
<p>Specifies the date and time after which the activity can begin running on the managed system. The current date and time values and next date values are determined when the activity begins running on the central site system and are based on the central site date and time.
|
|
</p>
|
|
<p>The possible time zone values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LCLSYS</u></b></dt>
|
|
<dd>The remote start time is specified in the time zone of the central site system.
|
|
</dd>
|
|
<dt><b>*MGDSYS</b></dt>
|
|
<dd>The remote start time is specified in the time zone of the managed system.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible start after time values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*CURRENT</u></b></dt>
|
|
<dd>This function can start on the managed system at any time on or after the time this activity is started on the central site system on the date specified in element 2.
|
|
</dd>
|
|
<dt><b>start-after-time</b></dt>
|
|
<dd>Specify the time after which this function can start on the managed system. The time can be entered as 4 or 6 digits (hhmm or hhmmss) where hh = hours, mm = minutes, and ss = seconds. Seconds are optional. The time can be specified with or without a time separator. With a time separator, specify a string of 5 or 8 digits (hh:mm or hh:mm:ss).
|
|
</dd>
|
|
</dl>
|
|
<p>The possible start after date values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*CURRENT</u></b></dt>
|
|
<dd>This function starts on the managed system on any date on or after the activity starts on the central site system.
|
|
</dd>
|
|
<dt><b>*NEXT</b></dt>
|
|
<dd>This function starts on the managed system on any date after the activity starts on the central site.
|
|
</dd>
|
|
<dt><b><i>start-after-date</i></b></dt>
|
|
<dd>Specify the date after the functions may start on the managed system. The date must be specified in the job date format.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Notes:</b>
|
|
</p>
|
|
<ol>
|
|
<li>The special values *CURRENT and *NEXT are specified for the date and time if the time zone value *MGDSYS is specified.
|
|
</li>
|
|
<li>This parameter can only be specified if *INS or *SNDINS actions are specified.
|
|
</li>
|
|
</ol>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDPRDCRQA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDPRDCRQA.TEXT"></a>
|
|
<h3>Text 'description' (TEXT)</h3>
|
|
<p>Specifies an activity description.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*GEN</u></b></dt>
|
|
<dd>A text description is generated based on the action chosen.
|
|
</dd>
|
|
<dt><b><i>text-description</i></b></dt>
|
|
<dd>Specify a 50 character description of the activity.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDPRDCRQA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDPRDCRQA.COND"></a>
|
|
<h3>Activity conditions (COND)</h3>
|
|
<p>Specifies which conditions must be met before this activity can be performed. Each condition identifies an activity which must run before this activity and the value the end code from that activity must have to allow this activity to run. The default condition is that the previous activity (in alphabetical order) must complete successfully before this activity can be run.
|
|
</p>
|
|
<p>The possible single value is:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>There are no conditions for this activity.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible conditioning activity values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*PRV</u></b></dt>
|
|
<dd>This activity is conditioned on the previous activity. Activities are ordered alphabetically by activity name. If the activity being added is the first activity, a previous activity does not exist and any condition with *PRV is marked as having been met.
|
|
</dd>
|
|
<dt><b><i>conditioning-activity-name</i></b></dt>
|
|
<dd>Specify the name of the activity which must run before this activity.
|
|
</dd>
|
|
<dt><b><i>generic*-activity-name</i></b></dt>
|
|
<dd>Specify the generic name of the activities which must run before this activity.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible relational operator values are:
|
|
</p>
|
|
<p>This element is the relational operator to use when comparing the end code from the conditioning activity.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*EQ</u></b></dt>
|
|
<dd>Equal
|
|
</dd>
|
|
<dt><b>*GT</b></dt>
|
|
<dd>Greater than
|
|
</dd>
|
|
<dt><b>*LT</b></dt>
|
|
<dd>Less than
|
|
</dd>
|
|
<dt><b>*NE</b></dt>
|
|
<dd>Not equal
|
|
</dd>
|
|
<dt><b>*GE</b></dt>
|
|
<dd>Greater than or equal
|
|
</dd>
|
|
<dt><b>*LE</b></dt>
|
|
<dd>Less than or equal
|
|
</dd>
|
|
</dl>
|
|
<p>The possible condition code values are:
|
|
</p>
|
|
<p>This element is the value compared to the actual end code of the conditioning activity.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SUCCESS</u></b></dt>
|
|
<dd>The activity ended successfully (0 <= end code <= 9). This end code can only be specified with relational operator *EQ or *NE.
|
|
</dd>
|
|
<dt><b>*FAIL</b></dt>
|
|
<dd>The activity failed (10 <= end code <= 89). This end code can only be specified with relational operator *EQ or *NE.
|
|
</dd>
|
|
<dt><b>*NOTRUN</b></dt>
|
|
<dd>The activity never started (90 <= end code <= 99). This end code can only be specified with relational operator *EQ or *NE.
|
|
</dd>
|
|
<dt><b>*ANY</b></dt>
|
|
<dd>The activity ended with any end code. This end code can only be specified with relational operator *EQ.
|
|
</dd>
|
|
<dt><b><i>end-code</i></b></dt>
|
|
<dd>Specify an integer value (0-99) that indicates the result of an activity (success or failure). The end code ranges and descriptions are:
|
|
<dl>
|
|
<dt><b>00</b></dt>
|
|
<dd>Activity completed successfully.
|
|
</dd>
|
|
<dt><b>01-09</b></dt>
|
|
<dd>Activity completed with warning messages.
|
|
</dd>
|
|
<dt><b>10-29</b></dt>
|
|
<dd>Activity did not complete successfully.
|
|
</dd>
|
|
<dt><b>30-39</b></dt>
|
|
<dd>Activity was canceled by a user before it completed.
|
|
<ul>
|
|
<li>30 = Activity ended with *CNTRLD option
|
|
</li>
|
|
<li>35 = Activity ended with *IMMED option
|
|
</li>
|
|
<li>39 = Activity ended with *FRCFAIL option
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
<dt><b>40-49</b></dt>
|
|
<dd>Activity was not run due to errors detected by the application.
|
|
<ul>
|
|
<li>40 = Activity not run for security reasons
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
<dt><b>90-99</b></dt>
|
|
<dd>Activity was not run because conditions or schedules were not met.
|
|
<ul>
|
|
<li>95 = Scheduled start time expired
|
|
</li>
|
|
<li>99 = Conditions cannot be met
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
</dl>
|
|
<p>The possible condition mode values are:
|
|
</p>
|
|
<p>This element indicates which systems the conditioning activity must have completed on before this activity can be performed.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALLNODES</u></b></dt>
|
|
<dd>The conditioning activity specified must complete on all nodes before this activity runs.
|
|
</dd>
|
|
<dt><b>*SAMENODE</b></dt>
|
|
<dd>When the conditioning activity specified completes for a given node, the activity specified on the ACTIVITY parameter may run for that same node even though the conditioning activity specified may not have completed for all other nodes. In the case where this activity lists a node not in the conditioning activity, this activity may run for that node; the condition is ignored.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDPRDCRQA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDPRDCRQA.STRTIME"></a>
|
|
<h3>Activity start time (STRTIME)</h3>
|
|
<p>Specifies the date and time when this activity can be started on the central site system. The current date and time values and next date values are determined when the change request is submitted.
|
|
</p>
|
|
<p>The possible start after time values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*CURRENT</u></b></dt>
|
|
<dd>This activity can start any time on or after the time when the change request is submitted.
|
|
</dd>
|
|
<dt><b><i>start-after-time</i></b></dt>
|
|
<dd>Specify the time when this activity can start. The time can be entered as 4 or 6 digits (hhmm or hhmmss) where hh = hours, mm = minutes, and ss = seconds. Seconds are optional. The time can be specified with or without a time separator such as a colon (:). With a time separator, specify a string of 5 or 8 digits (hh:mm or hh:mm:ss).
|
|
</dd>
|
|
</dl>
|
|
<p>The possible start after date values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*CURRENT</u></b></dt>
|
|
<dd>This activity can start on or after the date on which the change request is submitted.
|
|
</dd>
|
|
<dt><b>*NEXT</b></dt>
|
|
<dd>The activity can start on any date after the date the change request is submitted.
|
|
</dd>
|
|
<dt><b><i>start-after-date</i></b></dt>
|
|
<dd>Specify the date after this activity can start. The date must be specified in the job date format.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible start before time values are:
|
|
</p>
|
|
<p>This element is ignored if the start before date is *ANY.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ANY</u></b></dt>
|
|
<dd>The activity can start at any time on or before the start before date.
|
|
</dd>
|
|
<dt><b>*CURRENT</b></dt>
|
|
<dd>The activity must start before the time at which the change request was submitted on the date specified on the start before date element. This value cannot be specified if the start before date is *CURRENT.
|
|
</dd>
|
|
<dt><b><i>start-before-time</i></b></dt>
|
|
<dd>Specify the time before the activity must start. If the activity cannot be started before this time, it never starts. The time can be entered as 4 or 6 digits (hhmm or hhmmss) where hh = hours, mm = minutes, and ss = seconds. The time can be specified with or without a time separator such as a colon (:). Seconds are optional. With a time separator, specify a string of 5 or 8 digits (hh:mm or hh:mm:ss).
|
|
</dd>
|
|
</dl>
|
|
<p>The possible start before date values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ANY</u></b></dt>
|
|
<dd>The activity can start at any time after the start after time and the start after date.
|
|
</dd>
|
|
<dt><b>*CURRENT</b></dt>
|
|
<dd>The activity must start on the date the change request is submitted.
|
|
</dd>
|
|
<dt><b>*NEXT</b></dt>
|
|
<dd>The activity must start by the day after the date the change request is submitted.
|
|
</dd>
|
|
<dt><b><i>start-before-date</i></b></dt>
|
|
<dd>Specify the date before the activity must start. If the activity cannot be started by this date, it never starts. The date must be specified in the job date format.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDPRDCRQA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDPRDCRQA.HOLD"></a>
|
|
<h3>Hold activity (HOLD)</h3>
|
|
<p>Specifies that the activity be held when the change request is submitted.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>The activity is not held. It runs when all conditions and the start time are met.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>The activity is held for all nodes when the change request is submitted. It must be released by you before it runs.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDPRDCRQA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="ADDPRDCRQA.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Adding an Activity to Retrieve</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ADDPRDCRQA CRQD(MYLIB/CR1) ACTIVITY(ACT01) ACTION(*RTV)
|
|
PRDID(1ACCOUN) RLS(V5R2M0) OPTION(*BASE)
|
|
LODTYPE(*ALL) LODID(*ALL)
|
|
CPNAME((*NETATR SYS1))
|
|
</pre>
|
|
</p>
|
|
<p>Add an activity to retrieve the base option for the 1ACCOUN product, release V5R2M0, for both the code and the language parts from the iSeries server SYS1.
|
|
</p>
|
|
<p><b>Example 2: Adding an Activity to Send and Install</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ADDPRDCRQA CRQD(MYLIB/CR2) ACTIVITY(ACT01) ACTION(*SNDINS)
|
|
PRDID(1CHECKS) RLS(V5R2M0) OPTION(0010)
|
|
LODTYPE(*ALL) LODID(*ALL)
|
|
CPNAME((*NETATR SYS2)) SNDLICKEY(*YES)
|
|
</pre>
|
|
</p>
|
|
<p>This command adds an activity to send and install option 10 of the 1CHECKS product, release V5R2M0, for both the code and the language parts from the iSeries server SYS2. The license key for this product is also sent and is added to the managed system license repository.
|
|
</p>
|
|
<p><b>Example 3: Adding an Activity to Install Language Objects</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ADDPRDCRQA CRQD(MYLIB/CR3) ACTIVITY(ACT02) ACTION(*SND)
|
|
PRDID(1ACCOUN) RLS(V5R2M0) OPTION(*BASE)
|
|
LODTYPE(*ALL) LODID(2924)
|
|
NODL(NETLIB/ACCTSYS) STRTIME((23:00:00 9/30/02))
|
|
</pre>
|
|
</p>
|
|
<p>This command adds an activity to send the language objects for the English version and the code objects of the base option of the 1ACCOUN product, to all the systems in the node list (NODL) ACCTSYS network at 11 p.m. on 30 September 2002. 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="#ADDPRDCRQA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="ADDPRDCRQA.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p>None
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDPRDCRQA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|