293 lines
11 KiB
HTML
293 lines
11 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 PTF Cover Letter (DSPPTFCVR)</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="DSPPTFCVR.Top_Of_Page"></a>
|
|
<h2>Display PTF Cover Letter (DSPPTFCVR)</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="#DSPPTFCVR.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#DSPPTFCVR.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#DSPPTFCVR.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="DSPPTFCVR"></a>
|
|
<p>The Display Program Temporary Fix Cover Letter (DSPPTFCVR) command shows the program temporary fix (PTF) cover letters 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="#DSPPTFCVR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="DSPPTFCVR.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="#DSPPTFCVR.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="#DSPPTFCVR.SELECT"><b>SELECT</b></a></td>
|
|
<td valign="top">PTF numbers to select</td>
|
|
<td valign="top">Values (up to 300 repetitions): <i>Character value</i>, <b><u>*NOTAPY</u></b>, *ALL</td>
|
|
<td valign="top">Optional, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPPTFCVR.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="#DSPPTFCVR.CVRATR"><b>CVRATR</b></a></td>
|
|
<td valign="top">Attributes</td>
|
|
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values (up to 7 repetitions): *SPCINST, *PREIMM, *PREDLY, *PREOPR, *POSTOPR, *UNKNOWN</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPPTFCVR.CVRLTRLNG"><b>CVRLTRLNG</b></a></td>
|
|
<td valign="top">Cover letter language</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*DFT</u></b>, *ALL</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPPTFCVR.OUTPUT"><b>OUTPUT</b></a></td>
|
|
<td valign="top">Output</td>
|
|
<td valign="top"><b><u>*</u></b>, *PRINT</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPTFCVR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="DSPPTFCVR.LICPGM"></a>
|
|
<h3>Product (LICPGM)</h3>
|
|
<p>Specifies the product for which cover letters are displayed.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>The cover letters for all installed or supported products are displayed.
|
|
</dd>
|
|
<dt><b><i>licensed-program</i></b></dt>
|
|
<dd>Specify the product for which cover letters are displayed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPTFCVR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPTFCVR.SELECT"></a>
|
|
<h3>PTF numbers to select (SELECT)</h3>
|
|
<p>Specifies which cover letter is displayed for the specified product.
|
|
</p>
|
|
<p>*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, cover letters for all installed or supported products are displayed.
|
|
</p>
|
|
<p>When LICPGM(licensed-program) and SELECT(*ALL) are specified, cover letters for all releases of the specified product are displayed. The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NOTAPY</u></b></dt>
|
|
<dd>All cover letters of the PTFs that are not already applied or superseded for the specified product are displayed.
|
|
</dd>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All cover letters for the specified product are displayed.
|
|
</dd>
|
|
<dt><b><i>PTF-number</i></b></dt>
|
|
<dd>Specify the PTF identification number of the cover letter that is displayed. A maximum of 300 PTF numbers can be specified.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPTFCVR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPTFCVR.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 cover letters for all releases of the installed or supported 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 specified is the release of the installed base option of the product, cover letters for all installed options of the product are displayed regardless of the release of the option. All cover letters for options that are supported at this release are also displayed.
|
|
</p>
|
|
<p>If the release specified is not the release of the installed base option of the product, only cover letters of the product options that are supported or installed at that release are displayed.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPTFCVR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPTFCVR.CVRATR"></a>
|
|
<h3>Attributes (CVRATR)</h3>
|
|
<p>Specifies which cover letter to display based on the attributes contained in the cover letter.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>The CVRATR parameter can be specified only with SELECT(*ALL) or SELECT(*NOTAPY).
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>All cover letters are displayed.
|
|
</dd>
|
|
<dt><b>*SPCINST</b></dt>
|
|
<dd>Only cover letters with special instructions are displayed.
|
|
</dd>
|
|
<dt><b>*PREIMM</b></dt>
|
|
<dd>Only cover letters with special instructions that need to be followed before being applied or removed immediately are displayed.
|
|
</dd>
|
|
<dt><b>*PREDLY</b></dt>
|
|
<dd>Only cover letters with special instructions that need to be followed before being applied or removed during an IPL (delayed) are displayed.
|
|
</dd>
|
|
<dt><b>*PREOPR</b></dt>
|
|
<dd>Only cover letters with special instructions that need to be followed before being applied or removed (immediately or delayed) are displayed.
|
|
</dd>
|
|
<dt><b>*POSTOPR</b></dt>
|
|
<dd>Only cover letters with special instructions that need to be followed after being applied or removed are displayed.
|
|
</dd>
|
|
<dt><b>*UNKNOWN</b></dt>
|
|
<dd>Display the cover letters for which the system cannot detect if they have attributes. The most likely reasons are when the PTF cover letter was created prior to operating system release V5R1M0, or the cover letter was created using the System Manager licensed program.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPTFCVR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPTFCVR.CVRLTRLNG"></a>
|
|
<h3>Cover letter language (CVRLTRLNG)</h3>
|
|
<p>Specifies the language feature code that is used to display the cover letters.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*DFT</u></b></dt>
|
|
<dd>Cover letters are displayed in the default language feature code. If there is only one cover letter for the PTF, it will be displayed. If there is more than one cover letter for the PTF, the following criteria will be used to determine which cover letter to display.
|
|
<p>The language feature code that matches the service contact information (WRKCNTINF) will be used.
|
|
</p>
|
|
<p>If no language feature code matches the service contact information, the language feature code that matches the primary language of the operating system will be used.
|
|
</p>
|
|
<p>If no cover letters match the language feature code in the service contact information, or the language feature code of the operating system, all cover letters for the PTF will be displayed. The user will be given a list of language feature codes to choose from (if requested by an interactive job) or all cover letters will be printed with the job's spooled output (if requested by a batch job).
|
|
</p>
|
|
</dd>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>Cover letters for all languages are displayed.
|
|
</dd>
|
|
<dt><b><i>language-feature-code</i></b></dt>
|
|
<dd>Cover letters for the selected language feature code are displayed. If a cover letter for the selected language feature code is not available, no cover letter is displayed for the PTF.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPTFCVR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPTFCVR.OUTPUT"></a>
|
|
<h3>Output (OUTPUT)</h3>
|
|
<p>Specifies whether the output from the command is displayed at the requesting workstation 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>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPTFCVR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DSPPTFCVR.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Print PTF Cover Letters</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
DSPPTFCVR LICPGM(5722SS1) SELECT(SI00034) OUTPUT(*PRINT)
|
|
</pre>
|
|
</p>
|
|
<p>This command produces a printout of the cover letter for PTF SI00034 in the product 5722SS1.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPTFCVR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DSPPTFCVR.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>CPF35BE</b></dt>
|
|
<dd>Product &1 &3 not supported or installed.
|
|
</dd>
|
|
<dt><b>CPF35D5</b></dt>
|
|
<dd>Cover letter NLV not valid.
|
|
</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>CPF3586</b></dt>
|
|
<dd>List of PTFs not correct.
|
|
</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>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPTFCVR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|