636 lines
23 KiB
HTML
636 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 PTF Group (CPYPTFGRP)</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="CPYPTFGRP.Top_Of_Page"></a>
|
|
<h2>Copy PTF Group (CPYPTFGRP)</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="#CPYPTFGRP.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CPYPTFGRP.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CPYPTFGRP.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CPYPTFGRP"></a>
|
|
<p>The Copy Program Temporary Fix Group (CPYPTFGRP) command copies program temporary fix (PTF) groups from tape, optical, save file, or service, to tape, optical, save file, or service. The PTF group information is copied to the specified device. The PTFs named within the PTF group can also be copied using the CPYPTF parameter. The Work with PTF Groups (WRKPTFGRP) command can be used to display and work with a list of PTF groups on the system.
|
|
</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>
|
|
</ol>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CPYPTFGRP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CPYPTFGRP.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="#CPYPTFGRP.PTFGRP"><b>PTFGRP</b></a></td>
|
|
<td valign="top">PTF group</td>
|
|
<td valign="top"><i>Character value</i>, *ALL</td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CPYPTFGRP.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="#CPYPTFGRP.TODEV"><b>TODEV</b></a></td>
|
|
<td valign="top">To device</td>
|
|
<td valign="top"><i>Name</i>, *SERVICE, *SAVF</td>
|
|
<td valign="top">Required, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CPYPTFGRP.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="#CPYPTFGRP.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="#CPYPTFGRP.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="#CPYPTFGRP.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="#CPYPTFGRP.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="#CPYPTFGRP.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="#CPYPTFGRP.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="#CPYPTFGRP.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="#CPYPTFGRP.REPLACE"><b>REPLACE</b></a></td>
|
|
<td valign="top">Replace</td>
|
|
<td valign="top"><b><u>*LVLGT</u></b>, *NO, *YES</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CPYPTFGRP.RELPTFGRP"><b>RELPTFGRP</b></a></td>
|
|
<td valign="top">Copy related PTF groups</td>
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CPYPTFGRP.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>
|
|
<tr>
|
|
<td valign="top"><a href="#CPYPTFGRP.CPYPTF"><b>CPYPTF</b></a></td>
|
|
<td valign="top">Copy PTFs</td>
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CPYPTFGRP.RPLSPR"><b>RPLSPR</b></a></td>
|
|
<td valign="top">Replace superseded PTFs</td>
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CPYPTFGRP.COVER"><b>COVER</b></a></td>
|
|
<td valign="top">Copy PTF cover letter</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*DFT</u></b>, *NONE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CPYPTFGRP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CPYPTFGRP.PTFGRP"></a>
|
|
<h3>PTF group (PTFGRP)</h3>
|
|
<p>Specifies the name of the PTF group(s) to be copied.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>PTF-group-name</i></b></dt>
|
|
<dd>Specify the name of the PTF group to be copied.
|
|
</dd>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All PTF groups are copied.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CPYPTFGRP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CPYPTFGRP.FROMDEV"></a>
|
|
<h3>From device (FROMDEV)</h3>
|
|
<p>Specifies the name of the device that contains the PTF groups to be copied.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*SERVICE</b></dt>
|
|
<dd>The PTF groups are copied from the system. The Work with PTF Groups (WRKPTFGRP) command can be used to display the list of PTF groups on the system.
|
|
</dd>
|
|
<dt><b><i>*SAVF</i></b></dt>
|
|
<dd>The PTF groups are copied from a save file.
|
|
</dd>
|
|
<dt><b><i>device-name</i></b></dt>
|
|
<dd>Specify the name of the tape or optical device from which the PTF groups are copied.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CPYPTFGRP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CPYPTFGRP.TODEV"></a>
|
|
<h3>To device (TODEV)</h3>
|
|
<p>Specifies the device to which the PTF groups are copied.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>*SERVICE</i></b></dt>
|
|
<dd>The PTF groups are copied to the system. The Work with PTF Groups (WRKPTFGRP) command can be used to display the list of PTF groups on the system. TODEV(*SERVICE) cannot be specified when FROMDEV(*SERVICE) is specified.
|
|
</dd>
|
|
<dt><b><i>*SAVF</i></b></dt>
|
|
<dd>The PTF groups are copied to a save file.
|
|
</dd>
|
|
<dt><b><i>device-name</i></b></dt>
|
|
<dd>Specify the name of the tape or optical device to which the PTF groups are copied.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CPYPTFGRP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CPYPTFGRP.FROMSAVF"></a>
|
|
<h3>From save file (FROMSAVF)</h3>
|
|
<p>Specifies the name and library of the save file from which the PTF groups 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="#CPYPTFGRP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CPYPTFGRP.FROMSEQNBR"></a>
|
|
<h3>From tape sequence number (FROMSEQNBR)</h3>
|
|
<p>Specifies the sequence number on the tape volume from which the PTF groups 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><u>*SEARCH</u></b></dt>
|
|
<dd>The tape volume is searched for the first media file for the specified PTF group.
|
|
</dd>
|
|
<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="#CPYPTFGRP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CPYPTFGRP.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 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="#CPYPTFGRP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CPYPTFGRP.TOVOL"></a>
|
|
<h3>Volume identifier (TOVOL)</h3>
|
|
<p>Specifies the volume identifier of the tape or optical volume that receives the copied PTF groups.
|
|
</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 or optical volume.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CPYPTFGRP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CPYPTFGRP.TOSEQNBR"></a>
|
|
<h3>To tape sequence number (TOSEQNBR)</h3>
|
|
<p>Specifies the sequence number of the data file that receives the copied PTF group.
|
|
</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 PTF groups are copied starting 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 first copied PTF group. Valid values range from 1 through 16777215.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CPYPTFGRP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CPYPTFGRP.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 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 <b>To device</b> (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="#CPYPTFGRP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CPYPTFGRP.TOSAVF"></a>
|
|
<h3>To save file (TOSAVF)</h3>
|
|
<p>Specifies the name and library of the save file to which the PTF groups are copied.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is valid only if *SAVF is specified on the <b>To device</b> (TODEV) 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 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="#CPYPTFGRP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CPYPTFGRP.CLEAR"></a>
|
|
<h3>Clear (CLEAR)</h3>
|
|
<p>Specifies whether an uncleared save file is automatically cleared while copying the PTF groups. This parameter applies only when TODEV(*SAVF) is specified.
|
|
</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="#CPYPTFGRP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CPYPTFGRP.REPLACE"></a>
|
|
<h3>Replace (REPLACE)</h3>
|
|
<p>Specifies what to do if a PTF group being copied already exists on the system. If a PTF group does not already exist on the system, it will be copied. This parameter applies only when TODEV(*SERVICE) is specified.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LVLGT</u></b></dt>
|
|
<dd>Copy an existing PTF group of the same name only when the level of the PTF group being copied is greater than the level of the PTF group on the system.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>Do not replace an existing PTF group of the same name. An error will occur if a PTF group of the same name already exists on the system and PTFGRP(*ALL) is not specified.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>Replace an existing PTF group of the same name regardless of the level.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CPYPTFGRP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CPYPTFGRP.RELPTFGRP"></a>
|
|
<h3>Copy related PTF groups (RELPTFGRP)</h3>
|
|
<p>Specifies whether to copy related PTF groups. This parameter applies only when FROMDEV(*SERVICE) is specified.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>The related PTF groups named within the specified PTF group are not copied.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>The related PTF groups named within the specified PTF group are copied. Any related PTF groups named within related PTF groups are also copied.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CPYPTFGRP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CPYPTFGRP.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="#CPYPTFGRP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CPYPTFGRP.CPYPTF"></a>
|
|
<h3>Copy PTFs (CPYPTF)</h3>
|
|
<p>Specifies whether to copy PTFs named within the specified PTF group in addition to the PTF group information. This parameter applies only when FROMDEV(*SERVICE) is specified and a tape or optical device name is specified on the TODEV parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>The PTFs named within the specified PTF group are not copied.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>The PTFs named within the specified PTF group are copied. All prerequisite, corequisite, and distribution requisite PTFs for PTFs named within the PTF group are also copied. A PTF is copied only if it is for a supported or installed product and a save file exists on the system for the PTF or a superseding PTF.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CPYPTFGRP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CPYPTFGRP.RPLSPR"></a>
|
|
<h3>Replace superseded PTFs (RPLSPR)</h3>
|
|
<p>Specifies whether to replace PTFs or requisites of PTFs named within the specified PTF group. A PTF can be replaced if a save file is not found and a superseding PTF with a save file exists on the system. This parameter applies only when CPYPTF(*YES) is specified.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*YES</u></b></dt>
|
|
<dd>When copying PTFs, if a PTF or requisite of a PTF named within the specified PTF group does not have a save file, replace the PTF with the latest superseding PTF that has a save file. If a PTF or requisite of a PTF named within the PTF group has a save file, the PTF will be copied regardless of whether the PTF is superseded or has a later superseding PTF.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>When copying PTFs, do not replace PTFs that do not have a save file on the system. Save files must exist for all PTFs and requisites of PTFs named within the specified PTF group.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CPYPTFGRP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CPYPTFGRP.COVER"></a>
|
|
<h3>Copy PTF cover letter (COVER)</h3>
|
|
<p>Specifies whether to copy the cover letters with the PTFs. This parameter applies only when CPYPTF(*YES) is specified.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*DFT</u></b></dt>
|
|
<dd>Cover letters are copied using the default language feature code. If there is only one cover letter for the PTF, it will be copied. If there is more than one cover letter for the PTF, the following criteria will be used to determine which cover letter to copy.
|
|
<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, no cover letter is copied for the PTF.
|
|
</p>
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>No PTF cover letters are copied.
|
|
</dd>
|
|
<dt><b><i>feature-code</i></b></dt>
|
|
<dd>Specify the language feature code of the PTF cover letters you want to copy. If a cover letter for the selected language feature code is not available, no cover letter is copied for the PTF.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CPYPTFGRP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CPYPTFGRP.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Copying a PTF Group to a Save File</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CPYPTFGRP PTFGRP(SF99100) FROMDEV(*SERVICE) TODEV(*SAVF)
|
|
TOSAVF(MYLIB/MYSAVF)
|
|
</pre>
|
|
</p>
|
|
<p>This command copies the PTF group named SF99100 from the system to a save file named MYSAVF in library MYLIB. Related PTF groups named in SF99100 are not copied.
|
|
</p>
|
|
<p><b>Example 2: Copying a PTF Group to a Tape</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CPYPTFGRP PTFGRP(SF99200) FROMDEV(*SERVICE) TODEV(TAP01)
|
|
TOSEQNBR(1) RELPTFGRP(*YES) CPYPTF(*YES)
|
|
</pre>
|
|
</p>
|
|
<p>This command copies the PTF group named SF99200 and all of its related PTF groups from the system to the tape mounted in device TAP01 beginning with sequence number 1. All PTFs named within the PTF groups are copied to the tape. Cover letters are copied for the PTFs using the default language feature code.
|
|
</p>
|
|
<p><b>Example 3: Copying All PTF Groups from Optical</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CPYPTFGRP PTFGRP(*ALL) FROMDEV(OPT01) TODEV(*SERVICE)
|
|
REPLACE(*YES)
|
|
</pre>
|
|
</p>
|
|
<p>This command copies all the PTF groups from the volume mounted on optical device OPT01 to the system. Any PTF groups that already exist on the system are replaced.
|
|
</p>
|
|
<p><b>Example 4: Copying a PTF Group from Tape to Save File</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CPYPTFGRP PTFGRP(SF99300) FROMDEV(TAP01) TODEV(*SAVF)
|
|
TOSAVF(MYLIB/MYSAVF)
|
|
</pre>
|
|
</p>
|
|
<p>This command searches the tape mounted on device TAP01 and copies PTF group SF99300 to save file MYSAVF in library MYLIB.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CPYPTFGRP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CPYPTFGRP.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF35CC</b></dt>
|
|
<dd>Library required for PTF operation already exists.
|
|
</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>CPF355D</b></dt>
|
|
<dd>PTF group does not exist on save/restore media.
|
|
</dd>
|
|
<dt><b>CPF355E</b></dt>
|
|
<dd>CPYPTFGRP ended abnormally.
|
|
</dd>
|
|
<dt><b>CPF355F</b></dt>
|
|
<dd>TODEV and FROMDEV parameters cannot specify the same device.
|
|
</dd>
|
|
<dt><b>CPF3598</b></dt>
|
|
<dd>PTF function already in process.
|
|
</dd>
|
|
<dt><b>CPF36AB</b></dt>
|
|
<dd>No PTF groups found.
|
|
</dd>
|
|
<dt><b>CPF36A3</b></dt>
|
|
<dd>PTF group &1 already exists.
|
|
</dd>
|
|
<dt><b>CPF36A4</b></dt>
|
|
<dd>PTF group &1 not found.
|
|
</dd>
|
|
<dt><b>CPF36A5</b></dt>
|
|
<dd>Information for PTF group &1 not complete.
|
|
</dd>
|
|
<dt><b>CPF36A6</b></dt>
|
|
<dd>PTF group name &1 not valid.
|
|
</dd>
|
|
<dt><b>CPF36B8</b></dt>
|
|
<dd>PTF &2-&3 &4 cannot be copied without a save file.
|
|
</dd>
|
|
<dt><b>CPF363A</b></dt>
|
|
<dd>Media type of volume not valid for operation.
|
|
</dd>
|
|
<dt><b>CPF363E</b></dt>
|
|
<dd>Cannot write required PTF file to optical volume.
|
|
</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>
|
|
<dt><b>OPT1660</b></dt>
|
|
<dd>Optical device &1 is empty.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CPYPTFGRP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|