645 lines
23 KiB
HTML
645 lines
23 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 Program Temporary Fix (CPYPTF)</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="CPYPTF.Top_Of_Page"></a>
|
||
|
|
<h2>Copy Program Temporary Fix (CPYPTF)</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="#CPYPTF.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#CPYPTF.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#CPYPTF.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="CPYPTF"></a>
|
||
|
|
<p>The Copy Program Temporary Fix (CPYPTF) command copies specified program temporary fixes (PTFs) from tape, diskette, optical media, service, or save file to a tape, diskette, optical media, or save file. Each PTF contains one or more objects, including programs, which can be loaded by the Load Program Temporary Fix (LODPTF) command and applied to a product by the Apply Program Temporary Fix (APYPTF) command.
|
||
|
|
</p>
|
||
|
|
<p><b>Restrictions:</b>
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>This command is shipped with public *EXCLUDE authority and the QPGMR, QSYSOPR, QSRV, and QSRVBAS user profiles have private authorities to use the command.
|
||
|
|
</li>
|
||
|
|
<li>If the PTF being copied does not have a target release or if the specified target release is not a valid save and restore release, the PTF will be copied to the earliest valid save and restore target release for the PTF objects.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CPYPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="CPYPTF.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="#CPYPTF.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="#CPYPTF.FROMDEV"><b>FROMDEV</b></a></td>
|
||
|
|
<td valign="top">From device</td>
|
||
|
|
<td valign="top"><i>Name</i>, *SERVICE, *SAVF</td>
|
||
|
|
<td valign="top">Required, Positional 2</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CPYPTF.TODEV"><b>TODEV</b></a></td>
|
||
|
|
<td valign="top">To device</td>
|
||
|
|
<td valign="top"><i>Name</i>, *SAVF</td>
|
||
|
|
<td valign="top">Required, Positional 3</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CPYPTF.SELECT"><b>SELECT</b></a></td>
|
||
|
|
<td valign="top">PTF numbers to select</td>
|
||
|
|
<td valign="top">Single values: *ALL<br>Other values (up to 50 repetitions): <i>Character value</i></td>
|
||
|
|
<td valign="top">Optional, Positional 4</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CPYPTF.OMIT"><b>OMIT</b></a></td>
|
||
|
|
<td valign="top">PTF numbers to omit</td>
|
||
|
|
<td valign="top">Values (up to 50 repetitions): <i>Character value</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CPYPTF.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" rowspan="3"><a href="#CPYPTF.FROMSAVF"><b>FROMSAVF</b></a></td>
|
||
|
|
<td valign="top">From save file</td>
|
||
|
|
<td valign="top"><i>Qualified object name</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Qualifier 1: From save file</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"><a href="#CPYPTF.FROMSEQNBR"><b>FROMSEQNBR</b></a></td>
|
||
|
|
<td valign="top">From tape sequence number</td>
|
||
|
|
<td valign="top">1-16777215, <b><u>*SEARCH</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CPYPTF.FROMENDOPT"><b>FROMENDOPT</b></a></td>
|
||
|
|
<td valign="top">From end of media option</td>
|
||
|
|
<td valign="top"><b><u>*REWIND</u></b>, *LEAVE, *UNLOAD</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CPYPTF.FROMPATHID"><b>FROMPATHID</b></a></td>
|
||
|
|
<td valign="top">From path identifier</td>
|
||
|
|
<td valign="top">1-9999, <b><u>*FIRST</u></b>, *SELECT</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CPYPTF.TOVOL"><b>TOVOL</b></a></td>
|
||
|
|
<td valign="top">Volume identifier</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*MOUNTED</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CPYPTF.TOSEQNBR"><b>TOSEQNBR</b></a></td>
|
||
|
|
<td valign="top">To tape sequence number</td>
|
||
|
|
<td valign="top">1-16777215, <b><u>*END</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CPYPTF.TOENDOPT"><b>TOENDOPT</b></a></td>
|
||
|
|
<td valign="top">To end of media option</td>
|
||
|
|
<td valign="top"><b><u>*REWIND</u></b>, *LEAVE, *UNLOAD</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#CPYPTF.TOSAVF"><b>TOSAVF</b></a></td>
|
||
|
|
<td valign="top">To save file</td>
|
||
|
|
<td valign="top"><i>Qualified object name</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Qualifier 1: To save file</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"><a href="#CPYPTF.CLEAR"><b>CLEAR</b></a></td>
|
||
|
|
<td valign="top">Clear</td>
|
||
|
|
<td valign="top"><b><u>*NONE</u></b>, *ALL</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CPYPTF.COVER"><b>COVER</b></a></td>
|
||
|
|
<td valign="top">Copy PTF cover letter</td>
|
||
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CPYPTF.CVRLTRLNG"><b>CVRLTRLNG</b></a></td>
|
||
|
|
<td valign="top">Cover letter language</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="#CPYPTF.DTACPR"><b>DTACPR</b></a></td>
|
||
|
|
<td valign="top">Data compression</td>
|
||
|
|
<td valign="top"><b><u>*DEV</u></b>, *NO, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CPYPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="CPYPTF.LICPGM"></a>
|
||
|
|
<h3>Product (LICPGM)</h3>
|
||
|
|
<p>Specifies the 7-character identifier of the product for which the PTFs are copied.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CPYPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CPYPTF.FROMDEV"></a>
|
||
|
|
<h3>From device (FROMDEV)</h3>
|
||
|
|
<p>Specifies the name of the device from which the PTFs are copied.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*SERVICE</b></dt>
|
||
|
|
<dd>The PTFs sent from the service support system are copied.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>*SAVF</i></b></dt>
|
||
|
|
<dd>The PTFs are copied from a save file.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>device-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the tape, diskette, or optical device from which the PTFs are copied.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CPYPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CPYPTF.TODEV"></a>
|
||
|
|
<h3>To device (TODEV)</h3>
|
||
|
|
<p>Specifies the device to which the PTFs are copied.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>*SAVF</i></b></dt>
|
||
|
|
<dd>The PTFs are copied to a save file.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>device-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the tape, diskette, or optical device to which the PTFs are copied.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CPYPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CPYPTF.SELECT"></a>
|
||
|
|
<h3>PTF numbers to select (SELECT)</h3>
|
||
|
|
<p>Specifies which PTFs are copied. If individual PTFs are specified, a value cannot be specified for the <b>PTF numbers to omit</b> (OMIT) parameter.
|
||
|
|
</p>
|
||
|
|
<p>You can enter multiple values for this parameter.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>All the PTFs are copied. This parameter cannot be specified when a value of *SERVICE is specified in the <b>From device</b> (FROMDEV) parameter.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>PTF-number</i></b></dt>
|
||
|
|
<dd>Specify the PTF number of each programming fix to be copied. A maximum of 50 PTF numbers can be specified.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CPYPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CPYPTF.OMIT"></a>
|
||
|
|
<h3>PTF numbers to omit (OMIT)</h3>
|
||
|
|
<p>Specifies that all PTFs except for those specified in this parameter are copied. Specify the PTF numbers of the programming fixes not copied when all the rest are copied. A maximum of 50 PTF numbers can be specified. This parameter cannot be specified if single PTF numbers are specified in the <b>PTF numbers to select</b> (SELECT) parameter.
|
||
|
|
</p>
|
||
|
|
<p>You can enter multiple values for this parameter.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CPYPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CPYPTF.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>*ONLY</u></b></dt>
|
||
|
|
<dd>This value is valid only if one release is installed or supported on the system when FROMDEV(*SERVICE) is specified or when the FROMDEV parameter is an optical device and only one release of the product exists on the media. If the FROMDEV parameter is a tape or diskette device, the release level of the software product on the media is ignored.
|
||
|
|
</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="#CPYPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CPYPTF.FROMSAVF"></a>
|
||
|
|
<h3>From save file (FROMSAVF)</h3>
|
||
|
|
<p>Specifies the name and library of the save file from which the PTFs are copied.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This parameter is valid only if *SAVF is specified on the <b>From device</b> (FROMDEV) parameter.
|
||
|
|
</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 save 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 save file is located.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CPYPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CPYPTF.FROMSEQNBR"></a>
|
||
|
|
<h3>From tape sequence number (FROMSEQNBR)</h3>
|
||
|
|
<p>Specifies the sequence number on the tape volume from which the PTFs are copied.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This parameter is valid only if a tape device name is specified on the <b>From device</b> (FROMDEV) parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*SEARCH</b></dt>
|
||
|
|
<dd>The tape volume searches for the first PTF file for the licensed program, and then copies that PTF.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>sequence-number</i></b></dt>
|
||
|
|
<dd>Specify the sequence number where you want to begin to copy the PTF data. This sequence number must exist on the tape. Valid values range from 1 to 16777215.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CPYPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CPYPTF.FROMENDOPT"></a>
|
||
|
|
<h3>From end of media option (FROMENDOPT)</h3>
|
||
|
|
<p>Specifies the operation that is performed on the tape or optical volume after the copy PTF operation ends. If one or more volumes of tape are involved, this parameter applies only to the last volume.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This parameter is valid only if a tape or optical device name is specified on the FROMDEV parameter. 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="#CPYPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CPYPTF.FROMPATHID"></a>
|
||
|
|
<h3>From path identifier (FROMPATHID)</h3>
|
||
|
|
<p>Specifies the number that identifies a file on the optical media that contains the PTFs to be copied. The PTF files for each product and release that exist on the optical media have a path identifier number to allow the files to be processed in a specific order. Only the PTFs from the specified path identifier are copied on your system.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This parameter is valid only if an optical device name is specified on the <b>From device</b> (FROMDEV) parameter.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*FIRST</u></b></dt>
|
||
|
|
<dd>The optical media is searched for the first PTF file for the specified product and release, according to the search dependency specified on the SELECT parameter.
|
||
|
|
<ul>
|
||
|
|
<li>When a specific PTF identifier is specified on the SELECT parameter, the first occurrence of the specified PTF is copied.
|
||
|
|
</li>
|
||
|
|
<li>When *ALL is specified on the SELECT parameter, the existing PTF file with the lowest path identifier is copied.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SELECT</b></dt>
|
||
|
|
<dd>A list of the PTF files that exist on the optical media that match the product and release is shown. You can select the specific file from which PTFs are copied. This value cannot be selected in a batch environment.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>path-identifier</i></b></dt>
|
||
|
|
<dd>Specify the path identifier of the existing PTF file from which to copy the PTF data for the product and release.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CPYPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CPYPTF.TOVOL"></a>
|
||
|
|
<h3>Volume identifier (TOVOL)</h3>
|
||
|
|
<p>Specifies the volume identifier of the tape, diskette or optical volume that receives the copied PTFs.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This parameter is valid only if a tape, diskette, or optical device name is specified on the <b>To device</b> (TODEV) parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*MOUNTED</u></b></dt>
|
||
|
|
<dd>The volume currently placed in the device is used.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>volume-identifier</i></b></dt>
|
||
|
|
<dd>Specify the volume identifier of the tape, diskette or optical volume.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CPYPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CPYPTF.TOSEQNBR"></a>
|
||
|
|
<h3>To tape sequence number (TOSEQNBR)</h3>
|
||
|
|
<p>Specifies the sequence number of the data file that receives the copied PTFs.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This parameter is valid only if a tape device name is specified on the <b>To device</b> (TODEV) parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*END</b></dt>
|
||
|
|
<dd>The PTFs are copied at the end of the tape.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>sequence-number</i></b></dt>
|
||
|
|
<dd>Specify the sequence number of the data file that receives the copied PTFs. Valid values range from 1 through 16777215.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CPYPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CPYPTF.TOENDOPT"></a>
|
||
|
|
<h3>To end of media option (TOENDOPT)</h3>
|
||
|
|
<p>Specifies the operation that is performed on the tape or optical volume after the copy PTF operation ends. If one or more volumes of tape are involved, this parameter applies only to the last volume.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This parameter is valid only if a tape or optical device name is specified on the TODEV parameter. 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="#CPYPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CPYPTF.TOSAVF"></a>
|
||
|
|
<h3>To save file (TOSAVF)</h3>
|
||
|
|
<p>Specifies the name and library of the save file to which the PTFs are copied.
|
||
|
|
</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 save file. If no current library entry exists in the library list, the QGPL library is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>library-name</i></b></dt>
|
||
|
|
<dd>Specify the library where the save file is located.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CPYPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CPYPTF.CLEAR"></a>
|
||
|
|
<h3>Clear (CLEAR)</h3>
|
||
|
|
<p>Specifies whether uncleared save files encountered while copying the PTFs are automatically cleared.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This parameter is valid only if *SAVF is specified on the <b>To device</b> (TODEV) parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>An uncleared save file is not automatically cleared.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>An uncleared save file is automatically cleared so the operation can continue.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CPYPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CPYPTF.COVER"></a>
|
||
|
|
<h3>Copy PTF cover letter (COVER)</h3>
|
||
|
|
<p>Specifies whether to copy the cover letter with the PTF. Cover letters will not be copied if the FROMDEV or TODEV parameter specifies a diskette device or if FROMDEV(*SERVICE) is specified with more than 1 PTF (SELECT parameter).
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*YES</u></b></dt>
|
||
|
|
<dd>The cover letter is copied.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>The cover letter is not copied.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CPYPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CPYPTF.CVRLTRLNG"></a>
|
||
|
|
<h3>Cover letter language (CVRLTRLNG)</h3>
|
||
|
|
<p>Specifies the cover letter language of the PTF to be copied. If FROMDEV(*SERVICE) is specified and there are multiple cover letters for a PTF (multiple languages), specify the language feature code of the cover letter you want to copy.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This parameter is valid only if *YES is specified on the <b>Copy PTF cover letter</b> (COVER) parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ONLY</u></b></dt>
|
||
|
|
<dd>The only cover letter associated with the PTF is copied, regardless of the language feature code.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>feature-code</i></b></dt>
|
||
|
|
<dd>Specify the language feature code of the PTF cover letter you want to copy. A language feature code can be specified only when *SERVICE is specified on the FROMDEV parameter.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CPYPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CPYPTF.DTACPR"></a>
|
||
|
|
<h3>Data compression (DTACPR)</h3>
|
||
|
|
<p>Specifies whether data compression is used.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*DEV</u></b></dt>
|
||
|
|
<dd>If the save is to tape and the target device supports compression, hardware compression is performed. Otherwise, no data compression is performed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>No data compression is performed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>If the save is to tape and the target device supports compression, hardware compression is performed. If compression is not supported, or if the save data is written to a diskette or save file, software compression is performed. If the save is running while other jobs on the system are active and software compression is used, the overall system performance may be affected.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CPYPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CPYPTF.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Copying PTFs to a Save File</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CPYPTF LICPGM(5722SS1) FROMDEV(TAP01)
|
||
|
|
TODEV(*SAVF) SELECT(*ALL) TOSAVF(MYLIB/PTFFILE)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command copies all the PTFs from a tape named TAP01 into a save file named PTFFILE for the product 5722SS1.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Copying PTFs from an optical device</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CPYPTF LICPGM(5722SS1) FROMDEV(OPT01) TODEV(TAP01)
|
||
|
|
SELECT(*ALL) FROMPATHID(2) RLS(*ONLY)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command copies all the PTFs for product 5722SS1 that exist in the file with path identifier 0002 from the optical device named OPT01 to the tape device named TAP01.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CPYPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CPYPTF.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPF35AE</b></dt>
|
||
|
|
<dd>Duplicate PTF &1 found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF35CC</b></dt>
|
||
|
|
<dd>Library required for PTF operation already exists.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF35C2</b></dt>
|
||
|
|
<dd>PTF &1-&2 &3 cannot be included.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF35C3</b></dt>
|
||
|
|
<dd>PTF &1-&2 cannot be included.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF35C4</b></dt>
|
||
|
|
<dd>CPYPTF ended abnormally.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF35C6</b></dt>
|
||
|
|
<dd>TOVOL parameter must be specified.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF35C7</b></dt>
|
||
|
|
<dd>Volume name in FROMDEV device same as TOVOL parameter value.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF35C8</b></dt>
|
||
|
|
<dd>PTF file to be copied is not valid.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF35D5</b></dt>
|
||
|
|
<dd>Cover letter NLV not valid.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF354C</b></dt>
|
||
|
|
<dd>Cannot process PTF files on optical volume.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF354D</b></dt>
|
||
|
|
<dd>Device &1 not allowed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF354F</b></dt>
|
||
|
|
<dd>Required PTF file cannot be processed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3558</b></dt>
|
||
|
|
<dd>Cannot allocate &1 in &3 type *&2.
|
||
|
|
</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>CPF3598</b></dt>
|
||
|
|
<dd>PTF function already in process.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF363A</b></dt>
|
||
|
|
<dd>Media type of volume not valid for operation.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF363D</b></dt>
|
||
|
|
<dd>Multiple cover letters exist for PTF &2-&1 &3.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF363E</b></dt>
|
||
|
|
<dd>Cannot write required PTF file to optical volume.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF6602</b></dt>
|
||
|
|
<dd>PTF &1-&2 &3 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9812</b></dt>
|
||
|
|
<dd>File &1 in library &2 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9814</b></dt>
|
||
|
|
<dd>Device &1 not found.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CPYPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|