269 lines
9.7 KiB
HTML
269 lines
9.7 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>Copy PTF Cover Letter (CPYPTFCVR)</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="CPYPTFCVR.Top_Of_Page"></a>
|
|
<h2>Copy PTF Cover Letter (CPYPTFCVR)</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="#CPYPTFCVR.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CPYPTFCVR.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CPYPTFCVR.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CPYPTFCVR"></a>
|
|
<p>The Copy Program Temporary Fix Cover Letter (CPYPTFCVR) command copies program temporary fix (PTF) cover letters from tape or optical media into file QAPZCOVER in library QGPL. Each cover letter contains information such as problem description, correction, and special instructions. Cover letters can then be viewed using the Display PTF Cover Letter (DSPPTFCVR) and Display Program Temporary Fix (DSPPTF) commands.
|
|
</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="#CPYPTFCVR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CPYPTFCVR.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="#CPYPTFCVR.DEV"><b>DEV</b></a></td>
|
|
<td valign="top">Device</td>
|
|
<td valign="top"><i>Character value</i></td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CPYPTFCVR.LICPGM"><b>LICPGM</b></a></td>
|
|
<td valign="top">Product</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*ALL</u></b>, *SUPPTD</td>
|
|
<td valign="top">Optional, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CPYPTFCVR.SELECT"><b>SELECT</b></a></td>
|
|
<td valign="top">PTF numbers to select</td>
|
|
<td valign="top">Single values: <b><u>*NOTAPY</u></b>, *ALL<br>Other values (up to 300 repetitions): <i>Character value</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CPYPTFCVR.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="#CPYPTFCVR.CVROPT"><b>CVROPT</b></a></td>
|
|
<td valign="top">Cover letter option</td>
|
|
<td valign="top"><b><u>*NEW</u></b>, *ADD, *ALL</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CPYPTFCVR.ENDOPT"><b>ENDOPT</b></a></td>
|
|
<td valign="top">End of media option</td>
|
|
<td valign="top"><b><u>*REWIND</u></b>, *LEAVE, *UNLOAD</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CPYPTFCVR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CPYPTFCVR.DEV"></a>
|
|
<h3>Device (DEV)</h3>
|
|
<p>Specifies the name of the device that contains the cover letters to be copied.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>tape-device-name</i></b></dt>
|
|
<dd>Specify the name of the tape device from which the cover letters are copied.
|
|
</dd>
|
|
<dt><b><i>optical-device-name</i></b></dt>
|
|
<dd>Specify the name of the optical device from which the cover letters are copied.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CPYPTFCVR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CPYPTFCVR.LICPGM"></a>
|
|
<h3>Product (LICPGM)</h3>
|
|
<p>Specifies the 7-character identifier of the product for which the cover letters are copied.
|
|
</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 copied.
|
|
</dd>
|
|
<dt><b>*SUPPTD</b></dt>
|
|
<dd>The cover letters for all supported products are copied.
|
|
</dd>
|
|
<dt><b><i>licensed-program</i></b></dt>
|
|
<dd>Specify the product identifier of the cover letters to be copied.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CPYPTFCVR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CPYPTFCVR.SELECT"></a>
|
|
<h3>PTF numbers to select (SELECT)</h3>
|
|
<p>Specifies which of the cover letters for the specified product are copied.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NOTAPY</u></b></dt>
|
|
<dd>All the cover letters of the PTFs for the specified product that are not already applied or superseded are copied.
|
|
</dd>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All the cover letters for the specified product are copied.
|
|
</dd>
|
|
<dt><b><i>PTF-number</i></b></dt>
|
|
<dd>Specify the PTF identification number of the cover letters to be copied. A maximum of 300 PTF numbers can be specified. Specific PTF identifers can be used only if a specific product identifier is specified on the <b>Product</b> (LICPGM) parameter.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CPYPTFCVR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CPYPTFCVR.RLS"></a>
|
|
<h3>Release (RLS)</h3>
|
|
<p>Specifies the release level of the software product.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>Cover letters for all releases of the specified product will be copied.
|
|
</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. A specific release can be used only if a specific product identifier is specified on the <b>Product</b> (LICPGM) parameter.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CPYPTFCVR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CPYPTFCVR.CVROPT"></a>
|
|
<h3>Cover letter option (CVROPT)</h3>
|
|
<p>Specifies what to do if the cover letter being copied already exists on the system.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NEW</u></b></dt>
|
|
<dd>If a cover letter for the PTF already exists on the system in any language feature code, the cover letter will not be copied from the media. If no cover letter for the PTF exists on the system, the cover letter will be copied.
|
|
</dd>
|
|
<dt><b>*ADD</b></dt>
|
|
<dd>If a cover letter for the PTF does not exist with the same language feature code, the cover letter will be copied from the media. Otherwise the cover letter will not be copied.
|
|
</dd>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>If a cover letter with the same language feature code already exists on the system, it will be replaced. If no cover letter exists on the system for the language feature code, the cover letter will be copied.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CPYPTFCVR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CPYPTFCVR.ENDOPT"></a>
|
|
<h3>End of media option (ENDOPT)</h3>
|
|
<p>Specifies the operation that is automatically performed on the tape or optical volume after the PTF operation ends. If one or more volumes of media is involved, this parameter applies only to the last volume.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>For optical devices, *UNLOAD is the only special value supported, *REWIND and *LEAVE will be ignored.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*REWIND</u></b></dt>
|
|
<dd>The tape is automatically rewound, but not unloaded, after the operation has ended.
|
|
</dd>
|
|
<dt><b>*LEAVE</b></dt>
|
|
<dd>The tape does not rewind or unload after the operation ends. It remains at the current position on the tape drive.
|
|
</dd>
|
|
<dt><b>*UNLOAD</b></dt>
|
|
<dd>The tape is automatically rewound and unloaded after the operation ends. Some optical devices will eject the volume after the operation ends.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CPYPTFCVR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CPYPTFCVR.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
CPYPTFCVR DEV(OPT01) LICPGM(5722SS1) SELECT(*ALL)
|
|
RLS(V5R4M0)
|
|
</pre>
|
|
</p>
|
|
<p>This command copies all cover letters for PTFs that are not applied to product 5722SS1 release V5R4M0 from device OPT01.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CPYPTFCVR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CPYPTFCVR.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF354D</b></dt>
|
|
<dd>Device &1 not allowed.
|
|
</dd>
|
|
<dt><b>CPF3586</b></dt>
|
|
<dd>List of PTFs not correct.
|
|
</dd>
|
|
<dt><b>CPF358A</b></dt>
|
|
<dd>Release not valid.
|
|
</dd>
|
|
<dt><b>CPF359D</b></dt>
|
|
<dd>No PTFs on device &3 met the selection criteria.
|
|
</dd>
|
|
<dt><b>CPF35BE</b></dt>
|
|
<dd>Product &1 &3 not supported or installed.
|
|
</dd>
|
|
<dt><b>CPF35E0</b></dt>
|
|
<dd>Error occurred copying PTF information.
|
|
</dd>
|
|
<dt><b>CPF35F1</b></dt>
|
|
<dd>Cover letter file &1 in &2 not found.
|
|
</dd>
|
|
<dt><b>CPF363C</b></dt>
|
|
<dd>No PTF cover letters copied from device &3.
|
|
</dd>
|
|
<dt><b>CPF9814</b></dt>
|
|
<dd>Device &1 not found.
|
|
</dd>
|
|
<dt><b>CPF9822</b></dt>
|
|
<dd>Not authorized to file &1 in library &2.
|
|
</dd>
|
|
<dt><b>CPF9825</b></dt>
|
|
<dd>Not authorized to device &1.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CPYPTFCVR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|