302 lines
9.9 KiB
HTML
302 lines
9.9 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>Convert Overlay to PFM (CVTOVLPFM)</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="CVTOVLPFM.Top_Of_Page"></a>
|
|
<h2>Convert Overlay to PFM (CVTOVLPFM)</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="#CVTOVLPFM.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CVTOVLPFM.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CVTOVLPFM.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CVTOVLPFM"></a>
|
|
<h3>Convert Overlay to PFM</h3>
|
|
<p>This command allows you to convert an overlay to a member in a physical database file.
|
|
</p>
|
|
<h3>Error messages for CVTOVLPFM</h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>AFP0010</b></dt>
|
|
<dd>An error occurred.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CVTOVLPFM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CVTOVLPFM.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="#CVTOVLPFM.OVL"><b>OVL</b></a></td>
|
|
<td valign="top">Overlay</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: Overlay</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="#CVTOVLPFM.DTAFMT"><b>DTAFMT</b></a></td>
|
|
<td valign="top">Format of data</td>
|
|
<td valign="top">*FIXED, *CONTINUOUS</td>
|
|
<td valign="top">Required, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CVTOVLPFM.FILE"><b>FILE</b></a></td>
|
|
<td valign="top">To file</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Required, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: To file</td>
|
|
<td valign="top"><i>Name</i>, *VM, *MVS</td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*CURLIB</u></b></td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#CVTOVLPFM.MBR"><b>MBR</b></a></td>
|
|
<td valign="top">To member</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*OVL</u></b></td>
|
|
<td valign="top">Optional, Positional 4</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CVTOVLPFM.TEXT"><b>TEXT</b></a></td>
|
|
<td valign="top">Text 'description'</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*OVLTXT</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CVTOVLPFM.REPLACE"><b>REPLACE</b></a></td>
|
|
<td valign="top">Replace</td>
|
|
<td valign="top">*YES, <b><u>*NO</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CVTOVLPFM.CRTFILE"><b>CRTFILE</b></a></td>
|
|
<td valign="top">Create file</td>
|
|
<td valign="top">*YES, <b><u>*NO</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CVTOVLPFM.FILETEXT"><b>FILETEXT</b></a></td>
|
|
<td valign="top">Text 'description'</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*BLANK</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CVTOVLPFM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CVTOVLPFM.OVL"></a>
|
|
<h3>Overlay (OVL)</h3>
|
|
<p>Specifies the qualified name of the overlay that is converted. This is a required parameter.
|
|
</p>
|
|
<p>The possible library values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>The library list is used to locate the overlay.
|
|
</dd>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is used to locate the overlay. If no library is specified as the current library for the job, QGPL is used.
|
|
</dd>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>Specify the library where the overlay resides.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CVTOVLPFM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CVTOVLPFM.DTAFMT"></a>
|
|
<h3>Format of data (DTAFMT)</h3>
|
|
<p>Specifies how data are filled in a physical file member.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b>*FIXED</b></dt>
|
|
<dd>One record has one structured field. The padding character is binary 0s. The record length of the file using fixed format is the longest length of the AFPDS structured fields in the overlay or the page segment. If the length of the existing file is smaller than the longest length of the structured field, an error message is displayed. If the length of the existing file is larger than the longest length of the structured field, padding characters are added to the end of the records. This format is for the VM system or the MVS system.
|
|
</dd>
|
|
<dt><b>*CONTINUOUS</b></dt>
|
|
<dd>The structured fields are filled continuously and folded. Only the last record has padding characters; the padding characters are binary 0s. Any record length of the existing file is allowed. The created record length of the file is 256 bytes. This format is for the OS/2 system.
|
|
</dd>
|
|
</dl>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CVTOVLPFM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CVTOVLPFM.FILE"></a>
|
|
<h3>File (FILE)</h3>
|
|
<p>Specifies the qualified name of the physical file being used to fill the overlay data.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b>*VM</b></dt>
|
|
<dd>Specifies that the name OVLY38PP is used. It will be a valid filetype for an overlay on the VM system.
|
|
</dd>
|
|
<dt><b>*MVS</b></dt>
|
|
<dd>Specifies that the name O1xxxxxx is used. The 'xxxxxx' is the first six valid characters of the name specified in the OVL parameter. It will be a valid member name for an overlay on the MVS system.
|
|
</dd>
|
|
<dt><b><i>physical-file-name</i></b></dt>
|
|
<dd>Type the name of a physical file used to fill the overlay data.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible library values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is used to locate the file. If no library is specified as the current library for the job, QGPL is used.
|
|
</dd>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>Specify the library where the file resides.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CVTOVLPFM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CVTOVLPFM.MBR"></a>
|
|
<h3>Member (MBR)</h3>
|
|
<p>Specifies the name of the physical file member which is filled with the overlay data.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*OVL</u></b></dt>
|
|
<dd>Specifies the name of the overlay specified in the OVL parameter.
|
|
</dd>
|
|
<dt><b><i>member-name</i></b></dt>
|
|
<dd>Specify the name of a member used to fill the overlay data.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CVTOVLPFM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CVTOVLPFM.TEXT"></a>
|
|
<h3>Text 'description' (TEXT)</h3>
|
|
<p>Specifies text that briefly describes the member and its function.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*OVLTXT</u></b></dt>
|
|
<dd>Specifies the same description specified in the OVL parameter.
|
|
</dd>
|
|
<dt><b><i>'description'</i></b></dt>
|
|
<dd>Specifies no more than 50 characters of text, enclosed in apostrophes.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CVTOVLPFM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CVTOVLPFM.REPLACE"></a>
|
|
<h3>Replace (REPLACE)</h3>
|
|
<p>Specifies whether or not the physical file member replaces the existing physical file member if a physical file member of the same name already exists in the library.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>A new physical file member is not created if an old physical file member of the same name already exists in the library.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>A new physical file member is created and the old physical file member is replaced by it.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CVTOVLPFM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CVTOVLPFM.CRTFILE"></a>
|
|
<h3>Create file (CRTFILE)</h3>
|
|
<p>Specifies whether or not the file is created if the file does not exist.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>Do not create the file.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>Create the file.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CVTOVLPFM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CVTOVLPFM.FILETEXT"></a>
|
|
<h3>Text 'description' (FILETEXT)</h3>
|
|
<p>Specifies text that briefly describes the file and its function. This prompt is valid only when CRTFILE parameter is *YES.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*BLANK</u></b></dt>
|
|
<dd>No text is specified.
|
|
</dd>
|
|
<dt><b><i>'description'</i></b></dt>
|
|
<dd>Specifies no more than 50 characters of text, enclosed in apostrophes.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CVTOVLPFM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div>
|
|
<h3><a name="CVTOVLPFM.COMMAND.EXAMPLES">Examples</a></h3>None
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CVTOVLPFM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CVTOVLPFM.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>AFP0010</b></dt>
|
|
<dd>An error occurred.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CVTOVLPFM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|