ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/cpyptfsavf.htm

200 lines
6.7 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<!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 to Save File (CPYPTFSAVF)</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="CPYPTFSAVF.Top_Of_Page"></a>
<h2>Copy PTF to Save File (CPYPTFSAVF)</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="#CPYPTFSAVF.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CPYPTFSAVF.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CPYPTFSAVF.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CPYPTFSAVF"></a>
<p>The Copy Program Temporary Fixes (PTFs) to Save Files (CPYPTFSAVF) command allows you to copy all or selected PTFs for installed and supported products from a device into PTF save files.
</p>
<p><b>Restrictions:</b>
</p>
<ol>
<li>Only PTFs for installed and supported products are copied.
</li>
</ol>
<p>The following notes provide information on how the command works.
</p>
<p><b>Notes:</b>
</p>
<ol>
<li>A SAVF is created in the QGPL library for each PTF that is copied.
</li>
<li>If the PTF exists, the PTF is not copied.
</li>
<li>When the PTF SAVF is created in the QGPL library, it is named Qxxxxxxx where xxxxxxx is the PTF identification number or time stamp.
</li>
<li>Cover-letter files in the QGPL library are named Qxxxxxxyy, and placed in file QAPZCOVER, where xxxxxxx is the PTF identification number and yy is the language of the PTF. For English cover letters yy is blank.
</li>
</ol>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYPTFSAVF.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CPYPTFSAVF.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="#CPYPTFSAVF.FROMDEV"><b>FROMDEV</b></a></td>
<td valign="top">From device</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#CPYPTFSAVF.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="#CPYPTFSAVF.SELECT"><b>SELECT</b></a></td>
<td valign="top">PTF numbers to select</td>
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values (up to 50 repetitions): <i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CPYPTFSAVF.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>
</table>
<table width="100%">
<tr><td align="right"><a href="#CPYPTFSAVF.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CPYPTFSAVF.FROMDEV"></a>
<h3>From device (FROMDEV)</h3>
<p>Specifies the tape unit or optical device that contains the Program Temporary Fixes (PTFs) to be copied into save files (SAVF). Specify the name of the tape device or optical device.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYPTFSAVF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CPYPTFSAVF.LICPGM"></a>
<h3>Product (LICPGM)</h3>
<p>Specifies the names of the licensed programs for which PTFs are to be copied.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>PTFs for all licensed programs that are installed or supported are copied on to the system.
</dd>
<dt><b>*SUPPTD</b></dt>
<dd>Only PTFs for supported licensed programs are copied.
</dd>
<dt><b><i>licensed-program</i></b></dt>
<dd>Specify the licensed program for which PTFs are copied.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYPTFSAVF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CPYPTFSAVF.SELECT"></a>
<h3>PTF numbers to select (SELECT)</h3>
<p>Specifies which PTFs are to be copied. The OMIT parameter cannot be specified if individual PTF identification numbers are specified on SELECT parameter.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All PTFs are copied.
</dd>
<dt><b><i>PTF-number</i></b></dt>
<dd>Specify the PTF identification number of the PTF to be copied. A maximum of 50 PTF identification numbers can be specified.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYPTFSAVF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CPYPTFSAVF.OMIT"></a>
<h3>PTF numbers to omit (OMIT)</h3>
<p>Specifies that all PTFs are copied except for those specified on this parameter. Up to 50 PTF identification numbers can be specified for omission.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYPTFSAVF.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CPYPTFSAVF.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Copying PTFs for a Specified Program</b>
</p>
<p>
<pre>
CPYPTFSAVF FROMDEV(TAP01) LICPGM(5722SS1)
</pre>
</p>
<p>This command copies all PTFs for the licensed program named 5722SS1 from the device named TAP01 into save files on the system.
</p>
<p><b>Example 2: Copying All PTFs</b>
</p>
<p>
<pre>
CPYPTFSAVF FROMDEV(TAP01) LICPGM(*ALL)
</pre>
</p>
<p>This command copies all PTFs for all supported products from the device named TAP01 to a save file on the system.
</p>
<p><b>Example 3: Copying PTFs for a Supported Product</b>
</p>
<p>
<pre>
CPYPTFSAVF FROMDEV(TAP01) LICPGM(*SUPPTD)
</pre>
</p>
<p>This command copies PTFs for all supported products from the device named TAP01 to a save file on the system.
</p>
<p><b>Example 4: Copying a Specific PTF</b>
</p>
<p>
<pre>
CPYPTFSAVF FROMDEV(OPT01) LICPGM(5722SS1) SELECT(PTF0001)
</pre>
</p>
<p>This command copies only the PTF named PTF0001 for the licensed program named 5722SS1 from the device named OPT01 to a save file on the system.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYPTFSAVF.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CPYPTFSAVF.ERROR.MESSAGES">Error messages</a> </h3>
<p>None
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYPTFSAVF.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>