360 lines
14 KiB
HTML
360 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>Remove Program Temporary Fix (RMVPTF)</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="RMVPTF.Top_Of_Page"></a>
|
|
<h2>Remove Program Temporary Fix (RMVPTF)</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="#RMVPTF.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#RMVPTF.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#RMVPTF.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="RMVPTF"></a>
|
|
<p>The Remove Program Temporary Fix (RMVPTF) command removes the specified program temporary fixes (PTFs) from the specified product. If the PTFs are temporarily applied, the original objects that they replaced are returned. The PTFs can be temporarily removed, in which case they are held in the product PTF library and they can be applied later. If the PTFs have not been applied, they can be permanently removed and moved to the QRPLOBJ library.
|
|
</p>
|
|
<p>The RMVPTF command is used to remove immediate PTFs at the time the command is run, or to request PTFs to be removed during the next unattended initial program load (IPL).
|
|
</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="#RMVPTF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="RMVPTF.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="#RMVPTF.LICPGM"><b>LICPGM</b></a></td>
|
|
<td valign="top">Product</td>
|
|
<td valign="top"><i>Character value</i></td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RMVPTF.RLS"><b>RLS</b></a></td>
|
|
<td valign="top">Release</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="#RMVPTF.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="#RMVPTF.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="#RMVPTF.RMV"><b>RMV</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="#RMVPTF.DELAYED"><b>DELAYED</b></a></td>
|
|
<td valign="top">Delayed PTFs</td>
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RMVPTF.IPLRMV"><b>IPLRMV</b></a></td>
|
|
<td valign="top">Remove on unattended IPL</td>
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RMVPTF.RMVDEP"><b>RMVDEP</b></a></td>
|
|
<td valign="top">Remove dependent 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="#RMVPTF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="RMVPTF.LICPGM"></a>
|
|
<h3>Product (LICPGM)</h3>
|
|
<p>Specifies the 7-character identifier of the product from which the PTFs are removed.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVPTF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RMVPTF.RLS"></a>
|
|
<h3>Release (RLS)</h3>
|
|
<p>Specifies the release level of the PTFs being loaded.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ONLY</u></b></dt>
|
|
<dd>This value is valid when only one release of the product's base option is installed on the system. PTFs for all installed options of the product are removed 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.
|
|
<p>If the release-level specified is the release-level of the base option of the product, PTFs for all installed options of the product are removed regardless of the release-level of the option.
|
|
</p>
|
|
<p>If the release-level specified is not the release-level of the base option of the product, only PTFs for the options installed at that release-level are removed.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVPTF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RMVPTF.SELECT"></a>
|
|
<h3>PTF numbers to select (SELECT)</h3>
|
|
<p>Specifies which PTFs are removed from the specified product. The <b>PTF numbers to omit (OMIT)</b> 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>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>All the PTFs are removed from the product. Those that were permanently applied are ignored by this command. If all PTFs cannot be removed, messages are sent to the operator indicating the PTFs that are not removed and the reasons why they are not being removed.
|
|
</dd>
|
|
<dt><b><i>PTF-number</i></b></dt>
|
|
<dd>Specify the PTF identification number of each program temporary fix being removed. A maximum of 300 PTF numbers can be specified.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVPTF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RMVPTF.OMIT"></a>
|
|
<h3>PTF numbers to omit (OMIT)</h3>
|
|
<p>Specifies that all PTFs are removed except for those specified in this parameter. Specify the PTF numbers of the program temporary fixes that are omitted (left in the system) when all the rest are removed. A maximum of 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="#RMVPTF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RMVPTF.RMV"></a>
|
|
<h3>Extent of change (RMV)</h3>
|
|
<p>Specifies whether the PTFs are removed temporarily or permanently. Permanently removed PTF objects are moved to QRPLOBJ or deleted. Temporarily removed PTF objects are held in the product PTF library for application at a later time.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*TEMP</u></b></dt>
|
|
<dd>The PTFs are removed and held in the product PTF library so that they can be applied again later.
|
|
</dd>
|
|
<dt><b>*PERM</b></dt>
|
|
<dd>The PTFs are permanently removed and placed in QRPLOBJ.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVPTF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RMVPTF.DELAYED"></a>
|
|
<h3>Delayed PTFs (DELAYED)</h3>
|
|
<p>Specifies whether immediate PTFs are removed at the time the command is run, or whether immediate and delayed PTFs are removed in a delayed manner during the next unattended IPL.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>Any immediate PTFs identified are removed at the time the command is processed. For delayed PTFs, if the PTF has a status of <b>Not applied</b> and you have specified RMV(*PERM), the PTF is permanently removed at the time the command is run. All other delayed PTFs are ignored during the RMVPTF request and are not removed. For immediate PTFs that are being temporarily removed, any preconditions that are active will result in the PTF not being removed. A message is sent for each PTF that is not removed.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>Both delayed and immediate PTFs are removed during the next unattended IPL. The <b>Remove on unattended IPL (IPLRMV)</b> parameter determines whether the PTFs are removed during the next unattended IPL, or whether any previous request to remove the PTFs during the next unattended IPL is canceled.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVPTF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RMVPTF.IPLRMV"></a>
|
|
<h3>Remove on unattended IPL (IPLRMV)</h3>
|
|
<p>Specifies the action that is done for delayed or immediate PTFs at the next unattended IPL. This parameter is valid only if *YES was specified for the <b>Delayed PTFs (DELAYED)</b> parameter.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*YES</u></b></dt>
|
|
<dd>The identified PTFs are removed at the next unattended IPL. The <b>Extent of change (RMV)</b> parameter determines whether the removal is temporary or permanent.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>Any previous request to remove the identified PTFs at the next unattended IPL is canceled.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVPTF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RMVPTF.RMVDEP"></a>
|
|
<h3>Remove dependent PTFs (RMVDEP)</h3>
|
|
<p>Specifies whether dependent PTFs and mutually dependent PTFs in the same product and option as the PTFs specified in the SELECT parameter are processed with the PTFs specified in the SELECT parameter list. The RMVDEP parameter is valid only if *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 dependent and mutually dependent PTFs are not processed with the SELECT parameter list. No PTFs are removed if any PTF specified in the list has dependent PTFs not also in the list or already applied. Messages identify the missing dependent PTFs and the specified PTFs on which they depend.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>The dependent and mutually dependent PTFs are removed with the SELECT parameter list.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVPTF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="RMVPTF.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Temporarily Removing PTFs</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RMVPTF LICPGM(5722SS1) DELAYED(*YES)
|
|
</pre>
|
|
</p>
|
|
<p>This command temporarily removes all temporarily applied PTFs from the operating system (5722SS1) at the next IPL. The PTFs can be applied again, if necessary, using the APYPTF command.
|
|
</p>
|
|
<p><b>Example 2: Permanently Removing PTFs</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RMVPTF LICPGM(5722SS1) SELECT(SI10002 SI10005) RMV(*PERM)
|
|
</pre>
|
|
</p>
|
|
<p>This command permanently removes two PTFs (numbers SI10002 and SI10005) from the operating system (5722SS1). The two PTFs are moved to QRPLOBJ and must be loaded again using the LODPTF command before they can be applied.
|
|
</p>
|
|
<p><b>Example 3: Removing PTFs and Their Mutual Dependents</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RMVPTF LICPGM(5722SS1) SELECT(SI00003 SI00008 SI00012)
|
|
DELAYED(*YES) RMVDEP(*YES)
|
|
</pre>
|
|
</p>
|
|
<p>This command temporarily removes PTFs SI00003, SI00008, SI00012, and their dependent and mutually dependent PTFs within the same product and option from the operating system in library QSYS at the next IPL.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVPTF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="RMVPTF.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF24B4</b></dt>
|
|
<dd>Severe error while addressing parameter list.
|
|
</dd>
|
|
<dt><b>CPF35A0</b></dt>
|
|
<dd>Cannot allocate library &1.
|
|
</dd>
|
|
<dt><b>CPF35A1</b></dt>
|
|
<dd>Wrong copy of Licensed Internal Code in use.
|
|
</dd>
|
|
<dt><b>CPF35A4</b></dt>
|
|
<dd>Licensed Internal Code fix &2 cannot be removed.
|
|
</dd>
|
|
<dt><b>CPF35A9</b></dt>
|
|
<dd>Error occurred while processing Licensed Internal Code fix.
|
|
</dd>
|
|
<dt><b>CPF35C0</b></dt>
|
|
<dd>IPL action cannot be removed for PTF &1-&2 &3.
|
|
</dd>
|
|
<dt><b>CPF35D0</b></dt>
|
|
<dd>Licensed Internal Code fix &1-&2 &3 not set to be removed permanently.
|
|
</dd>
|
|
<dt><b>CPF35D2</b></dt>
|
|
<dd>PTF &1-&2 not removed.
|
|
</dd>
|
|
<dt><b>CPF35EB</b></dt>
|
|
<dd>Multiple releases of product &1 installed.
|
|
</dd>
|
|
<dt><b>CPF35E4</b></dt>
|
|
<dd>Information for PTF &1-&2 &3 not complete.
|
|
</dd>
|
|
<dt><b>CPF35FB</b></dt>
|
|
<dd>PTF &1-&2 not removed.
|
|
</dd>
|
|
<dt><b>CPF3558</b></dt>
|
|
<dd>Cannot allocate &1 in &3 type *&2.
|
|
</dd>
|
|
<dt><b>CPF3564</b></dt>
|
|
<dd>PTF &1-&2 damaged.
|
|
</dd>
|
|
<dt><b>CPF358A</b></dt>
|
|
<dd>Release not valid.
|
|
</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 &2 not removed because it is permanently applied.
|
|
</dd>
|
|
<dt><b>CPF3604</b></dt>
|
|
<dd>PTF not removed because an error occurred.
|
|
</dd>
|
|
<dt><b>CPF3606</b></dt>
|
|
<dd>Product &1 &2 not installed.
|
|
</dd>
|
|
<dt><b>CPF361E</b></dt>
|
|
<dd>Error occurred while removing PTFs for product &1.
|
|
</dd>
|
|
<dt><b>CPF3612</b></dt>
|
|
<dd>Library &1 not found.
|
|
</dd>
|
|
<dt><b>CPF3641</b></dt>
|
|
<dd>No immediate PTFs removed.
|
|
</dd>
|
|
<dt><b>CPF3658</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>CPF3956</b></dt>
|
|
<dd>Error occurred during PTF processing.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVPTF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|