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

503 lines
17 KiB
HTML
Raw 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 PTF Order (SNDPTFORD)</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="SNDPTFORD.Top_Of_Page"></a>
<h2>Send PTF Order (SNDPTFORD)</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="#SNDPTFORD.PARAMETERS.TABLE">Parameters</a><br>
<a href="#SNDPTFORD.COMMAND.EXAMPLES">Examples</a><br>
<a href="#SNDPTFORD.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="SNDPTFORD"></a>
<p>The Send Program Temporary Fix Order (SNDPTFORD) command allows you to prepare an order for:
</p>
<ul>
<li>Individual PTFs
</li>
<li>Cumulative PTF package
</li>
<li>PTF Group
</li>
<li>Summary information for available PTFs
</li>
<li>Preventive Service Planning (PSP) information
</li>
</ul>
<p><b>Restriction:</b>
</p>
<p>1. This command is shipped with public *EXCLUDE authority, and the QSRV and QSRVBAS user profiles have private authority to use the command.
</p>
<p>2. The following restrictions apply for the IMGDIR parameter:
</p>
<ul>
<li>You must have *X authority to each directory in the path.
</li>
<li>You must have *WX authority to the directory that contains optical image.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDPTFORD.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="SNDPTFORD.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="4"><a href="#SNDPTFORD.PTFID"><b>PTFID</b></a></td>
<td valign="top">PTF description</td>
<td valign="top">Values (up to 20 repetitions): <i>Element list</i></td>
<td valign="top" rowspan="4">Required, Positional 1</td>
</tr>
<tr>
<td valign="top">Element 1: PTF identifier</td>
<td valign="top">
<i>Character value</i>, *CUMPKG, *HIPERGRP, *DB2GRP, *BRSGRP, *JVAGRP, *HTTPGRP, *PFRGRP</td>
</tr>
<tr>
<td valign="top">Element 2: Product</td>
<td valign="top">
<i>Character value</i>, <b><u>*ONLYPRD</u></b></td>
</tr>
<tr>
<td valign="top">Element 3: Release</td>
<td valign="top">
<i>Character value</i>, <b><u>*ONLYRLS</u></b></td>
</tr>
<tr>
<td valign="top"><a href="#SNDPTFORD.PTFPART"><b>PTFPART</b></a></td>
<td valign="top">PTF parts</td>
<td valign="top"><b><u>*ALL</u></b>, *CVRLTR</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDPTFORD.RMTCPNAME"><b>RMTCPNAME</b></a></td>
<td valign="top">Remote control point</td>
<td valign="top"><i>Communications name</i>, <b><u>*IBMSRV</u></b>, *SELECT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDPTFORD.RMTNETID"><b>RMTNETID</b></a></td>
<td valign="top">Remote network identifier</td>
<td valign="top"><i>Communications name</i>, <b><u>*NETATR</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDPTFORD.DELIVERY"><b>DELIVERY</b></a></td>
<td valign="top">Delivery method</td>
<td valign="top"><b><u>*LINKONLY</u></b>, *ANY</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDPTFORD.DLVRYFMT"><b>DLVRYFMT</b></a></td>
<td valign="top">Delivery format</td>
<td valign="top"><b><u>*SAVF</u></b>, *IMAGE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDPTFORD.ORDER"><b>ORDER</b></a></td>
<td valign="top">Order</td>
<td valign="top"><b><u>*REQUIRED</u></b>, *PTFID</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDPTFORD.REORDER"><b>REORDER</b></a></td>
<td valign="top">Reorder</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDPTFORD.CHKPTF"><b>CHKPTF</b></a></td>
<td valign="top">Check PTF</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDPTFORD.IMGDIR"><b>IMGDIR</b></a></td>
<td valign="top">Image directory</td>
<td valign="top"><i>Path name</i>, <b><u>*DFT</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDPTFORD.IMGPFX"><b>IMGPFX</b></a></td>
<td valign="top">Image prefix</td>
<td valign="top"><i>Character value</i>, <b><u>*DFT</u></b></td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#SNDPTFORD.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="SNDPTFORD.PTFID"></a>
<h3>PTF identifier (PTFID)</h3>
<p>Specifies the list of PTFs being ordered.
</p>
<p><b>Element 1: PTF identifier</b>
</p>
<dl>
<dt><b>*CUMPKG</b></dt>
<dd>Order the latest level of the cumulative PTF package (SF99vrm) for the operating system release that is installed on the system. HIPER and DB2 Universal Database (UDB) group PTFs are automatically requested with this order. It cannot be ordered with any other PTF identifier or special value.
</dd>
<dt><b>*HIPERGRP</b></dt>
<dd>Order the latest level of HIPER PTF group for the operating system release that is installed on the system.
</dd>
<dt><b>*DB2GRP</b></dt>
<dd>Order the latest level of DB2 UDB PTF group for the operating system release that is installed on the system.
</dd>
<dt><b>*BRSGRP</b></dt>
<dd>Order the latest level of Backup Recovery Solutions PTF group for the operating system release that is installed on the system.
</dd>
<dt><b>*HTTPGRP</b></dt>
<dd>Order the latest level of IBM HTTP Server PTF group for the operating system release that is installed on the system.
</dd>
<dt><b>*JVAGRP</b></dt>
<dd>Order the latest level of Java PTF group for the operating system release that is installed on the system.
</dd>
<dt><b>*PFRGRP</b></dt>
<dd>Order the latest level of Performance Tools PTF group for the operating system release that is installed on the system.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the PTF identifier. Some PTFs must be ordered individually or within a list of PTFs with the same prefix and not as part of a general list.
<p>A cumulative PTF package is specified using the format SF99vrm and the Preventive Service Planning (PSP) format is SF98vrm, where vrm is version-release-modification.
</p>
</dd>
</dl>
<p><b>Element 2: Product</b>
</p>
<dl>
<dt><b><u>*ONLYPRD</u></b></dt>
<dd>The PTF identifier is associated with only one product.
<p>
<b>Note: </b>If this value and ORDER(*REQUIRED) are specified, requisites are sent for only that product that is installed or supported on your system.
</p>
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the 7-character product identifier of the product that the PTF is associated with. If the PTF identifier is associated with more than one product, the PTF order is limited to the product specified.
</dd>
</dl>
<p><b>Element 3: Release</b>
</p>
<dl>
<dt><b><u>*ONLYRLS</u></b></dt>
<dd>The PTF identifier is associated with only one release.
<p>
<b>Note: </b>If this value and ORDER(*REQUIRED) are specified, requisites are sent for only that release level that is installed or supported on your system.
</p>
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the 6-character release level in VxRyMz format where Vx is the version number, Ry is the release number, and Mz is the modification level. The variables x and y can be a number from 0 through 9, and the variable z can be a number from 0 through 9 or a letter from A through Z.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDPTFORD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDPTFORD.PTFPART"></a>
<h3>PTF parts (PTFPART)</h3>
<p>Specifies whether PTFs or cover letters are being ordered.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>PTFs and cover letters are being ordered.
</dd>
<dt><b>*CVRLTR</b></dt>
<dd>Cover letters only are being ordered.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDPTFORD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDPTFORD.RMTCPNAME"></a>
<h3>Remote control point (RMTCPNAME)</h3>
<p>Specifies the remote control point of the service provider to whom the service request is sent.
</p>
<dl>
<dt><b><u>*IBMSRV</u></b></dt>
<dd>The service request is sent to IBM service support.
</dd>
<dt><b>*SELECT</b></dt>
<dd>A list of service providers is shown so the user can select the destination for the service request.
</dd>
<dt><b><i>communications-name</i></b></dt>
<dd>Specify the name of the remote control point.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDPTFORD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDPTFORD.RMTNETID"></a>
<h3>Remote network identifier (RMTNETID)</h3>
<p>Specifies the remote name identifier of the service provider's network.
</p>
<dl>
<dt><b><u>*NETATR</u></b></dt>
<dd>The service provider is in the local network.
</dd>
<dt><b><i>communications-name</i></b></dt>
<dd>Specify the network name of the service provider to whom the request is being sent.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDPTFORD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDPTFORD.DELIVERY"></a>
<h3>Delivery method (DELIVERY)</h3>
<p>Specifies how the PTFs are delivered.
</p>
<dl>
<dt><b><u>*LINKONLY</u></b></dt>
<dd>PTFs are delivered by the electronic customer support service link only. If the PTFs are too large to use service link, the command will fail.
</dd>
<dt><b>*ANY</b></dt>
<dd>PTFs are delivered by any available method. The service link is used for most PTFs. PTFs that are too large for the service link are sent on the selected medium.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDPTFORD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDPTFORD.DLVRYFMT"></a>
<h3>Delivery format (DLVRYFMT)</h3>
<p>Specifies the format of the delivered PTFs.
</p>
<dl>
<dt><b><u>*SAVF</u></b></dt>
<dd>PTFs are delivered through the electronic customer support service link as save files.
</dd>
<dt><b>*IMAGE</b></dt>
<dd>PTFs are delivered through the electronic customer support service link as optical image files. Optical image files will contain PTFs and cover letter. The optical image file will be stored in the directory spacified by the IMGDIR parameter.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDPTFORD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDPTFORD.ORDER"></a>
<h3>Order (ORDER)</h3>
<p>Specifies the level of fixes that are being requested.
</p>
<dl>
<dt><b><u>*REQUIRED</u></b></dt>
<dd>The PTF ordered and its requisites are being requested.
</dd>
<dt><b>*PTFID</b></dt>
<dd>The specific PTF ordered is the one being requested. No requisites are sent.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDPTFORD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDPTFORD.REORDER"></a>
<h3>Reorder (REORDER)</h3>
<p>Specifies whether a PTF that is currently loaded, applied, or on order should be ordered again.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>PTFs that are already loaded, applied, or on order are not reordered.
</dd>
<dt><b>*YES</b></dt>
<dd>PTFs that are already loaded, applied, or on order are reordered.
</dd>
</dl>
<p>
<b>Note: </b>A PTF is not reordered if the *SAVF delivery format is specified and a save file is available on the system.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDPTFORD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDPTFORD.CHKPTF"></a>
<h3>Check PTF (CHKPTF)</h3>
<p>Specifies whether checking is performed on the service requester system to determine if PTFs are ordered based on whether or not the PTF product is installed or supported.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>The PTFs specified on the PTF identifier (PTFID) parameter are ordered even when the PTF product is not installed or supported on the service requester.
</dd>
<dt><b>*YES</b></dt>
<dd>The PTFs specified on the PTF identifier (PTFID) parameter are ordered only if the PTF product is installed or supported on the service requester.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDPTFORD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDPTFORD.IMGDIR"></a>
<h3>Image directory (IMGDIR)</h3>
<p>Specifies the directory where the optical image files are stored.
</p>
<dl>
<dt><b><u>*DFT</u></b></dt>
<dd>The optical image files are stored in /QIBM/UserData/OS/Service/ECS directory.
</dd>
<dt><b><i>path-name</i></b></dt>
<dd>Specify an existing directory. For more information on specifying path names, refer to "Object naming rules" in "CL concepts and reference" in the CL reference information in the iSeries Information Center at http://www.iseries.ibm.com/infocenter.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDPTFORD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDPTFORD.IMGPFX"></a>
<h3>Image prefix (IMGPFX)</h3>
<p>Specifies a prefix for the optical image file names.
</p>
<dl>
<dt><b><u>*DFT</u></b></dt>
<dd>The files will be named by the Service Provider.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the prefix that will be used when naming the optical images being stored. If multiple images are received under one order, the files will be uniquely identified by a numerical suffix on the image name. For more information on specifying file names, refer to "Object naming rules" in the CL concepts and reference topic in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDPTFORD.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="SNDPTFORD.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Sending Order for PTFs by PTF Number only</b>
</p>
<p>
<pre>
SNDPTFORD PTFID((SI12345) (SI12346))
</pre>
</p>
<p>This command sends a request for PTF numbers SI12345 and SI12346.
</p>
<p><b>Example 2: Sending Order for PTF by Product and Release</b>
</p>
<p>
<pre>
SNDPTFORD PTFID((SI12345 5722SS1 V5R3M0))
DELIVERY(*ANY) ORDER(*REQUIRED)
</pre>
</p>
<p>This command sends a request for PTF SI12345 for Version 5 Release 1 Modification 0 of the operating system product (5722SS1). The PTF can be delivered by any available method. Any requisites are sent with the PTFs.
</p>
<p><b>Example 3: Sending Order for Latest Cumulative PTF</b>
</p>
<p>
<pre>
SNDPTFORD PTFID((*CUMPKG))
</pre>
</p>
<p>This command requests that the latest PTF cumulative package be sent for the operating system release level that is installed on your system.
</p>
<p><b>Example 4: Sending Order for a PTF Group</b>
</p>
<p>
<pre>
SNDPTFORD PTFID((SF99893))
</pre>
</p>
<p>This command sends a request for PTF group number SF99893.
</p>
<p><b>Example 5: Sending Order for a DB2 UDB Group with *IMAGE Delivery format</b>
</p>
<p>
<pre>
SNDPTFORD PTFID((*DB2GRP)) DELIVERY(*LINKONLY)
DLVRYFMT(*IMAGE)
</pre>
</p>
<p>This command sends a request for the latest level of the DB2 UDB PTF group for the operating system release that is installed on your system. The PTF group will be stored in optical image files inside /QIBM/UserData/OS/Service/ECS directory.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDPTFORD.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="SNDPTFORD.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF2702</b></dt>
<dd>Device description &amp;1 not found.
</dd>
<dt><b>CPF7C08</b></dt>
<dd>No support network connection.
</dd>
<dt><b>CPF8C0C</b></dt>
<dd>Content of problem record &amp;1 not valid.
</dd>
<dt><b>CPF8C0E</b></dt>
<dd>Library QGPL not found.
</dd>
<dt><b>CPF8C01</b></dt>
<dd>Cannot connect to IBM service system. One session allowed.
</dd>
<dt><b>CPF8C07</b></dt>
<dd>A parameter is not valid.
</dd>
<dt><b>CPF8C08</b></dt>
<dd>Cannot specify *SELECT for the control point name.
</dd>
<dt><b>CPF8C09</b></dt>
<dd>&amp;1 not defined as a service provider.
</dd>
<dt><b>CPF8C16</b></dt>
<dd>Error occurred while processing request.
</dd>
<dt><b>CPF8C17</b></dt>
<dd>Sign-on failed.
</dd>
<dt><b>CPF8C18</b></dt>
<dd>No support network connection.
</dd>
<dt><b>CPF8C19</b></dt>
<dd>Remote support application failed.
</dd>
<dt><b>CPF8C2A</b></dt>
<dd>Cannot connect to IBM service system.
</dd>
<dt><b>CPF8C24</b></dt>
<dd>Error occurred while processing request.
</dd>
<dt><b>CPF8C27</b></dt>
<dd>Alternate load device not found.
</dd>
<dt><b>CPF8C32</b></dt>
<dd>PTF order cannot be processed.
</dd>
<dt><b>CPF8C99</b></dt>
<dd>PTF &amp;2-&amp;1 &amp;3 not ordered.
</dd>
<dt><b>CPF9846</b></dt>
<dd>Error while processing file &amp;1 in library &amp;2.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDPTFORD.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>