746 lines
26 KiB
HTML
746 lines
26 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>Create Program Temporary Fix (CRTPTF)</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="CRTPTF.Top_Of_Page"></a>
|
||
|
|
<h2>Create Program Temporary Fix (CRTPTF)</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="#CRTPTF.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#CRTPTF.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#CRTPTF.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="CRTPTF"></a>
|
||
|
|
<p>The Create Program Temporary Fix (CRTPTF) command creates a temporary fix for a product that you have developed. The product must be created and installed before using this command.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="CRTPTF.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="#CRTPTF.PTF"><b>PTF</b></a></td>
|
||
|
|
<td valign="top">PTF identifier</td>
|
||
|
|
<td valign="top"><i>Character value</i></td>
|
||
|
|
<td valign="top">Required, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTPTF.LICPGM"><b>LICPGM</b></a></td>
|
||
|
|
<td valign="top">Product</td>
|
||
|
|
<td valign="top"><i>Character value</i></td>
|
||
|
|
<td valign="top">Required, Positional 2</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTPTF.RLS"><b>RLS</b></a></td>
|
||
|
|
<td valign="top">Release level</td>
|
||
|
|
<td valign="top"><i>Character value</i></td>
|
||
|
|
<td valign="top">Required, Positional 3</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTPTF.OPTION"><b>OPTION</b></a></td>
|
||
|
|
<td valign="top">Option</td>
|
||
|
|
<td valign="top">1-99, <b><u>*BASE</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTPTF.LODID"><b>LODID</b></a></td>
|
||
|
|
<td valign="top">Load ID</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*CODEDFT</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#CRTPTF.PTFOBJ"><b>PTFOBJ</b></a></td>
|
||
|
|
<td valign="top">PTF objects</td>
|
||
|
|
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 300 repetitions): <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Object name</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Name</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Object type</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#CRTPTF.OBJLIB"><b>OBJLIB</b></a></td>
|
||
|
|
<td valign="top">Object libraries</td>
|
||
|
|
<td valign="top"><i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Development library</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Name</i>, <b><u>*CURLIB</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Primary library</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Name</i>, <b><u>*PRINCIPAL</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#CRTPTF.PTFDOC"><b>PTFDOC</b></a></td>
|
||
|
|
<td valign="top">PTF documents</td>
|
||
|
|
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 300 repetitions): <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Document</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Folder</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="4"><a href="#CRTPTF.DIROBJ"><b>DIROBJ</b></a></td>
|
||
|
|
<td valign="top">Objects in a directory</td>
|
||
|
|
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 30 repetitions): <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="4">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Product Directory</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Path name</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Development Directory</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Path name</i>, <b><u>*PRDDIR</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 3: Object</td>
|
||
|
|
<td valign="top">
|
||
|
|
Values (up to 100 repetitions): <i>Character value</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="6"><a href="#CRTPTF.COVER"><b>COVER</b></a></td>
|
||
|
|
<td valign="top">Cover letters</td>
|
||
|
|
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 50 repetitions): <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="6">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Source cover letter file</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Qualified object name</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Qualifier 1: Source cover letter 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></td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top">Element 2: Source cover letter member</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Name</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 3: National language version</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTPTF.PREREQ"><b>PREREQ</b></a></td>
|
||
|
|
<td valign="top">Prerequisite PTFs</td>
|
||
|
|
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 300 repetitions): <i>Character value</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTPTF.COREQ"><b>COREQ</b></a></td>
|
||
|
|
<td valign="top">Corequisite PTFs</td>
|
||
|
|
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 300 repetitions): <i>Character value</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="7"><a href="#CRTPTF.EXITPGM"><b>EXITPGM</b></a></td>
|
||
|
|
<td valign="top">PTF exit programs</td>
|
||
|
|
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 50 repetitions): <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="7">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Program</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Qualified object name</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Qualifier 1: Program</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>*CURLIB</u></b></td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top">Element 2: Run option</td>
|
||
|
|
<td valign="top">
|
||
|
|
<b><u>*BOTH</u></b>, *APPLY, *REMOVE, *PREAPY, *PRERMV, *PREBTH</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 3: Type</td>
|
||
|
|
<td valign="top">
|
||
|
|
<b><u>*PTF</u></b>, *OBJLST</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 4: User data</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i>, <b><u>*NONE</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTPTF.TGTRLS"><b>TGTRLS</b></a></td>
|
||
|
|
<td valign="top">Target release</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*CURRENT</u></b>, *PRV</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="CRTPTF.PTF"></a>
|
||
|
|
<h3>PTF identifier (PTF)</h3>
|
||
|
|
<p>Specifies the identifier (ID) of the PTF being created. The PTF ID must be in the valid range for the specified product and release.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPTF.LICPGM"></a>
|
||
|
|
<h3>Product (LICPGM)</h3>
|
||
|
|
<p>Specifies the product ID for which the PTF is being created.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPTF.RLS"></a>
|
||
|
|
<h3>Release level (RLS)</h3>
|
||
|
|
<p>Specifies the version, release, and modification level of the product the PTF is being created for.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPTF.OPTION"></a>
|
||
|
|
<h3>Option (OPTION)</h3>
|
||
|
|
<p>Specifies whether the PTF is for the base product or an option of the base product.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*BASE</u></b></dt>
|
||
|
|
<dd>The PTF is for the base option.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>product-option-number</i></b></dt>
|
||
|
|
<dd>Specify the product option of the PTF being created.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPTF.LODID"></a>
|
||
|
|
<h3>Load ID (LODID)</h3>
|
||
|
|
<p>Specifies the load ID for the PTF being created.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*CODEDFT</b></dt>
|
||
|
|
<dd>The default code load ID, 5001, is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>load-ID</i></b></dt>
|
||
|
|
<dd>Specify a language load ID or a valid code load ID. For a language load, the load ID must be one of the valid IBM national language versions and be specified in the form 29xx. For a code load, the load ID must range from 5001 to 9999.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPTF.PTFOBJ"></a>
|
||
|
|
<h3>PTF objects (PTFOBJ)</h3>
|
||
|
|
<p>Specifies the objects to be contained in the PTF. The objects must be listed with their associated object type. They must exist in the development library specified and the primary library specified on the OBJLIB parameter. A maximum of 300 objects can be specified.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No objects are specified for the PTF.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible PTF object name values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>object-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the PTF object.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible PTF object type values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>object-type</i></b></dt>
|
||
|
|
<dd>Specify the PTF object type.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPTF.OBJLIB"></a>
|
||
|
|
<h3>Object libraries (OBJLIB)</h3>
|
||
|
|
<p>Specifies the development library and primary library for this PTF.
|
||
|
|
</p>
|
||
|
|
<p>The possible development library values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*CURLIB</u></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>development-library</i></b></dt>
|
||
|
|
<dd>Specify the library where the PTF objects are located.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible primary library values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*PRINCIPAL</u></b></dt>
|
||
|
|
<dd>The PTF objects are associated with the principal library of the specified product option.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>primary-library</i></b></dt>
|
||
|
|
<dd>Specify the product library with which the PTF objects are associated.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPTF.PTFDOC"></a>
|
||
|
|
<h3>PTF documents (PTFDOC)</h3>
|
||
|
|
<p>Specifies the documents to be contained in the PTF. A maximum of 300 documents can be specified.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No documents are specified for the PTF.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible PTF document name values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>document-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the document.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible PTF folder name values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>folder-name</i></b></dt>
|
||
|
|
<dd>Specify the folder in which the PTF document will be installed. The create PTF function will append "/QP" to the folder name specified and save the document from the resulting subfolder.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPTF.DIROBJ"></a>
|
||
|
|
<h3>Objects in a directory (DIROBJ)</h3>
|
||
|
|
<p>Specifies the product directory that the PTF is for, the development directory where the PTF is found, and the names of objects in the development directory that are included in the PTF.
|
||
|
|
</p>
|
||
|
|
<p>Up to 30 repetitions are permitted. A product directory, a development directory, and at least one object name must be specified unless DIROBJ(*NONE) is specified.
|
||
|
|
</p>
|
||
|
|
<p>The following restrictions exist when you are assigning directory names:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>You cannot specify /QSYS.LIB and /QDLS directories
|
||
|
|
</li>
|
||
|
|
<li>You must specify unique path names
|
||
|
|
</li>
|
||
|
|
<li>Do not begin or end the path name with a forward slash
|
||
|
|
</li>
|
||
|
|
<li>Do not use a blank in the directory path name
|
||
|
|
</li>
|
||
|
|
<li>Do not use any of the character combinations of "." or ".." in the directory path name.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>A backslash (\) in the directory name is always converted to a forward slash (/). A trailing slash is always ignored. Imbedded blanks and the following characters are not allowed in a directory name:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>Asterisk (*)
|
||
|
|
</li>
|
||
|
|
<li>Question mark (?)
|
||
|
|
</li>
|
||
|
|
<li>Apostrophe (')
|
||
|
|
</li>
|
||
|
|
<li>Quotation mark (")
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>If the leading slash (/) is omitted, one will be assumed, and the inclusion of this leading slash must not cause the directory name to exceed the maximum directory name length of 240 characters. The directory name may indicate a directory that is nested in other directories, for example, /A/B/C. The maximum directory name length includes all slashes and all nested directory names.
|
||
|
|
</p>
|
||
|
|
<p>The possible single value is:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>The PTF includes no objects that will be stored in directories when the PTF is applied.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 1: Product Directory Name</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>directory-name</i></b></dt>
|
||
|
|
<dd>Specify the directory defined by the product which is the default directory where the objects will reside when the PTF is applied. The original objects are replaced with new objects.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Development Directory Name</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*PRDDIR</u></b></dt>
|
||
|
|
<dd>The development directory is the same as the product directory.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>directory-name</i></b></dt>
|
||
|
|
<dd>Specifies the directory where objects that will be included in the PTF currently reside.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 3: Object Name</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>object-name</i></b></dt>
|
||
|
|
<dd>Specifies the list of objects in the development directory that are included in this PTF. Up to 100 object names can be specified for each development directory. If more than 100 objects need to be included for a given product directory,the development directory combination can be specified again using a different set of object names.
|
||
|
|
<p>A given object name must be specified no more than once.
|
||
|
|
</p>
|
||
|
|
<p>Objects names are limited to a maximum of 255 characters.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPTF.COVER"></a>
|
||
|
|
<h3>Cover letters (COVER)</h3>
|
||
|
|
<p>Specifies the file containing the source text for the PTF cover letter. A member is added to the PTF cover letter file QAPZCOVER in library QGPL. The source text data, PTF language, the data that takes the place of the data, and the requisite information is copied to the member. A maximum of 50 cover letters can be specified.
|
||
|
|
</p>
|
||
|
|
<p>The possible single value is:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No cover letters are specified for this PTF.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible value for the cover letter member is:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>cover-letter-source-member</i></b></dt>
|
||
|
|
<dd>Specify the name of the file member which contains the cover letter text.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible library values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LIBL</u></b></dt>
|
||
|
|
<dd>The library search list is used to locate the file.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>library-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library that locates the file.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible value for the cover letter file is:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>file-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the file which contains the cover letter text.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible cover letter language value is:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>NLV</i></b></dt>
|
||
|
|
<dd>Specify the national language version (NLV) code for the cover letter source. Each language code can be specified only once.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPTF.PREREQ"></a>
|
||
|
|
<h3>Prerequisite PTFs (PREREQ)</h3>
|
||
|
|
<p>Specifies a list of PTFs that must be applied before applying the current PTF. If these PTFs are not applied, the current PTF will not function. A maximum of 300 prerequisites and corequisites combined can be specified.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No PTFs are required.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>PTF-ID</i></b></dt>
|
||
|
|
<dd>Specify the number of the PTF required by this PTF.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPTF.COREQ"></a>
|
||
|
|
<h3>Corequisite PTFs (COREQ)</h3>
|
||
|
|
<p>Specifies a list of accompanying PTFs that are required to enable the new PTF. The current PTF is not applied unless all accompanying PTFs listed are also applied. A maximum of 300 prerequisites and corequisites combined can be specified.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No PTFs are required.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>PTF-ID</i></b></dt>
|
||
|
|
<dd>Specify the number of the PTF.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPTF.EXITPGM"></a>
|
||
|
|
<h3>PTF exit programs (EXITPGM)</h3>
|
||
|
|
<p>Specifies the exit programs to be to be called during the PTF apply or remove operation. A maximum of 50 exit programs can be specified.
|
||
|
|
</p>
|
||
|
|
<p>The possible single value is:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No exit programs are specified for this PTF.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible program name values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>program</i></b></dt>
|
||
|
|
<dd>Specify the name of an exit program for this PTF.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible library values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<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 run option values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*BOTH</u></b></dt>
|
||
|
|
<dd>The exit program is called during both apply and remove operations.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*APPLY</b></dt>
|
||
|
|
<dd>The exit program is called during the apply operation only.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*REMOVE</b></dt>
|
||
|
|
<dd>The exit program is called during the remove operation only.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*PREAPY</b></dt>
|
||
|
|
<dd>The exit program is called before apply PTF processing and at the end of apply PTF processing.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*PRERMV</b></dt>
|
||
|
|
<dd>The exit program is called before and at the end of remove PTF processing.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*PREBTH</b></dt>
|
||
|
|
<dd>The exit program is called before the PTF is applied or removed and at the end of the apply or remove PTF processing.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible type values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*PTF</u></b></dt>
|
||
|
|
<dd>The exit program object is included with the PTF objects. The exit program only exists until the PTF is permanently applied.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*OBJLST</b></dt>
|
||
|
|
<dd>The exit program object is not included with the PTF objects. The exit program must exist in the object list for the product, option, release, and load of the PTF or the code load for the product's base option.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible user data values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No user data is passed to the exit program when it is called.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>user-data</i></b></dt>
|
||
|
|
<dd>Specify the user data.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPTF.TGTRLS"></a>
|
||
|
|
<h3>Target release (TGTRLS)</h3>
|
||
|
|
<p>Specifies the earliest release of the operating system on which you intend to load and apply the PTF.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*CURRENT</u></b></dt>
|
||
|
|
<dd>The PTF is to be loaded and applied on the release of the operating system currently running on your system. The PTF also can be loaded and applied on a system with any later release of the operating system installed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*PRV</b></dt>
|
||
|
|
<dd>The PTF is to be loaded and applied on the previous release with modification level 0 of the operating system. The PTF can be loaded and applied on a system with any later release of the operating system installed.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>target-level</i></b></dt>
|
||
|
|
<dd>Specify the release of the operating system on which you intend to load and apply the PTF. The release level is specified in the format VxRyMz, where Vx is the version, Ry is the release, and Mz is the modification level. Valid values depend on the current version, release, and modification level, and they change with each new release.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CRTPTF.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Creating a PTF</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CRTPTF PTF(1X00001) LICPGM(1X12345) RLS(V5R2M0)
|
||
|
|
OPTION(*BASE) LODID(*CODEDFT) PTFOBJ((X00PGM01 *PGM))
|
||
|
|
OBJLIB(PTFDEVLIB *PRINCIPAL)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command creates PTF 1X00001 for release V5R2M0 of product 1X12345. The PTF is created using program X00PGM01 in library PTFDEVLIB. When applied, this PTF replaces program X00PGM01 in the principal product library of the *BASE option code load. This PTF is created to be loaded and applied on the current release of the operating system or any later release.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Creating a PTF with a Document</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CRTPTF PTF(1X00002) LICPGM(1X12345) RLS(V5R2M0)
|
||
|
|
OPTION(*BASE) LODID(*CODEDFT)
|
||
|
|
PTFDOC((X00DOC.001 X00FLR.001))
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command creates PTF 1X00002 for release V5R2M0 of product 1X12345. The PTF is created using document X00DOC.001 in folder X00FLR.001/QP. Notice that the document is taken from folder X00FLR.001/QP. Create PTF adds "/QP" to the end of the folder specified when searching for the document to be included. When applied, this PTF replaces document X00DOC.001 in folder X00FLR.001 of the *BASE option code load.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 3: Creating a PTF with a Cover Letter</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CRTPTF PTF(1X00003) LICPGM(1X12345) RLS(V5R2M0)
|
||
|
|
OPTION(*BASE) LODID(*CODEDFT)
|
||
|
|
COVER((PTFDEVLIB/PTFCVRLTRF PTF1X00003 2924))
|
||
|
|
EXITPGM((EXTPGMLIB/QPZ1X00003 *BOTH *PTF))
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command creates PTF 1X00003 for release V5R2M0 of product 1X12345. The cover letter for the PTF is created using source text from file PTFCVRLTRF in library PTFDEVLIB member PTF1X00003. The cover letter is created for National Language Version (NLV) 2924. The *PTF value specified on the exit program parameter causes program QPZ1X00003 to be saved with the PTF as a temporary object. Temporary objects are deleted when the PTF is permanently applied or removed. Note the temporary object naming convention is used for the exit program. Ensure that any temporary object names used are unique for this product release to avoid over writing other PTFs. The *BOTH value causes this exit program to be called during both apply and remove processing. Temporary objects are identified by QPZ1 at the beginning of the name.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 4: Creating a PTF for a Previous Release</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CRTPTF PTF(1X00004) LICPGM(1X12345) RLS(V5R3M0)
|
||
|
|
OPTION(*BASE) LODID(*CODEDFT)
|
||
|
|
PTFOBJ((X00PGM02 *PGM))
|
||
|
|
OBJLIB(PTFDEVLIB *PRINCIPAL) TGTRLS(V5R3M0)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command creates PTF 1X00004 for release V5R3M0 of product 1X12345. The PTF is created using program X00PGM02 in library PTFDEVLIB. When applied, this PTF replaces program X00PGM02 in the principal product library of the *BASE option code load. This PTF is created to be loaded and applied on release V5R3M0 of the operating system or any later release.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CRTPTF.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>CPF35DC</b></dt>
|
||
|
|
<dd>Primary library not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF35D3</b></dt>
|
||
|
|
<dd>Cover letter not copied.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3505</b></dt>
|
||
|
|
<dd>Corequisite PTF &1-&2 &3 contains common objects.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3506</b></dt>
|
||
|
|
<dd>Length of directory name too long.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3507</b></dt>
|
||
|
|
<dd>Corequisite PTF &1-&2 &3 not specified.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3509</b></dt>
|
||
|
|
<dd>Specified corequisite PTF &1-&2 &3 not valid.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF351A</b></dt>
|
||
|
|
<dd>Directory object name not valid.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF351B</b></dt>
|
||
|
|
<dd>Duplicate directory object specified.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF357A</b></dt>
|
||
|
|
<dd>Parameter value not valid.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF357B</b></dt>
|
||
|
|
<dd>Product not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF357D</b></dt>
|
||
|
|
<dd>Document or folder name not correct.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3571</b></dt>
|
||
|
|
<dd>PTF ID &1 not within valid range.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3572</b></dt>
|
||
|
|
<dd>PTF &2-&1 &3 already exists.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3573</b></dt>
|
||
|
|
<dd>Resources required for product &1 are not available.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3574</b></dt>
|
||
|
|
<dd>PTF ID not valid.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF358A</b></dt>
|
||
|
|
<dd>Release not valid.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF358B</b></dt>
|
||
|
|
<dd>PTF not created.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF358C</b></dt>
|
||
|
|
<dd>Create PTF not allowed for product &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF359C</b></dt>
|
||
|
|
<dd>Requisite type not valid.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3901</b></dt>
|
||
|
|
<dd>PTF &1-&2 &3 not created.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|