368 lines
13 KiB
HTML
368 lines
13 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>Display Program Temporary Fix (DSPPTF)</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="DSPPTF.Top_Of_Page"></a>
|
|
<h2>Display Program Temporary Fix (DSPPTF)</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="#DSPPTF.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#DSPPTF.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#DSPPTF.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="DSPPTF"></a>
|
|
<p>The Display Program Temporary Fix (DSPPTF) command shows the program temporary fixes (PTFs) for a specified product.
|
|
</p>
|
|
<p><b>Restriction:</b> This command is shipped with public *EXCLUDE authority and the QPGMR, QSYSOPR, QSRV, and QSRVBAS user profiles have private authorities to use the command.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPTF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="DSPPTF.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="#DSPPTF.LICPGM"><b>LICPGM</b></a></td>
|
|
<td valign="top">Product</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*ALL</u></b></td>
|
|
<td valign="top">Optional, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPPTF.SELECT"><b>SELECT</b></a></td>
|
|
<td valign="top">PTF numbers to select</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*ALL</u></b>, *PTFSAVF, *ONORDER, *ACTRQD</td>
|
|
<td valign="top">Optional, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPPTF.RLS"><b>RLS</b></a></td>
|
|
<td valign="top">Release</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*ALL</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPPTF.COVERONLY"><b>COVERONLY</b></a></td>
|
|
<td valign="top">Cover letter only</td>
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPPTF.OUTPUT"><b>OUTPUT</b></a></td>
|
|
<td valign="top">Output</td>
|
|
<td valign="top"><b><u>*</u></b>, *PRINT, *OUTFILE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#DSPPTF.OUTFILE"><b>OUTFILE</b></a></td>
|
|
<td valign="top">File to receive output</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: File to receive output</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" rowspan="3"><a href="#DSPPTF.OUTMBR"><b>OUTMBR</b></a></td>
|
|
<td valign="top">Output member options</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Member to receive output</td>
|
|
<td valign="top">
|
|
<i>Name</i>, <b><u>*FIRST</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Replace or add records</td>
|
|
<td valign="top">
|
|
<b><u>*REPLACE</u></b>, *ADD</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPTF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="DSPPTF.LICPGM"></a>
|
|
<h3>Product (LICPGM)</h3>
|
|
<p>Specifies the product for the PTFs that are shown. When LICPGM(*ALL) is specified, PTFs for all installed and supported products are shown.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>The PTFs of all installed and supported products are shown.
|
|
</dd>
|
|
<dt><b><i>licensed-program</i></b></dt>
|
|
<dd>Specify the product for which PTFs are shown.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPTF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPTF.SELECT"></a>
|
|
<h3>PTF numbers to select (SELECT)</h3>
|
|
<p>Specifies which PTF is shown for the specified product. *ALL cannot be specified for the <b>Product (LICPGM)</b> parameter if a PTF number is specified on the <b>PTF numbers to select (SELECT)</b> parameter.
|
|
</p>
|
|
<p>When LICPGM(*ALL) and SELECT(*ALL) are specified, all PTFs for all installed and supported products are shown.
|
|
</p>
|
|
<p>When LICPGM(licensed-program) and SELECT(*ALL) are specified, PTFs for all releases of the specified products are shown. The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>The status of all PTFs for the specified product is shown.
|
|
</dd>
|
|
<dt><b>*PTFSAVF</b></dt>
|
|
<dd>The status of all PTFs for the specified product that have a save file in library QGPL is shown. This special value is useful for determining which PTF save files are no longer needed. It is also useful for the service provider for determining which PTFs can be distributed.
|
|
</dd>
|
|
<dt><b>*ONORDER</b></dt>
|
|
<dd>The status of all PTFs for the specified product that are on order is shown.
|
|
</dd>
|
|
<dt><b>*ACTRQD</b></dt>
|
|
<dd>The PTFs that have required actions pending are shown. This special value is useful to the user for determining which PTFs require an action to become active.
|
|
<p>
|
|
<b>Note: </b>If *ACTRQD is specified, the exit programs that run take a long time, resulting in a delay in the appearance of the first screen.
|
|
</p>
|
|
</dd>
|
|
<dt><b><i>PTF-number</i></b></dt>
|
|
<dd>Specify the PTF identification number of the PTF that is shown.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPTF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPTF.RLS"></a>
|
|
<h3>Release (RLS)</h3>
|
|
<p>Specifies the release level of the PTFs being displayed.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>The PTFs for all releases of the supported and installed products are displayed.
|
|
</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 installed base option of the product, PTFs for all installed options of the product are displayed regardless of the release-level of the option. All PTFs for options that are supported at this release-level are also displayed.
|
|
</p>
|
|
<p>If the release-level specified is not the release-level of the installed base option of the product, only PTFs for the product options that are supported or installed at that release-level are displayed.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPTF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPTF.COVERONLY"></a>
|
|
<h3>Cover letter only (COVERONLY)</h3>
|
|
<p>Specifies whether only the cover letter is displayed.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>A cover letter is not displayed.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>The cover letter is displayed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPTF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPTF.OUTPUT"></a>
|
|
<h3>Output (OUTPUT)</h3>
|
|
<p>Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*</u></b></dt>
|
|
<dd>The output is displayed (if requested by an interactive job) or printed with the job's spooled output (if requested by a batch job).
|
|
</dd>
|
|
<dt><b>*PRINT</b></dt>
|
|
<dd>The output is printed with the job's spooled output. The name of the spooled output file is QSYSPRT.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*OUTFILE</b></dt>
|
|
<dd>The output is directed to the database file specified for the <b>File to receive output (OUTFILE)</b> parameter.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPTF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPTF.OUTFILE"></a>
|
|
<h3>File to receive output (OUTFILE)</h3>
|
|
<p>Specifies the physical database file where the PTF records are directed. If the output file already exists, the system attempts to use it. The system creates a physical database file (with the name specified in the OUTFILE parameter) in the designated library. A member is created for the file with the name specified in the <b>Output member options (OUTMBR)</b> parameter. If a new file is created, system file QADSPPTF in system library QSYS with a format name of QSCPTF is used as a model.
|
|
</p>
|
|
<p>The possible library values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is used to locate the file. If no library is specified as the current library for the job, the QGPL library is used.
|
|
</dd>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>Specify the library where the file is located.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>file-name</i></b></dt>
|
|
<dd>Specify the name of the file that receives the PTFs.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPTF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPTF.OUTMBR"></a>
|
|
<h3>Output member options (OUTMBR)</h3>
|
|
<p>Specifies the name of the database file member where the output of the command is directed. A second value specifies whether the new data replaces the existing data or is added to the end of the data already in the file member.
|
|
</p>
|
|
<p>The possible member name values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*FIRST</u></b></dt>
|
|
<dd>The first member in the file receives the output. If OUTMBR(*FIRST) is specified and the member does not exist, the system creates a member with the name of the file specified for the <b>File to receive output (OUTFILE)</b> parameter. If the member already exists, you have the option to add new records to the end of the existing member or clear the member and then add the new records.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b><i>member-name</i></b></dt>
|
|
<dd>Specify the name of the member in the file that receives the output. If the specified member name does not exist, the system creates it.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible placement values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*REPLACE</u></b></dt>
|
|
<dd>The system clears the existing member and adds the new records.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*ADD</b></dt>
|
|
<dd>The system adds the new records to the end of the existing records.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPTF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DSPPTF.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Printing Status of PTFs</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
DSPPTF LICPGM(5722SS1) OUTPUT(*PRINT)
|
|
</pre>
|
|
</p>
|
|
<p>This command produces a printout containing the status of PTFs for the product 5722SS1.
|
|
</p>
|
|
<p><b>Example 2: Printing Information</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
DSPPTF LICPGM(5722SS1) SELECT(SI00034) OUTPUT(*PRINT)
|
|
</pre>
|
|
</p>
|
|
<p>This command produces a printout containing detailed information about PTF SI00034 for the product 5722SS1.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPTF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DSPPTF.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF0C4B</b></dt>
|
|
<dd>Product availability object &2/&1 recovery required.
|
|
</dd>
|
|
<dt><b>CPF0C4C</b></dt>
|
|
<dd>Cannot allocate object &1 in library &2.
|
|
</dd>
|
|
<dt><b>CPF0C4D</b></dt>
|
|
<dd>Error occurred while processing object &1 in library &2.
|
|
</dd>
|
|
<dt><b>CPF24B4</b></dt>
|
|
<dd>Severe error while addressing parameter list.
|
|
</dd>
|
|
<dt><b>CPF35BE</b></dt>
|
|
<dd>Product &1 &3 not supported or installed.
|
|
</dd>
|
|
<dt><b>CPF35F5</b></dt>
|
|
<dd>Cover letter not found for PTF &1-&2 &3.
|
|
</dd>
|
|
<dt><b>CPF358A</b></dt>
|
|
<dd>Release not valid.
|
|
</dd>
|
|
<dt><b>CPF3925</b></dt>
|
|
<dd>Cannot open file &1.
|
|
</dd>
|
|
<dt><b>CPF3950</b></dt>
|
|
<dd>Error message &2 received for file &1. Request ended.
|
|
</dd>
|
|
<dt><b>CPF6601</b></dt>
|
|
<dd>No PTF activity exists for product &1.
|
|
</dd>
|
|
<dt><b>CPF6602</b></dt>
|
|
<dd>PTF &1-&2 &3 not found.
|
|
</dd>
|
|
<dt><b>CPF6603</b></dt>
|
|
<dd>No PTFs found.
|
|
</dd>
|
|
<dt><b>CPF6613</b></dt>
|
|
<dd>No PTFs met selection criteria.
|
|
</dd>
|
|
<dt><b>CPF8191</b></dt>
|
|
<dd>Product definition &4 in &9 damaged.
|
|
</dd>
|
|
<dt><b>CPF8193</b></dt>
|
|
<dd>Product load object &4 in &9 damaged.
|
|
</dd>
|
|
<dt><b>CPF9860</b></dt>
|
|
<dd>Error occurred during output file processing.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPTF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|