1306 lines
56 KiB
HTML
1306 lines
56 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 Physical File (CRTPF)</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="CRTPF.Top_Of_Page"></a>
|
||
|
|
<h2>Create Physical File (CRTPF)</h2>
|
||
|
|
<table width="100%">
|
||
|
|
<tr>
|
||
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
|
||
|
|
<b>Threadsafe: </b>Conditional
|
||
|
|
</td>
|
||
|
|
<td valign="top" align="right">
|
||
|
|
<a href="#CRTPF.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#CRTPF.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#CRTPF.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="CRTPF"></a>
|
||
|
|
<p>The Create Physical File (CRTPF) command creates a physical file from the information specified on this command and (optionally) from the data description specifications (DDS) contained in a source file.
|
||
|
|
</p>
|
||
|
|
<p>A physical file is a database file that contains data records. The data records are grouped into physical file members and each member has its own access path to the data. Normally, database files have only one member which, by default, is added to the file when the file is created. If the desired physical file has a record format with only one character field in arrival sequence or if the file is a source file, a DDS source file is not needed. To override attributes of the file after it has been created, use the Override Database File (OVRDBF) command before the file is opened. To change attributes of the file after it has been created, use the Change Physical File (CHGPF) command.
|
||
|
|
</p>
|
||
|
|
<p><b>Restrictions:</b>
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>This command is conditionally threadsafe. In multithreaded jobs, this command is not threadsafe for distributed files and fails for distributed files that use relational databases of type *SNA.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="CRTPF.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="#CRTPF.FILE"><b>FILE</b></a></td>
|
||
|
|
<td valign="top">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: 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>*CURLIB</u></b></td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#CRTPF.SRCFILE"><b>SRCFILE</b></a></td>
|
||
|
|
<td valign="top">Source file</td>
|
||
|
|
<td valign="top"><i>Qualified object name</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional, Positional 2</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Qualifier 1: Source file</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>QDDSSRC</u></b></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="#CRTPF.SRCMBR"><b>SRCMBR</b></a></td>
|
||
|
|
<td valign="top">Source member</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*FILE</u></b></td>
|
||
|
|
<td valign="top">Optional, Positional 3</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTPF.RCDLEN"><b>RCDLEN</b></a></td>
|
||
|
|
<td valign="top">Record length, if no DDS</td>
|
||
|
|
<td valign="top"><i>Integer</i></td>
|
||
|
|
<td valign="top">Optional, Positional 4</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTPF.GENLVL"><b>GENLVL</b></a></td>
|
||
|
|
<td valign="top">Generation severity level</td>
|
||
|
|
<td valign="top">0-30, <b><u>20</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTPF.FLAG"><b>FLAG</b></a></td>
|
||
|
|
<td valign="top">Flagging severity level</td>
|
||
|
|
<td valign="top">0-30, <b><u>0</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTPF.FILETYPE"><b>FILETYPE</b></a></td>
|
||
|
|
<td valign="top">File type</td>
|
||
|
|
<td valign="top"><b><u>*DATA</u></b>, *SRC</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTPF.MBR"><b>MBR</b></a></td>
|
||
|
|
<td valign="top">Member, if desired</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*FILE</u></b>, *NONE</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTPF.IGCDTA"><b>IGCDTA</b></a></td>
|
||
|
|
<td valign="top">User specified DBCS data</td>
|
||
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTPF.TEXT"><b>TEXT</b></a></td>
|
||
|
|
<td valign="top">Text 'description'</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*SRCMBRTXT</u></b>, *BLANK</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTPF.OPTION"><b>OPTION</b></a></td>
|
||
|
|
<td valign="top">Source listing options</td>
|
||
|
|
<td valign="top">Values (up to 4 repetitions): *SRC, *NOSRC, *SOURCE, *NOSOURCE, *LIST, *NOLIST, *SECLVL, *NOSECLVL, *EVENTF, *NOEVENTF</td>
|
||
|
|
<td valign="top">Optional, Positional 5</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTPF.SYSTEM"><b>SYSTEM</b></a></td>
|
||
|
|
<td valign="top">System</td>
|
||
|
|
<td valign="top"><b><u>*LCL</u></b>, *RMT, *FILETYPE</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTPF.EXPDATE"><b>EXPDATE</b></a></td>
|
||
|
|
<td valign="top">Expiration date for member</td>
|
||
|
|
<td valign="top"><i>Date</i>, <b><u>*NONE</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTPF.MAXMBRS"><b>MAXMBRS</b></a></td>
|
||
|
|
<td valign="top">Maximum members</td>
|
||
|
|
<td valign="top"><i>Integer</i>, <b><u>1</u></b>, *NOMAX</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTPF.ACCPTHSIZ"><b>ACCPTHSIZ</b></a></td>
|
||
|
|
<td valign="top">Access path size</td>
|
||
|
|
<td valign="top"><b><u>*MAX1TB</u></b>, *MAX4GB</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTPF.PAGESIZE"><b>PAGESIZE</b></a></td>
|
||
|
|
<td valign="top">Access path logical page size</td>
|
||
|
|
<td valign="top"><b><u>*KEYLEN</u></b>, 8, 16, 32, 64, 128, 256, 512</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTPF.MAINT"><b>MAINT</b></a></td>
|
||
|
|
<td valign="top">Access path maintenance</td>
|
||
|
|
<td valign="top"><b><u>*IMMED</u></b>, *DLY, *REBLD</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTPF.RECOVER"><b>RECOVER</b></a></td>
|
||
|
|
<td valign="top">Access path recovery</td>
|
||
|
|
<td valign="top">*NO, *AFTIPL, *IPL</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTPF.FRCACCPTH"><b>FRCACCPTH</b></a></td>
|
||
|
|
<td valign="top">Force keyed access path</td>
|
||
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="4"><a href="#CRTPF.SIZE"><b>SIZE</b></a></td>
|
||
|
|
<td valign="top">Member size</td>
|
||
|
|
<td valign="top">Single values: *NOMAX<br>Other values: <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="4">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Initial number of records</td>
|
||
|
|
<td valign="top">
|
||
|
|
1-2147483646, <b><u>10000</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Increment number of records</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Integer</i>, <b><u>1000</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 3: Maximum increments</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Integer</i>, <b><u>3</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTPF.ALLOCATE"><b>ALLOCATE</b></a></td>
|
||
|
|
<td valign="top">Allocate storage</td>
|
||
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTPF.CONTIG"><b>CONTIG</b></a></td>
|
||
|
|
<td valign="top">Contiguous storage</td>
|
||
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTPF.UNIT"><b>UNIT</b></a></td>
|
||
|
|
<td valign="top">Preferred storage unit</td>
|
||
|
|
<td valign="top">1-255, <b><u>*ANY</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTPF.FRCRATIO"><b>FRCRATIO</b></a></td>
|
||
|
|
<td valign="top">Records to force a write</td>
|
||
|
|
<td valign="top"><i>Integer</i>, <b><u>*NONE</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTPF.WAITFILE"><b>WAITFILE</b></a></td>
|
||
|
|
<td valign="top">Maximum file wait time</td>
|
||
|
|
<td valign="top"><i>Integer</i>, <b><u>30</u></b>, *IMMED, *CLS</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTPF.WAITRCD"><b>WAITRCD</b></a></td>
|
||
|
|
<td valign="top">Maximum record wait time</td>
|
||
|
|
<td valign="top"><i>Integer</i>, <b><u>60</u></b>, *IMMED, *NOMAX</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTPF.SHARE"><b>SHARE</b></a></td>
|
||
|
|
<td valign="top">Share open data path</td>
|
||
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTPF.DLTPCT"><b>DLTPCT</b></a></td>
|
||
|
|
<td valign="top">Max % deleted records allowed</td>
|
||
|
|
<td valign="top">1-100, <b><u>*NONE</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTPF.REUSEDLT"><b>REUSEDLT</b></a></td>
|
||
|
|
<td valign="top">Reuse deleted records</td>
|
||
|
|
<td valign="top">*YES, <b><u>*NO</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#CRTPF.SRTSEQ"><b>SRTSEQ</b></a></td>
|
||
|
|
<td valign="top">Sort sequence</td>
|
||
|
|
<td valign="top">Single values: <b><u>*SRC</u></b>, *JOB, *LANGIDSHR, *LANGIDUNQ, *HEX<br>Other values: <i>Qualified object name</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Qualifier 1: Sort sequence</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="#CRTPF.LANGID"><b>LANGID</b></a></td>
|
||
|
|
<td valign="top">Language ID</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*JOB</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTPF.CCSID"><b>CCSID</b></a></td>
|
||
|
|
<td valign="top">Coded character set ID</td>
|
||
|
|
<td valign="top"><i>Integer</i>, <b><u>*JOB</u></b>, *HEX</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTPF.ALWUPD"><b>ALWUPD</b></a></td>
|
||
|
|
<td valign="top">Allow update operation</td>
|
||
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTPF.ALWDLT"><b>ALWDLT</b></a></td>
|
||
|
|
<td valign="top">Allow delete operation</td>
|
||
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTPF.LVLCHK"><b>LVLCHK</b></a></td>
|
||
|
|
<td valign="top">Record format level check</td>
|
||
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#CRTPF.NODGRP"><b>NODGRP</b></a></td>
|
||
|
|
<td valign="top">Node group</td>
|
||
|
|
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values: <i>Qualified object name</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Qualifier 1: Node group</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="#CRTPF.PTNKEY"><b>PTNKEY</b></a></td>
|
||
|
|
<td valign="top">Partitioning Key</td>
|
||
|
|
<td valign="top">Values (up to 300 repetitions): <i>Name</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTPF.AUT"><b>AUT</b></a></td>
|
||
|
|
<td valign="top">Authority</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBCRTAUT</u></b>, *ALL, *CHANGE, *EXCLUDE, *USE</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="CRTPF.FILE"></a>
|
||
|
|
<h3>File (FILE)</h3>
|
||
|
|
<p>Specifies the physical file to be created.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
<p><b>Qualifier 1: File</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the physical file to be created.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Qualifier 2: Library</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*CURLIB</u></b></dt>
|
||
|
|
<dd>The current library for the job is where the file is to be located. If no library is specified as the current library for the job, QGPL is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the library where the file is to be located.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPF.SRCFILE"></a>
|
||
|
|
<h3>Source file (SRCFILE)</h3>
|
||
|
|
<p>Specifies the source file that contains the data description specifications (DDS) that describe the record format and its fields, and the access path for the file and its members. The specifications that are made in DDS are described in the Database information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter and the DDS Reference information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If a value is specified for this parameter, a value cannot be specified for the <b>Record length (RCDLEN)</b> parameter.
|
||
|
|
</p>
|
||
|
|
<p><b>Qualifier 1: Source file</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>QDDSSRC</u></b></dt>
|
||
|
|
<dd>The DDS source file named QDDSSRC contains the source descriptions used to create the physical file.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the source file that contains the DDS used to create the physical file.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Qualifier 2: Library</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*CURLIB</u></b></dt>
|
||
|
|
<dd>The current library for the job is where the file is located. If no library is specified as the current library for the job, QGPL is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the library where the file is located.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPF.SRCMBR"></a>
|
||
|
|
<h3>Source member (SRCMBR)</h3>
|
||
|
|
<p>Specifies the name of the source file member that contains the DDS for the physical file being created; the member is in the source file specified in the SRCFILE parameter (or its default, QDDSSRC). If SRCMBR is specified, RCDLEN cannot be specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*FILE</u></b></dt>
|
||
|
|
<dd>The source file member name is the same as that of the physical file specified for the <b>File (FILE)</b> parameter.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the member in the source file.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPF.RCDLEN"></a>
|
||
|
|
<h3>Record length (RCDLEN)</h3>
|
||
|
|
<p>Specifies the length (in bytes) of the records stored in the physical file. If RCDLEN and FILETYPE(*DATA) are specified, the physical file is created with a record format that has only one field. The file is then restricted to an arrival sequence access path. The record format and the field are both assigned the same name as that of the file, specified in the FILE parameter. A value ranging from 1 through 32766 bytes can be specified for the record length.
|
||
|
|
</p>
|
||
|
|
<p>If RCDLEN and FILETYPE(*SRC) are specified, the record format has three fields: source sequence number, date, and source statement. The RCDLEN parameter must provide six positions for the source sequence number, six positions for the date field, and one position for source start, which are required in each record. These fields are defined with fixed attributes and names. If records are copied into the file by the CPYF command and the records are longer than the length specified, the records are truncated on the right.
|
||
|
|
</p>
|
||
|
|
<p>If RCDLEN is specified, SRCFILE and SRCMBR cannot be specified; RCDLEN is used to specify a fixed record length for the record format when a source file is not needed (when only one field exists in each record or when the file being created is a source file). The high-level language program that processes the file must describe the fields in the record in the program.
|
||
|
|
</p>
|
||
|
|
<p><b>Double-Byte Character Set Considerations</b>
|
||
|
|
</p>
|
||
|
|
<p>If IGCDTA(*NO) is specified, the field is assigned the data type of character whose length is the same as the record length specified. A value ranging from 1 to 32766 bytes can be specified for the record length. If IGCDTA(*YES) is specified, the field is assigned the data type of DBCS-open and a value ranging from 4 to 32766 can be specified.
|
||
|
|
</p>
|
||
|
|
<p>The RCDLEN parameter must provide six positions for the source sequence number, six positions for the date field, and four positions for source start when FILETYPE(*SRC) and IGCDTA(*YES) are specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>integer</i></b></dt>
|
||
|
|
<dd>Specify the number of bytes in each record.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPF.GENLVL"></a>
|
||
|
|
<h3>Generation severity level (GENLVL)</h3>
|
||
|
|
<p>Specifies the severity level at which the create operation fails. If errors occur that have a severity level greater than or equal to this value, the operation ends.
|
||
|
|
</p>
|
||
|
|
<p>This parameter applies only to messages created while processing DDS source files.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>20</u></b></dt>
|
||
|
|
<dd>If errors occur in the DDS source file processing with a severity level greater than or equal to 20, the file is not created.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>0-30</i></b></dt>
|
||
|
|
<dd>Specify the desired severity level value. If 0 is specified, the file is not created. The value specified must be greater than or equal to the value specified for the <b>Flagging severity level (FLAG)</b> parameter.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPF.FLAG"></a>
|
||
|
|
<h3>Flagging severity level (FLAG)</h3>
|
||
|
|
<p>Specifies the minimum severity level of messages to be listed.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>0</u></b></dt>
|
||
|
|
<dd>All messages are listed.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>0-30</i></b></dt>
|
||
|
|
<dd>Specify a number indicating the minimum severity of messages to be listed. The value specified must be greater than or equal to the value specified for the <b>Generation severity level (GENLVL)</b> parameter.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPF.FILETYPE"></a>
|
||
|
|
<h3>File type (FILETYPE)</h3>
|
||
|
|
<p>Specifies whether each member of the physical file being created contains data records or contains source records (statements) for a program or another file. The file can contain, for example, RPG source statements for an RPG program or DDS source statements for another physical, logical, or device file.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*DATA</u></b></dt>
|
||
|
|
<dd>The physical file will contain data records.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SRC</b></dt>
|
||
|
|
<dd>The physical file will contain source records.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPF.MBR"></a>
|
||
|
|
<h3>Member (MBR)</h3>
|
||
|
|
<p>Specifies the name of the physical file member added when the physical file is created.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*FILE</u></b></dt>
|
||
|
|
<dd>The name of the member will be the same as the physical file to be created.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NONE</b></dt>
|
||
|
|
<dd>No physical file member is added when the file is created.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the physical file member to be added to the new file.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPF.IGCDTA"></a>
|
||
|
|
<h3>User specified DBCS data (IGCDTA)</h3>
|
||
|
|
<p>Specifies, for program-described files, whether the file processes double-byte character set (DBCS) data. Specifies, for externally described files, the DBCS attributes of the file.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This parameter has no meaning for physical files created using DDS, because the use of DBCS data is specified in the DDS.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NO</u></b></dt>
|
||
|
|
<dd>The file does not contain double-byte character set (DBCS) data.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>The file contains DBCS data.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Double-Byte Character Set Considerations</b>
|
||
|
|
</p>
|
||
|
|
<p>If the user creates a physical file and specifies the RCDLEN parameter, the system creates a default record format.
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>If IGCDTA(*YES) is specified, the default record format can contain DBCS data (as if the record were specified with the DBCS-open (O in column 35 of DDS specification) data type).
|
||
|
|
</li>
|
||
|
|
<li>If IGCDTA(*NO) is specified, the default record format cannot contain DBCS data (as if the record were specified with the character (A or blank in column 35 of DDS specification) data type).
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>The system ignores the IGCDTA parameter value if a value for the RCDLEN parameter is not specified.
|
||
|
|
</p>
|
||
|
|
<p>The user cannot override the IGCDTA value for a physical file.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPF.TEXT"></a>
|
||
|
|
<h3>Text 'description' (TEXT)</h3>
|
||
|
|
<p>Specifies the text that briefly describes the object.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SRCMBRTXT</u></b></dt>
|
||
|
|
<dd>The text is taken from the source file member being used to create the physical file. If the source file is a database file, the text is taken from the source file member. Text can be added or changed for a database source member by using the Source Entry Utility or by using either the Add Physical File Member (ADDPFM) command or the Change Physical File Member (CHGPFM) command. If the source file is an inline file or a device file, the text is blank.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*BLANK</b></dt>
|
||
|
|
<dd>No text is specified.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>character-value</i></b></dt>
|
||
|
|
<dd>Specify no more than 50 characters of text, enclosed in apostrophes.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPF.OPTION"></a>
|
||
|
|
<h3>Source listing options (OPTION)</h3>
|
||
|
|
<p>Specifies the type of output produced when the file is created. A maximum of four of the following values can be specified in any order on this parameter. If neither or both of the values on an option are specified, the first value is used.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>The first values on each option are similar to, but are not actually default values, and therefore, cannot be changed with the CHGCMDDFT (Change Command Default) command.
|
||
|
|
</p>
|
||
|
|
<p><b>Source Listing Option</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SRC or *SOURCE</u></b></dt>
|
||
|
|
<dd>A printout of the source statements, including a list of errors, is created.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NOSRC or *NOSOURCE</b></dt>
|
||
|
|
<dd>No printout of the source statements is created unless errors are detected. If errors are detected, they are listed along with the keyword or record format that caused the error.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Program Listing Option</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LIST</u></b></dt>
|
||
|
|
<dd>An expanded source printout is created, showing a detailed list of the file specifications and the references to other file descriptions.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*NOLIST</b></dt>
|
||
|
|
<dd>The expanded source printout is not created.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Second-Level Message Text Option</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NOSECLVL</u></b></dt>
|
||
|
|
<dd>The messages section of the data description specifications (DDS) printout does not contain the online help information for messages issued during DDS processing.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SECLVL</b></dt>
|
||
|
|
<dd>The online help information appears in the DDS printout.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Event File Creation Option</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NOEVENTF</u></b></dt>
|
||
|
|
<dd>The compiler does not produce an event file for the CoOperative Development Environment for iSeries (CODE for iSeries)
|
||
|
|
</dd>
|
||
|
|
<dt><b>*EVENTF</b></dt>
|
||
|
|
<dd>The compiler produces an event file that can be used by the CODE for iSeries product. The event file is created as a member in the file EVFEVENT in your object library. The CODE for iSeries product uses this file to offer error feedback integrated with the CODE for iSeries editor. This value is normally specified by the CODE for iSeries product on your behalf.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPF.SYSTEM"></a>
|
||
|
|
<h3>System (SYSTEM)</h3>
|
||
|
|
<p>Specifies whether the physical file is created on the local system or the remote system.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LCL</u></b></dt>
|
||
|
|
<dd>The physical file is created on the local system.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*RMT</b></dt>
|
||
|
|
<dd>The physical file is created on a remote system. The file specified for the <b>File (FILE)</b> parameter must be the name of a distributed data management (DDM) file that identifies the remote system and the name of the physical file being created.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*FILETYPE</b></dt>
|
||
|
|
<dd>If the file specified for the FILE parameter does not exist on the system, the physical file is created on the local system. Otherwise, the file must be a DDM file, and the physical file is created on a remote system. The DDM file identifies the remote system and the name of the physical file being created.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPF.EXPDATE"></a>
|
||
|
|
<h3>Expiration date for member (EXPDATE)</h3>
|
||
|
|
<p>Specifies the expiration date for members of the physical file.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No expiration date is specified.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>date</i></b></dt>
|
||
|
|
<dd>Specify the date after which the file member cannot be used. The date must be enclosed in apostrophes if date separator characters are used in the value.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPF.MAXMBRS"></a>
|
||
|
|
<h3>Maximum members (MAXMBRS)</h3>
|
||
|
|
<p>Specifies the maximum number of members that the physical file can contain.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>1</u></b></dt>
|
||
|
|
<dd>Only one member can be contained in the physical file.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NOMAX</b></dt>
|
||
|
|
<dd>The number of members that can be contained in the file is the system maximum of 32,767 members.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>1-32767</i></b></dt>
|
||
|
|
<dd>Specify the maximum number of members that can be contained in the physical file.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPF.ACCPTHSIZ"></a>
|
||
|
|
<h3>Access path size (ACCPTHSIZ)</h3>
|
||
|
|
<p>Specifies the maximum size of auxiliary storage that can be occupied by the following kinds of access paths:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>The access paths that are associated with a physical file that has a keyed sequence access path.
|
||
|
|
</li>
|
||
|
|
<li>The access paths that are created for referential or unique constraints, and that can be added to this file with the Add Physical File Constraint (ADDPFCST) command.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>This parameter does not apply to access paths that are created for logical files or for queries that refer to the data in a physical file.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*MAX1TB</u></b></dt>
|
||
|
|
<dd>The access paths associated with this file can occupy a maximum of one terabyte (1,099,511,627,776 bytes) of auxiliary storage.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*MAX4GB</b></dt>
|
||
|
|
<dd>The access paths associated with this file can occupy a maximum of four gigabytes (4,294,966,272 bytes) of auxiliary storage.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPF.PAGESIZE"></a>
|
||
|
|
<h3>Access path logical page size (PAGESIZE)</h3>
|
||
|
|
<p>Specifies the access path logical page size that is used when the access path is created.
|
||
|
|
</p>
|
||
|
|
<p>The access path logical page size is used by the system to determine the size of each page of the index. This logical page size is the amount of bytes of the access path that can be moved into the job's storage pool from the auxiliary storage for a page fault.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*KEYLEN</u></b></dt>
|
||
|
|
<dd>The access path logical page size will be determined by the total length of the key, or keys.
|
||
|
|
</dd>
|
||
|
|
<dt><b>8</b></dt>
|
||
|
|
<dd>Logical page size of 8k.
|
||
|
|
</dd>
|
||
|
|
<dt><b>16</b></dt>
|
||
|
|
<dd>Logical page size of 16k.
|
||
|
|
</dd>
|
||
|
|
<dt><b>32</b></dt>
|
||
|
|
<dd>Logical page size of 32k.
|
||
|
|
</dd>
|
||
|
|
<dt><b>64</b></dt>
|
||
|
|
<dd>Logical page size of 64k.
|
||
|
|
</dd>
|
||
|
|
<dt><b>128</b></dt>
|
||
|
|
<dd>Logical page size of 128k.
|
||
|
|
</dd>
|
||
|
|
<dt><b>256</b></dt>
|
||
|
|
<dd>Logical page size of 256k.
|
||
|
|
</dd>
|
||
|
|
<dt><b>512</b></dt>
|
||
|
|
<dd>Logical page size of 512k.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPF.MAINT"></a>
|
||
|
|
<h3>Access path maintenance (MAINT)</h3>
|
||
|
|
<p>Specifies, for files with key fields, the type of access path maintenance used for all members of the physical file.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*IMMED</u></b></dt>
|
||
|
|
<dd>The access path is updated each time a record is changed, added, or deleted from a member. *IMMED must be specified for files that require unique keys.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*REBLD</b></dt>
|
||
|
|
<dd>The access path is completely rebuilt each time a file member is opened. The access path is maintained until the member is closed; then the access path is deleted. *REBLD cannot be specified for files that require unique keys.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*DLY</b></dt>
|
||
|
|
<dd>The maintenance of the access path is delayed until the physical file member is opened for use. Then, the access path is changed only for records that have been added, deleted, or changed since the file was last opened. While the file is <i>open</i>, changes made to its members are immediately reflected in the access paths of those members, no matter what is specified for MAINT. To prevent a lengthy rebuild time when the file is opened, *DLY should be specified only when the number of changes to the access path between successive opens are small; that is, when the file is opened frequently or when the key fields in records for this access path change infrequently. *DLY is not valid for access paths that require unique key values.
|
||
|
|
<p>If the number of changes between a close and the next open reaches approximately 10 percent of the access path size, the system stops saving changes and the access path is completely rebuilt the next time the file is opened.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPF.RECOVER"></a>
|
||
|
|
<h3>Access path recovery (RECOVER)</h3>
|
||
|
|
<p>Specifies, for files with immediate or delayed access path maintenance, when recovery processing of the file is performed if the access path is being changed when a system failure occurs. This parameter is valid only for a file with a keyed access path.
|
||
|
|
</p>
|
||
|
|
<p>If *IMMED is specified for the <b>Access path maintenance (MAINT)</b> parameter, the access path can be rebuilt during initial program load (IPL) (before any user can run a job), or after IPL has ended (during jobs running at the same time), or when the file is next opened. While the access path is being rebuilt, the file cannot be used by any job.
|
||
|
|
</p>
|
||
|
|
<p>During the IPL, an Override Access Path Recovery display lists those access paths that must be recovered and the RECOVER parameter value for each access path. The user can override the RECOVER parameter value on this display. More information on access paths is in the Backup and Recovery book, SC41-5304.
|
||
|
|
</p>
|
||
|
|
<p>If *REBLD is specified for the MAINT parameter, the access path is rebuilt the next time its file is opened.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>The access path of the file is rebuilt when the file is opened. *NO is the default for all files that do not require unique keys. The file's access path, if not valid, is rebuilt when the file is next opened.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>*NO is the default for all files that do not require unique keys.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*AFTIPL</b></dt>
|
||
|
|
<dd>The access path of the file is rebuilt after the initial program load (IPL) operation is completed. This option allows other jobs not using this file to start processing immediately after the completion of the IPL. If a job tries to allocate the file while its access path is being rebuilt, a file open exception occurs.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>*AFTIPL is the default for all files that require unique keys.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*IPL</b></dt>
|
||
|
|
<dd>The access path of the file is rebuilt during the IPL operation. This ensures that the file's access path is rebuilt before the first user program tries to use it; however, no jobs can start running until after all files that specify RECOVER(*IPL) have their access paths rebuilt.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPF.FRCACCPTH"></a>
|
||
|
|
<h3>Force keyed access path (FRCACCPTH)</h3>
|
||
|
|
<p>Specifies, for files with key fields, whether access path changes are forced to auxiliary storage along with the associated records in the file. FRCACCPTH(*YES) minimizes (but does not remove) the possibility that an abnormal job end may cause damage to the access path that requires it to be rebuilt.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NO</u></b></dt>
|
||
|
|
<dd>The access path and associated records are not forced to be written to auxiliary storage when the access path is changed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>The access path and associated records are forced to be written to auxiliary storage when the access path is changed. *YES cannot be specified if *REBLD is specified on the <b>Access path maintenance (MAINT)</b> parameter.
|
||
|
|
<p>FRCACCPTH(*YES) slows the response time of the system if the access path is changed in an interactive job. If the access path is changed frequently, the overall performance of the system is decreased.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPF.SIZE"></a>
|
||
|
|
<h3>Member size (SIZE)</h3>
|
||
|
|
<p>Specifies the <i>initial</i> number of records in each member of the file, the number of records in each part added to the member size, and the number of times the part added is automatically applied. The number of records for each file member is specified as the number of records that can be placed in it (this number includes any deleted records).
|
||
|
|
</p>
|
||
|
|
<p>When the maximum number of records has been reached, a message (stating that the member is full) is sent to the system operator, giving the choice of ending the request or extending the member size. The operator can extend the member by 10% or by the number of records specified as the increment value, whichever is greater, each time the message is received.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*NOMAX</b></dt>
|
||
|
|
<dd>The number of records that can be added to each member of the file is not limited by the user. The maximum size of each member is determined by the system. If *NOMAX is specified, *NO must be specified for the <b>Allocate storage (ALLOCATE)</b> parameter.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 1: Initial number of records</b>
|
||
|
|
</p>
|
||
|
|
<p>Specify the <i>initial</i> number of records in each member.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>10000</u></b></dt>
|
||
|
|
<dd>Initially, up to 10000 records can be written to each member of the file.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>1-2147483646</i></b></dt>
|
||
|
|
<dd>Specify the number of records that can be written to each member of the file before the member size is automatically extended.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Increment number of records</b>
|
||
|
|
</p>
|
||
|
|
<p>Specify the number of records that are automatically added to the member when the number of records in the member is greater than the initial member size. The minimum size of an increment is 10% of the size of the member at the time the maximum number of records is reached.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>1000</u></b></dt>
|
||
|
|
<dd>The file size is increased by 10% or 1000 records, whichever is greater.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>integer</i></b></dt>
|
||
|
|
<dd>Specify the number of additional records which, if greater than 10% of the size of the member when the maximum number of records is reached, are automatically added to the member.
|
||
|
|
<p>If the number specified is not greater than 10% of the member size and not equal to zero, the member size is increased by 10%.
|
||
|
|
</p>
|
||
|
|
<p>If 0 is the specified increment value, the member is not automatically extended. This value must be 0 if the value for the number of increments is 0.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 3: Maximum increments</b>
|
||
|
|
</p>
|
||
|
|
<p>Specify the maximum number of increments that can be automatically added to the member.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>3</u></b></dt>
|
||
|
|
<dd>A maximum of 3 increments is automatically added to the member size.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>integer</i></b></dt>
|
||
|
|
<dd>Specify the maximum number of increments automatically added to the member size. Valid values range from 0 through 32767. If 0 is specified, the member is not automatically extended.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPF.ALLOCATE"></a>
|
||
|
|
<h3>Allocate storage (ALLOCATE)</h3>
|
||
|
|
<p>Specifies whether <i>initial</i> storage space is allocated to each physical file member added to the file. The allocation provides enough space to hold the number of records specified for the <b>Member size (SIZE)</b> parameter. Allocations that occur when a record cannot be added to a member without exceeding its capacity are determined by the system and by the SIZE parameter values.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NO</u></b></dt>
|
||
|
|
<dd>The system determines the amount of storage space to allocate to each member added to the file.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>The amount of storage space specified in the first value of the SIZE parameter is allocated each time a new member is added. If *YES is specified, *NOMAX must not be specified for the SIZE parameter.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPF.CONTIG"></a>
|
||
|
|
<h3>Contiguous storage (CONTIG)</h3>
|
||
|
|
<p>Specifies, for each physical file member added to the file, whether all of the records in the initial storage allocation must be stored next to each other.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NO</u></b></dt>
|
||
|
|
<dd>Storage of the records next to each other is not required.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>The space containing the records allows the records to be stored next to each other. If the records must be separated, the member is added and a message is sent to the user indicating that storage of the records next to each other is not available.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPF.UNIT"></a>
|
||
|
|
<h3>Preferred storage unit (UNIT)</h3>
|
||
|
|
<p>This parameter is no longer supported. It exists solely for compatibility with releases earlier than Version 3 Release 6 Modification 0 of the OS/400 operating system. For information on using auxiliary storage pools (ASPs), refer to the Backup and Recovery book, SC41-5304.
|
||
|
|
</p>
|
||
|
|
<p>You can specify the value *ANY or a value ranging from 1 through 255 on this parameter.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPF.FRCRATIO"></a>
|
||
|
|
<h3>Records to force a write (FRCRATIO)</h3>
|
||
|
|
<p>Specifies the number of inserted or updated records that are processed before the records are forced into auxiliary storage. If this physical file is being journaled, either a large number or *NONE should be used. *NONE may cause long synchronization of the journal and physical files.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>There is no specified force ratio. The system determines when the records are written to auxiliary storage.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>integer</i></b></dt>
|
||
|
|
<dd>Specify the number of inserted or updated records that are processed before the records are written to auxiliary storage.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPF.WAITFILE"></a>
|
||
|
|
<h3>Maximum file wait time (WAITFILE)</h3>
|
||
|
|
<p>Specifies the number of seconds that the program waits for the file resources to be allocated when the file is opened, or the device or session resources to be allocated when an acquire operation is performed to the file. If the file resources cannot be allocated in the specified wait time, an error message is sent to the program.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*IMMED</u></b></dt>
|
||
|
|
<dd>The program does not wait. Immediate allocation of file resources is required.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*CLS</b></dt>
|
||
|
|
<dd>The job default wait time is used as the wait time for the file resources to be allocated.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>1-32767</i></b></dt>
|
||
|
|
<dd>Specify the number of seconds to wait for file resources to be allocated.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPF.WAITRCD"></a>
|
||
|
|
<h3>Maximum record wait time (WAITRCD)</h3>
|
||
|
|
<p>Specifies the number of seconds that the program waits for a record being changed or deleted. If the record cannot be allocated within the specified wait time, an error message is sent to the program.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>60</u></b></dt>
|
||
|
|
<dd>The program waits for 60 seconds for a record being changed or deleted.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*IMMED</b></dt>
|
||
|
|
<dd>The program does not wait; when a record is locked, an immediate allocation of the record is required.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*NOMAX</b></dt>
|
||
|
|
<dd>The wait time is the maximum allowed by the system (32,767 seconds).
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>1-32767</i></b></dt>
|
||
|
|
<dd>Specify the number of seconds that the program waits for a record being changed or deleted.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPF.SHARE"></a>
|
||
|
|
<h3>Share open data path (SHARE)</h3>
|
||
|
|
<p>Specifies whether the open data path (ODP) is shared with other programs in the same routing step. When an ODP is shared, the programs accessing the file share facilities such as the file status and the buffer.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This parameter cannot be specified when *NONE is specified for the <b>Member (MBR)</b> parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NO</u></b></dt>
|
||
|
|
<dd>The ODP is not shared with other programs in the routing step. A new ODP for the file is created and used every time a program opens the file.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b></b></dt>
|
||
|
|
<dd>A new ODP for the file is created and used every time a program opens the file with *NO specified for this parameter.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>The same ODP is shared with each program in the job that also specifies *YES when it opens the file.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPF.DLTPCT"></a>
|
||
|
|
<h3>Max % deleted records allowed (DLTPCT)</h3>
|
||
|
|
<p>Specifies the maximum allowed percentage of deleted records for each member in the physical file. The percentage check is made when the member is closed. If the percentage of deleted records is greater than the value specified on this parameter, a message is sent to the system history log (QHST) to inform the user.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>The percentage of deleted records in the file members is not checked.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>1-100</i></b></dt>
|
||
|
|
<dd>Specify the largest allowed percentage of deleted records for any member in the file.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPF.REUSEDLT"></a>
|
||
|
|
<h3>Reuse deleted records (REUSEDLT)</h3>
|
||
|
|
<p>Specifies whether the space used by deleted data entries should be reclaimed by future insert requests.
|
||
|
|
</p>
|
||
|
|
<p><b>Notes:</b>
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>If *YES is specified on this parameter, the key ordering attribute for the physical file in the Data Description Specifications (DDS) source cannot be "FIFO" or "LIFO".
|
||
|
|
</li>
|
||
|
|
<li>If a *YES value is specified for this parameter, the arrival order becomes meaningless for a file that reuses deleted record space. Records might not be added at the end of the file.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NO</u></b></dt>
|
||
|
|
<dd>The file does not reclaim space used by deleted data entries.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>The file reclaims space used by deleted data entries.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPF.SRTSEQ"></a>
|
||
|
|
<h3>Sort sequence (SRTSEQ)</h3>
|
||
|
|
<p>Specifies the sort sequence used for this file. The sort sequence is used with the LANGID and CCSID parameters to determine which sort sequence table is used.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SRC</u></b></dt>
|
||
|
|
<dd>The table specified in the data description specification (DDS) on the ALTSEQ keyword is used. If ALTSEQ is not used in the DDS, use the value specified for *JOB on this parameter.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*JOB</b></dt>
|
||
|
|
<dd>The sort sequence value used is the value for the job issuing this command to create the physical file.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LANGIDSHR</b></dt>
|
||
|
|
<dd>The sort sequence table can contain the same weight for multiple characters, and is the shared weighted table associated with the language specified in the LANGID parameter.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LANGIDUNQ</b></dt>
|
||
|
|
<dd>The sort sequence table must contain a unique weight for each character in the code page.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*HEX</b></dt>
|
||
|
|
<dd>A sort sequence table is not used, and the hexadecimal values of the characters are used to determine the sort sequence.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Qualifier 1: Sort sequence</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the sort sequence table.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Qualifier 2: Library</b>
|
||
|
|
</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 searched. If no library is specified as the current library for the job, the QGPL library is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library to be searched.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPF.LANGID"></a>
|
||
|
|
<h3>Language ID (LANGID)</h3>
|
||
|
|
<p>Specifies the language identifier used when *LANGIDSHR or *LANGIDUNQ is specified on the SRTSEQ parameter. The language identifier is used with the SRTSEQ and CCSID parameters to determine which sort sequence table the file will use.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*JOB</u></b></dt>
|
||
|
|
<dd>The language identifier specified for the job is used.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>character-value</i></b></dt>
|
||
|
|
<dd>Specify a language identifier. To see a complete list of identifiers when prompting this command, position the cursor on the field for this parameter and press F4 (Prompt).
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPF.CCSID"></a>
|
||
|
|
<h3>Coded character set ID (CCSID)</h3>
|
||
|
|
<p>Specifies the coded character set identifier (CCSID) being used to describe character data in the fields of the file.
|
||
|
|
</p>
|
||
|
|
<p>This parameter is applicable only if no value is specified for the <b>Source file (SRCFILE)</b> parameter and if a value is specified for the <b>Record length (RCDLEN)</b> parameter. If you specify a value other than the default value (*JOB) on this parameter, the SRCFILE parameter is not used, and a value must be specified for the RCDLEN parameter.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>A file created with no DDS when FILETYPE(*DATA) is specified has a CCSID of 65535, regardless of the job CCSID value.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*JOB</u></b></dt>
|
||
|
|
<dd>The current job's default CCSID is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*HEX</b></dt>
|
||
|
|
<dd>The CCSID 65535 is used, which indicates that character data in the fields is treated as bit data and is not converted.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>integer</i></b></dt>
|
||
|
|
<dd>Specify the CCSID to be used. More information about CCSIDs is in the Globalization topic in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPF.ALWUPD"></a>
|
||
|
|
<h3>Allow update operation (ALWUPD)</h3>
|
||
|
|
<p>Specifies whether records in this physical file can be updated.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*YES</u></b></dt>
|
||
|
|
<dd>Records in this physical file can be updated.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>Records in this physical file, or in any logical file that accesses the records in this physical file, cannot be updated.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPF.ALWDLT"></a>
|
||
|
|
<h3>Allow delete operation (ALWDLT)</h3>
|
||
|
|
<p>Specifies whether records in this physical file can be deleted. Records in a logical file can be deleted only when the records in each physical file on which the logical file is based can be deleted.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*YES</u></b></dt>
|
||
|
|
<dd>Records in this physical file can be deleted.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>Records in this physical file, or in any logical file that accesses the records in this physical file, cannot be deleted.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPF.LVLCHK"></a>
|
||
|
|
<h3>Record format level check (LVLCHK)</h3>
|
||
|
|
<p>Specifies whether the level identifiers of the record formats in the physical file are checked when the file is opened by a program.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*YES</u></b></dt>
|
||
|
|
<dd>The level identifiers of the record formats are checked. If the level identifiers do not all match, an open error message is sent to the program requesting the open operation.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>The level identifiers are not checked when the file is opened.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPF.NODGRP"></a>
|
||
|
|
<h3>Node group (NODGRP)</h3>
|
||
|
|
<p>Specifies a node group across which the file is to be distributed.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>The file is not a distributed file. All data associated with the file is on the local system.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Qualifier 1: Node group</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of a node group associated with this file.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Qualifier 2: Library</b>
|
||
|
|
</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 thread is searched. If no library is specified as the current library for the thread, the QGPL library is searched.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library to be searched.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPF.PTNKEY"></a>
|
||
|
|
<h3>Partitioning Key (PTNKEY)</h3>
|
||
|
|
<p>Specifies the field, or set of fields, that is used as the partition key for distributing data. Up to 300 field names can be specified.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This parameter is not valid if *NONE is specified for the <b>Node group (NODGRP)</b> parameter. If a node group name is specified for the NODGRP parameter, one or more field names must be specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of a field to be included in the partition key.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTPF.AUT"></a>
|
||
|
|
<h3>Authority (AUT)</h3>
|
||
|
|
<p>Specifies the authority you are giving to users who do not have specific authority for the object, who are not on an authorization list, and whose group profile or supplemental group profiles do not have specific authority for the object.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LIBCRTAUT</u></b></dt>
|
||
|
|
<dd>The system determines the authority for the object by using the value specified for the <b>Create authority (CRTAUT)</b> parameter on the Create Library command (CRTLIB) for the library containing the object to be created. If the value specified for the CRTAUT parameter is changed, the new value will not affect any existing objects.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*CHANGE</b></dt>
|
||
|
|
<dd>The user can perform all operations on the object except those limited to the owner or controlled by object existence (*OBJEXIST) and object management (*OBJMGT) authorities. The user can change and perform basic functions on the object. *CHANGE authority provides object operational (*OBJOPR) authority and all data authority. If the object is an authorization list, the user cannot add, change, or remove users.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>The user can perform all operations except those limited to the owner or controlled by authorization list management (*AUTLMGT) authority. The user can control the object's existence, specify the security for the object, change the object, and perform basic functions on the object. The user also can change ownership of the object.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*USE</b></dt>
|
||
|
|
<dd>The user can perform basic operations on the object, such as running a program or reading a file. The user cannot change the object. Use (*USE) authority provides object operational (*OBJOPR), read (*READ), and execute (*EXECUTE) authorities.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*EXCLUDE</b></dt>
|
||
|
|
<dd>The user cannot access the object.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of an authorization list to be used for authority to the object. Users included in the authorization list are granted authority to the object as specified in the list. The authorization list must exist when the object is created.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CRTPF.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Creating a Physical File</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CRTPF FILE(PAYLIB/PAYTXS) SRCFILE(SRCLIB/PAYTXS)
|
||
|
|
MBR(*NONE) MAXMBRS(5)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command creates a physical file named PAYTXS in the PAYLIB library. The source descriptions in the member PAYTXS in source file PAYTXS in the SRCLIB library are used to create the physical file. The file is created without members (*NONE was specified); therefore, no data can be put into the file until a member is added later. As many as five members can be contained in the file.
|
||
|
|
</p>
|
||
|
|
<p>By default, each file member added later will contain data records. The access path of each member is continuously maintained. Each member can have up to 10,000 records before automatic extensions (three increments maximum) occur that add 1000 records to the capacity of the member. Storage space for each member is allocated only as needed, with no restrictions on whether the space is contiguous; there is no initial storage allocation. The public has object operational, read, add, delete, and update authority for the file.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Creating a Physical File and Member</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CRTPF FILE(ORDERCTL/ORDERS) SRCFILE(ORDERCTL/ORDERSRC)
|
||
|
|
SRCMBR(MFGORD) MAXMBRS(50) SIZE(1000 100 5)
|
||
|
|
ALLOCATE(*YES)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command creates a physical file and physical file member, both named ORDERS in the ORDERCTL library. The file and its member are created from the MFGORD source member of the ORDERSRC source file in the same library. Storage space for the records placed in the file need not be contiguous. Up to 50 members can be contained in the file. The initial allocation of storage provides for up to 1000 records, and up to five increments of additional space for 100 records each can be added automatically. These allocation values also apply to each member of this physical file that is added later.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CRTPF.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPF3204</b></dt>
|
||
|
|
<dd>Cannot find object needed for file &1 in &2.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF323C</b></dt>
|
||
|
|
<dd>QRECOVERY library could not be allocated.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF5702</b></dt>
|
||
|
|
<dd>File either not DDM file or not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF7302</b></dt>
|
||
|
|
<dd>File &1 not created in library &2.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|