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

500 lines
16 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>Create PTF Package (CRTPTFPKG)</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="CRTPTFPKG.Top_Of_Page"></a>
<h2>Create PTF Package (CRTPTFPKG)</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="#CRTPTFPKG.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CRTPTFPKG.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CRTPTFPKG.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CRTPTFPKG"></a>
<p>The Create Program Temporary Fix Package (CRTPTFPKG) command creates a package of program temporary fixes (PTFs).
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPTFPKG.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CRTPTFPKG.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" rowspan="3"><a href="#CRTPTFPKG.OUTFILE"><b>OUTFILE</b></a></td>
<td valign="top">Package output file</td>
<td valign="top"><i>Qualified object name</i></td>
<td valign="top" rowspan="3">Required, Positional 1</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Package output 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" rowspan="3"><a href="#CRTPTFPKG.OUTMBR"><b>OUTMBR</b></a></td>
<td valign="top">Package output member</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Member</td>
<td valign="top">
<i>Name</i>, <b><u>*FIRST</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: Replace or add records</td>
<td valign="top">
<b><u>*REPLACE</u></b>, *ADD</td>
</tr>
<tr>
<td valign="top" rowspan="5"><a href="#CRTPTFPKG.SELECT"><b>SELECT</b></a></td>
<td valign="top">PTFs to select file</td>
<td valign="top">Single values: <b><u>*SUPPTD</u></b><br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="5">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: File</td>
<td valign="top">
<i>Qualified object name</i></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Qualifier 1: File</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top" style="padding-left:10pt">Qualifier 2: Library</td>
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
</tr><tr>
<td valign="top">Element 2: Member</td>
<td valign="top">
<i>Name</i>, <b><u>*FIRST</u></b></td>
</tr>
<tr>
<td valign="top" rowspan="5"><a href="#CRTPTFPKG.OMIT"><b>OMIT</b></a></td>
<td valign="top">PTFs to omit file</td>
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="5">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: File</td>
<td valign="top">
<i>Qualified object name</i></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Qualifier 1: File</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top" style="padding-left:10pt">Qualifier 2: Library</td>
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
</tr><tr>
<td valign="top">Element 2: Member</td>
<td valign="top">
<i>Name</i>, <b><u>*FIRST</u></b></td>
</tr>
<tr>
<td valign="top"><a href="#CRTPTFPKG.SUPERSEDE"><b>SUPERSEDE</b></a></td>
<td valign="top">Replace Superseded PTFs</td>
<td valign="top">*NO, <b><u>*YES</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTPTFPKG.PREREQ"><b>PREREQ</b></a></td>
<td valign="top">Include prerequisite PTFs</td>
<td valign="top"><b><u>*ALL</u></b>, *NONE, *SAMEPRD</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTPTFPKG.DEV"><b>DEV</b></a></td>
<td valign="top">Device</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTPTFPKG.VOL"><b>VOL</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="#CRTPTFPKG.SEQNBR"><b>SEQNBR</b></a></td>
<td valign="top">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="#CRTPTFPKG.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>
<tr>
<td valign="top"><a href="#CRTPTFPKG.COVER"><b>COVER</b></a></td>
<td valign="top">Cover letter NLV</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CRTPTFPKG.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CRTPTFPKG.OUTFILE"></a>
<h3>Package output file (OUTFILE)</h3>
<p>Specifies the physical database file to which the list of PTFs contained in the package is directed. If the output file does not exist, the system creates it.
</p>
<p>The name of the file can be qualified by one of the following library values:
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>All libraries in the job's library list are searched until the first match is found.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is searched. 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 name of the library to be searched.
</dd>
</dl>
<p>The possible file name value is:
</p>
<dl>
<dt><b><i>file-name</i></b></dt>
<dd>Specify the name of the file that receives the list of PTFs contained in the package.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPTFPKG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPTFPKG.OUTMBR"></a>
<h3>Package output member (OUTMBR)</h3>
<p>Specifies the name of the database file member to which the list of PTFs contained in the package is directed.
</p>
<p>The possible <b>Member Name</b> values are:
</p>
<dl>
<dt><b><u>*FIRST</u></b></dt>
<dd>The first member in the file receives the list of PTFs contained in the package. If the file does not contain a member, the system creates one.
</dd>
<dt><b><i>member-name</i></b></dt>
<dd>Specify the database file member which receives the list. If the member does not exist, it is added.
</dd>
</dl>
<p>The possible <b>Add or Replace Records</b> values are:
</p>
<dl>
<dt><b><u>*REPLACE</u></b></dt>
<dd>The output data replaces any existing records in the specified file member.
</dd>
<dt><b>*ADD</b></dt>
<dd>The output data is added to the end of any existing records in the specified file member.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPTFPKG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPTFPKG.SELECT"></a>
<h3>PTFs to select file (SELECT)</h3>
<p>Specifies the database file containing the list from which PTFs are selected.
</p>
<p><b>Note:</b>
</p>
<p>If a PTF has had another take its place the most current PTF is selected.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*SUPPTD</u></b></dt>
<dd>The system generates the list of PTFs from which to select. The list contains all PTFs for all the products supported on the system.
</dd>
</dl>
<p><b>Element 1: File Name</b>
</p>
<p>The name of the file can be qualified by one of the following library values:
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>All libraries in the job's library list are searched until the first match is found.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is used searched. 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 name of the library to be searched.
</dd>
<dt><b><i>file-name</i></b></dt>
<dd>Specify the name of the file containing the list from which PTFs are selected.
</dd>
</dl>
<p><b>Element 2: File Member</b>
</p>
<dl>
<dt><b><u>*FIRST</u></b></dt>
<dd>The first member in the file contains the list of PTFs from which to select. If the file does not contain a member, it is created.
</dd>
<dt><b><i>member-name</i></b></dt>
<dd>Specify the database file member containing the list of PTFs from which to select. If the member does not exist, it is created.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPTFPKG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPTFPKG.OMIT"></a>
<h3>PTFs to omit file (OMIT)</h3>
<p>Specifies the database file which contains the list of PTFs to omit from the package. The PTFs listed in this file that also exist in the file specified on the SELECT parameter are omitted from the package. Only prerequisites and corequisites that are needed on the system are selected.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>All PTFs listed in the file specified on the SELECT parameter are included in the package.
</dd>
</dl>
<p><b>Element 1: File Name</b>
</p>
<p>The name of the file can be qualified by one of the following library values:
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>All libraries in the job's library list are searched until the first match is found.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is searched. 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 name of the library to be searched.
</dd>
</dl>
<p>The possible value for the file name is:
</p>
<dl>
<dt><b><i>file-name</i></b></dt>
<dd>Specify the name of the file containing the list of PTFs to omit.
</dd>
</dl>
<p><b>Element 2: File Member</b>
</p>
<dl>
<dt><b><u>*FIRST</u></b></dt>
<dd>The first member in the file contains the list of PTFs to omit. If the file does not contain a member, one is created.
</dd>
<dt><b><i>member-name</i></b></dt>
<dd>Specify the database file member containing the list of PTFs to omit. If the member does not exist, it is created.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPTFPKG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPTFPKG.SUPERSEDE"></a>
<h3>Replace Superseded PTFs (SUPERSEDE)</h3>
<p>Specifies whether superseding PTFs are packaged in place of superseded PTFs.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*YES</u></b></dt>
<dd>Any superseding PTFs are packaged in place of the superseded PTFs.
</dd>
<dt><b>*NO</b></dt>
<dd>Superseding PTFs are not packaged in place of the superseded PTFs.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPTFPKG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPTFPKG.PREREQ"></a>
<h3>Include prerequisite PTFs (PREREQ)</h3>
<p>Specifies whether prerequisite PTFs are included in the package. If prerequisite PTFs are included in the package,then corequisite PTFs also are included.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>Include all prerequisite and corequisite PTFs in this package.
</dd>
<dt><b>*NONE</b></dt>
<dd>No prerequisites and corequisites are included in the package.
</dd>
<dt><b>*SAMEPRD</b></dt>
<dd>Prerequisites and corequisites that are in the same product as the PTFs are included in the package.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPTFPKG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPTFPKG.DEV"></a>
<h3>Device (DEV)</h3>
<p>Specifies the name of the device to which the PTF package is saved.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>Only the package output file is generated.
</dd>
<dt><b><i>device-name</i></b></dt>
<dd>Specify the name of the device to which the package is saved.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPTFPKG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPTFPKG.VOL"></a>
<h3>Volume identifier (VOL)</h3>
<p>Specifies the volume identifier.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*MOUNTED</u></b></dt>
<dd>The volume currently placed in the device is used.
</dd>
<dt><b><i>volume-identifier</i></b></dt>
<dd>Specify the volume ID.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPTFPKG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPTFPKG.SEQNBR"></a>
<h3>Sequence number (SEQNBR)</h3>
<p>Specifies the sequence number of the data file that receives the saved package.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*END</u></b></dt>
<dd>The system saves the package after the last sequence number on the tape.
</dd>
<dt><b><i>sequence-number</i></b></dt>
<dd>Specify the sequence number of the file. Valid values range from 1 through 16777215.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPTFPKG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPTFPKG.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 operation ends.
</p>
<p>
<b>Note: </b>This parameter is only valid if a tape or optical device name is specified on the DEV 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="#CRTPTFPKG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPTFPKG.COVER"></a>
<h3>Cover letter NLV (COVER)</h3>
<p>Specifies the language used to select the cover letters for this PTF package.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>Cover letters are not saved.
</dd>
<dt><b><i>29xx</i></b></dt>
<dd>Specify the national language version (NLV) of cover letters being saved.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPTFPKG.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTPTFPKG.COMMAND.EXAMPLES">Examples</a> </h3>
<p>Before you can use the CRTPTFPKG command, an output file must be created on the service requester by running the Display PTF (DSPPTF) command and directing the output to a file. For the following examples, output file MYOUTF is created by running the following command:
</p>
<p>
<pre>
DSPPTF OUTPUT(MYOUTF) OUTFILE(MYOUTF)
</pre>
</p>
<p><b>Example 1: Creating a PTF Package to Tape</b>
</p>
<p>
<pre>
CRTPTFPKG OUTFILE(MYOUTF) DEV(TAP01)
</pre>
</p>
<p>This command creates a tape with all PTFs that are currently on the service provider but not on the service requester.
</p>
<p><b>Example 2: Creating a PTF Package to Optical</b>
</p>
<p>
<pre>
CRTPTFPKG OUTFILE(MYOUTF) DEV(OPT01)
</pre>
</p>
<p>This command creates an optical media with all PTFs that are currently on the service provider but not on the service requester.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPTFPKG.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTPTFPKG.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>SMU1423</b></dt>
<dd>No products currently supported.
</dd>
<dt><b>SMU1424</b></dt>
<dd>Program Temporary Fix (PTF) package not created.
</dd>
<dt><b>SMU1431</b></dt>
<dd>No PTFs selected for the package.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPTFPKG.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>