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

474 lines
18 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>Apply Program Temporary Fix (APYPTF)</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="APYPTF.Top_Of_Page"></a>
<h2>Apply Program Temporary Fix (APYPTF)</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="#APYPTF.PARAMETERS.TABLE">Parameters</a><br>
<a href="#APYPTF.COMMAND.EXAMPLES">Examples</a><br>
<a href="#APYPTF.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="APYPTF"></a>
<p>The Apply Program Temporary Fix (APYPTF) command applies program temporary fixes (PTF) to a specified product. Before a PTF can be applied, it must first be loaded by the Load Program Temporary Fix (LODPTF) command.
</p>
<p>When a PTF is applied, it completely replaces the affected objects in the product. PTFs can be applied temporarily or permanently. If they are applied temporarily, the replaced objects are saved by the system and can later be restored to the product by the Remove Program Temporary Fix (RMVPTF) command. If PTFs are applied permanently, the replaced objects are deleted from the system.
</p>
<p>The APYPTF command is used to apply immediate PTFs at the time the command is run, or to request PTFs to be applied during the next unattended initial program load (IPL). During an attended IPL, the Work with PTFs display is used to apply PTFs at the time the system is started.
</p>
<p>Some IPLs may take longer than others when PTFs are being applied. More information about applying PTFs is in the Maintain and manage i5/OS and related software topic of the iSeries Information Center at http://www.iseries.ibm.com/infocenter.
</p>
<p><b>Restriction:</b> To use this command, you must be signed on as QSRV, or have *ALLOBJ authority.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#APYPTF.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="APYPTF.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="#APYPTF.LICPGM"><b>LICPGM</b></a></td>
<td valign="top">Product</td>
<td valign="top"><i>Character value</i>, *ALL</td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#APYPTF.RLS"><b>RLS</b></a></td>
<td valign="top">Release</td>
<td valign="top"><i>Character value</i>, <b><u>*ONLY</u></b>, *ALL</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#APYPTF.SELECT"><b>SELECT</b></a></td>
<td valign="top">PTF numbers to select</td>
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values (up to 300 repetitions): <i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#APYPTF.OMIT"><b>OMIT</b></a></td>
<td valign="top">PTF numbers to omit</td>
<td valign="top">Values (up to 300 repetitions): <i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#APYPTF.APY"><b>APY</b></a></td>
<td valign="top">Extent of change</td>
<td valign="top"><b><u>*TEMP</u></b>, *PERM</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#APYPTF.DELAYED"><b>DELAYED</b></a></td>
<td valign="top">Delayed PTFs</td>
<td valign="top"><b><u>*NO</u></b>, *YES, *IMMDLY</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#APYPTF.IPLAPY"><b>IPLAPY</b></a></td>
<td valign="top">IPL apply options</td>
<td valign="top">Single values: *NO<br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Apply at unattended IPL</td>
<td valign="top">
<b><u>*YES</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: Prerequisite lic int code</td>
<td valign="top">
<b><u>*APYPERM</u></b>, *NOAPY</td>
</tr>
<tr>
<td valign="top"><a href="#APYPTF.APYREQ"><b>APYREQ</b></a></td>
<td valign="top">Apply requisite PTFs</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="#APYPTF.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="APYPTF.LICPGM"></a>
<h3>Product (LICPGM)</h3>
<p>Specifies the 7-character identifier of the product for which the PTFs are to be applied.
</p>
<p>
<b>Note: </b>LICPGM(*ALL) is valid only if SELECT(*ALL) is specified, and OMIT is not specified on this command.
</p>
<p>This is a required parameter.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b>*ALL</b></dt>
<dd>PTFs are applied to all products installed on the system.
</dd>
<dt><b><i>licensed-program</i></b></dt>
<dd>Specify the 7-character product identifier to which PTFs are applied.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#APYPTF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="APYPTF.RLS"></a>
<h3>Release (RLS)</h3>
<p>Specifies the release level of the software product. If multiple releases are installed, the release is required.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*ONLY</u></b></dt>
<dd>This value is valid only when one release of the product's base option is installed on the system. PTFs for all installed options of the product are applied regardless of the release-level of the option.
</dd>
<dt><b><i>release-level</i></b></dt>
<dd>Specify the 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="#APYPTF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="APYPTF.SELECT"></a>
<h3>PTF numbers to select (SELECT)</h3>
<p>Specifies the previously loaded PTFs that are to be applied to the specified product. The <b>PTF numbers to omit (OMIT)</b> parameter cannot be specified if single PTF numbers are specified on the SELECT parameter.
</p>
<p>You can enter multiple values for this parameter.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All the PTFs that were loaded are to be applied to the product. If all PTFs cannot be applied, messages are sent indicating the PTFs that were not applied and the reasons (for example, required PTFs were not yet applied).
</dd>
<dt><b><i>PTF-number</i></b></dt>
<dd>Specify the identification number of each PTF to apply. A maximum of 300 PTF numbers can be specified.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#APYPTF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="APYPTF.OMIT"></a>
<h3>PTF numbers to omit (OMIT)</h3>
<p>Specifies the PTF numbers that are not applied. Up to 300 PTF numbers can be specified. The OMIT parameter cannot be specified if single PTF numbers are specified in the <b>PTF numbers to select (SELECT)</b> parameter.
</p>
<p>You can enter multiple values for this parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#APYPTF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="APYPTF.APY"></a>
<h3>Extent of change (APY)</h3>
<p>Specifies whether the PTFs are applied on a temporary or permanent basis. Permanently applied PTFs cannot be removed; temporarily applied PTFs can be removed by the Remove Program Temporary Fix (RMVPTF) command.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*TEMP</u></b></dt>
<dd>The PTFs are applied as temporary PTFs.
</dd>
<dt><b>*PERM</b></dt>
<dd>The PTFs are applied permanently.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#APYPTF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="APYPTF.DELAYED"></a>
<h3>Delayed PTFs (DELAYED)</h3>
<p>Specifies whether immediate PTFs are applied at the time the command is processed or whether immediate and delayed PTFs are applied during the next unattended IPL.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>Immediate PTFs that are identified are applied at the time the command is processed. Delayed PTFs and immediate PTFs with delayed prerequisite or corequisite PTFs are ignored during the APYPTF request and are not applied. Immediate PTFs which have preconditions that are not satisfied are not applied. A message is sent for each PTF that is not applied.
</dd>
<dt><b>*YES</b></dt>
<dd>The PTFs identified, regardless of whether they are defined as delayed or immediate, are applied during the next unattended IPL. The <b>Apply on unattended IPL</b> (IPLAPY) parameter determines whether the PTFs are applied during the next unattended IPL, or whether a previous request to apply the PTFs during the next unattended IPL is canceled.
</dd>
<dt><b>*IMMDLY</b></dt>
<dd>All the immediate PTFs are applied and the delayed PTFs or PTFs with delayed prerequisites or corequisites are set to be applied at the next unattended IPL. Any immediate PTFs which have preconditions that are not satisfied are set to be applied at the next unattended IPL.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#APYPTF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="APYPTF.IPLAPY"></a>
<h3>IPL apply options (IPLAPY)</h3>
<p>Specifies the action that is done for delayed or immediate PTFs at the next unattended IPL.
</p>
<p>The possible PTFs Applied at IPL values are:
</p>
<p>These values are valid only if DELAYED(*YES) is also specified.
</p>
<dl>
<dt><b><u>*YES</u></b></dt>
<dd>The identified PTFs are applied at the next unattended IPL. The <b>Extent of change</b> (APY) parameter determines whether the apply operation is temporary or permanent.
</dd>
<dt><b>*NO</b></dt>
<dd>Previous requests to apply the identified PTFs at the next unattended IPL are canceled.
</dd>
</dl>
<p>The possible Prerequisite Licensed Internal Code values are:
</p>
<p>The Licensed Internal Code prerequisites are applied immediately or at the next IPL depending on the values specified on the DELAYED parameter.
</p>
<dl>
<dt><b><u>*APYPERM</u></b></dt>
<dd>If LICPGM(*ALL) is specified or APYREQ(*YES) is specified and a product's PTFs have prerequisite Licensed Internal Code fixes, then the required Licensed Internal Code fixes are also identified to be permanently applied.
</dd>
<dt><b>*NOAPY</b></dt>
<dd>Prerequisite Licensed Internal Code fixes are not identified to be applied during the next unattended IPL. If prerequisite Licensed Internal Code fixes exist that are not permanently applied, this command stops.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#APYPTF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="APYPTF.APYREQ"></a>
<h3>Apply requisite PTFs (APYREQ)</h3>
<p>Specifies whether the prerequisite and corequisite PTFs of the PTFs specified on the SELECT parameter, that are within the same product and release, are applied with the PTFs specified on the SELECT parameter list.
</p>
<p>This parameter is valid only when *ALL is not specified in the SELECT parameter.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>The corequisite and prerequisite PTFs are not applied with the SELECT parameter list. No PTFs are applied if any PTF specified in the list has requisite PTFs not also in the list or already applied. Messages identify the missing requisite PTFs and the PTFs that require them.
</dd>
<dt><b>*YES</b></dt>
<dd>The PTFs are applied with the SELECT parameter list.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#APYPTF.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="APYPTF.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Applying PTFs Temporarily</b>
</p>
<p>
<pre>
APYPTF LICPGM(5722SS1) DELAYED(*YES)
</pre>
</p>
<p>This command applies all the programming fixes that affect the operating system (5722SS1). The fixes are temporarily applied at the next IPL.
</p>
<p><b>Example 2: Applying PTFs Permanently</b>
</p>
<p>
<pre>
APYPTF LICPGM(5722SS1) SELECT(SI00003 SI00008 SI00012)
APY(*PERM) DELAYED(*YES)
</pre>
</p>
<p>This command permanently applies PTFs SI00003, SI00008, and SI00012 to the operating system in library QSYS at the next IPL.
</p>
<p><b>Example 3: Applying All Loaded PTFs</b>
</p>
<p>
<pre>
APYPTF LICPGM(*ALL) DELAYED(*IMMDLY)
</pre>
</p>
<p>This command permanently applies all PTFs that can be applied immediately and sets the rest to be applied at the next IPL.
</p>
<p><b>Example 4: Applying Immediate PTFs and their Immediate Corequisites and Prerequisites at the Time the Command is Run</b>
</p>
<p>
<pre>
APYPTF LICPGM(5722SS1) SELECT(SI00003 SI00008 SI00012)
APYREQ(*YES)
</pre>
</p>
<p>This command applies the identified PTFs and their corequisites and prerequisites at the time the command is run if the PTFs and their corequisites and prerequisites are defined as immediate. PTFs defined as delayed or defined with corequisites or prerequisites defined as delayed are ignored along with the delayed requisites.
</p>
<p><b>Example 5: Applying PTFs and their corequisites and prerequisites at the next IPL</b>
</p>
<p>
<pre>
APYPTF LICPGM(5722SS1) SELECT(SI00003 SI00008 SI00012)
DELAYED(*YES) APYREQ(*YES)
</pre>
</p>
<p>This command applies the identified PTFs and their corequisites and prerequisites at the next IPL regardless of whether they are defined as delayed or immediate.
</p>
<p><b>Example 6: Applying PTFs and their corequisites and prerequisites as soon as possible</b>
</p>
<p>
<pre>
APYPTF LICPGM(5722SS1) SELECT(SI00003 SI00008 SI00012)
DELAYED(*IMMDLY) APYREQ(*YES)
</pre>
</p>
<p>This command applies the identified PTFs and their corequisites and prerequisites at the time the command is run if the PTFs and their corequisites and prerequisites are defined as immediate. PTFs defined as delayed or defined with corequisites or prerequisites defined as delayed are applied during the next IPL along with the delayed requisites.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#APYPTF.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="APYPTF.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF0C4B</b></dt>
<dd>Product availability object &amp;2/&amp;1 recovery required.
</dd>
<dt><b>CPF0C4C</b></dt>
<dd>Cannot allocate object &amp;1 in library &amp;2.
</dd>
<dt><b>CPF0C4D</b></dt>
<dd>Error occurred while processing object &amp;1 in library &amp;2.
</dd>
<dt><b>CPF2150</b></dt>
<dd>Object information function failed.
</dd>
<dt><b>CPF2151</b></dt>
<dd>Operation failed for &amp;2 in &amp;1 type *&amp;3.
</dd>
<dt><b>CPF35AA</b></dt>
<dd>Licensed internal code PTF &amp;2 already applied.
</dd>
<dt><b>CPF35AB</b></dt>
<dd>Licensed Internal Code fix &amp;2 not applied.
</dd>
<dt><b>CPF35A0</b></dt>
<dd>Cannot allocate library &amp;1.
</dd>
<dt><b>CPF35A1</b></dt>
<dd>Wrong copy of Licensed Internal Code in use.
</dd>
<dt><b>CPF35A2</b></dt>
<dd>Required hardware changes not installed for PTF &amp;2.
</dd>
<dt><b>CPF35A3</b></dt>
<dd>Licensed Internal Code fix &amp;2 not temporarily applied.
</dd>
<dt><b>CPF35A5</b></dt>
<dd>Licensed Internal Code fix &amp;2 not permanently applied.
</dd>
<dt><b>CPF35A9</b></dt>
<dd>Error occurred while processing Licensed Internal Code fix.
</dd>
<dt><b>CPF35CF</b></dt>
<dd>PTF &amp;1-&amp;2 not applied.
</dd>
<dt><b>CPF35D0</b></dt>
<dd>Licensed Internal Code fix &amp;1-&amp;2 &amp;3 not set to be removed permanently.
</dd>
<dt><b>CPF35EB</b></dt>
<dd>Multiple releases of product &amp;1 installed.
</dd>
<dt><b>CPF35E3</b></dt>
<dd>Interface error detected.
</dd>
<dt><b>CPF35E4</b></dt>
<dd>Information for PTF &amp;1-&amp;2 &amp;3 not complete.
</dd>
<dt><b>CPF35FA</b></dt>
<dd>PTF &amp;1-&amp;2 not applied.
</dd>
<dt><b>CPF3544</b></dt>
<dd>Apply IPL action cannot be removed for PTF &amp;1-&amp;2 &amp;3.
</dd>
<dt><b>CPF3558</b></dt>
<dd>Cannot allocate &amp;1 in &amp;3 type *&amp;2.
</dd>
<dt><b>CPF3564</b></dt>
<dd>PTF &amp;1-&amp;2 damaged.
</dd>
<dt><b>CPF3583</b></dt>
<dd>PTF not applied because error occurred.
</dd>
<dt><b>CPF3576</b></dt>
<dd>Error occurred while applying PTFs for product &amp;1.
</dd>
<dt><b>CPF3596</b></dt>
<dd>PTF numbers in select/omit list not permitted.
</dd>
<dt><b>CPF3598</b></dt>
<dd>PTF function already in process.
</dd>
<dt><b>CPF3602</b></dt>
<dd>PTF &amp;2 not removed because it is permanently applied.
</dd>
<dt><b>CPF3606</b></dt>
<dd>Product &amp;1 &amp;2 not installed.
</dd>
<dt><b>CPF361D</b></dt>
<dd>Apply order of PTFs cannot be determined.
</dd>
<dt><b>CPF3612</b></dt>
<dd>Library &amp;1 not found.
</dd>
<dt><b>CPF362C</b></dt>
<dd>Insufficient storage for Licensed Internal Code fix.
</dd>
<dt><b>CPF362D</b></dt>
<dd>PTF apply completed successfully, but some PTFs need additional actions.
</dd>
<dt><b>CPF3640</b></dt>
<dd>No immediate PTFs applied.
</dd>
<dt><b>CPF3660</b></dt>
<dd>No program temporary fixes identified.
</dd>
<dt><b>CPF3693</b></dt>
<dd>Service function ended because error occurred.
</dd>
<dt><b>CPF3931</b></dt>
<dd>Required programs not found. PTF incomplete.
</dd>
<dt><b>CPF3945</b></dt>
<dd>Records of PTF activity for licensed program are deleted.
</dd>
<dt><b>CPF8191</b></dt>
<dd>Product definition &amp;4 in &amp;9 damaged.
</dd>
<dt><b>CPF8193</b></dt>
<dd>Product load object &amp;4 in &amp;9 damaged.
</dd>
<dt><b>CPF9845</b></dt>
<dd>Error occurred while opening file &amp;1.
</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="#APYPTF.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>