864 lines
36 KiB
HTML
864 lines
36 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 Source Physical File (CRTSRCPF)</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="CRTSRCPF.Top_Of_Page"></a>
|
||
|
|
<h2>Create Source Physical File (CRTSRCPF)</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="#CRTSRCPF.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#CRTSRCPF.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#CRTSRCPF.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="CRTSRCPF"></a>
|
||
|
|
<p>The Create Source Physical File (CRTSRCPF) command creates a source physical file.
|
||
|
|
</p>
|
||
|
|
<p>A source physical file contains source data needed to create objects such as control language (CL) source statements, which are used to create a CL program, or data description specifications (DDS) which (in turn) are used to create a database or device file.
|
||
|
|
</p>
|
||
|
|
<p>A source physical file can have one or more members. The maximum number of members that can be added to the file is specified for the <b>Maximum members (MAXMBRS)</b> parameter.
|
||
|
|
</p>
|
||
|
|
<p><b>Restrictions:</b>
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>This command is conditionally threadsafe. In multithreaded jobs, this command is not threadsafe and fails for Distributed Data Management (DDM) files of type *SNA, when SYSTEM(*RMT) or SYSTEM(*FILETYPE) is specified.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTSRCPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="CRTSRCPF.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="#CRTSRCPF.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"><a href="#CRTSRCPF.RCDLEN"><b>RCDLEN</b></a></td>
|
||
|
|
<td valign="top">Record length</td>
|
||
|
|
<td valign="top"><i>Integer</i>, <b><u>92</u></b></td>
|
||
|
|
<td valign="top">Optional, Positional 2</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTSRCPF.MBR"><b>MBR</b></a></td>
|
||
|
|
<td valign="top">Member, if desired</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*NONE</u></b>, *FILE</td>
|
||
|
|
<td valign="top">Optional, Positional 3</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTSRCPF.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="#CRTSRCPF.TEXT"><b>TEXT</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>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTSRCPF.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="#CRTSRCPF.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="#CRTSRCPF.MAXMBRS"><b>MAXMBRS</b></a></td>
|
||
|
|
<td valign="top">Maximum members</td>
|
||
|
|
<td valign="top"><i>Integer</i>, <b><u>*NOMAX</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTSRCPF.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="#CRTSRCPF.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="#CRTSRCPF.ACCPTH"><b>ACCPTH</b></a></td>
|
||
|
|
<td valign="top">Access path type</td>
|
||
|
|
<td valign="top"><b><u>*ARRIVAL</u></b>, *KEYED</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTSRCPF.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="#CRTSRCPF.RECOVER"><b>RECOVER</b></a></td>
|
||
|
|
<td valign="top">Access path recovery</td>
|
||
|
|
<td valign="top"><b><u>*NO</u></b>, *AFTIPL, *IPL</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTSRCPF.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="#CRTSRCPF.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>499</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTSRCPF.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="#CRTSRCPF.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="#CRTSRCPF.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="#CRTSRCPF.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="#CRTSRCPF.WAITFILE"><b>WAITFILE</b></a></td>
|
||
|
|
<td valign="top">Maximum file wait time</td>
|
||
|
|
<td valign="top"><i>Integer</i>, <b><u>*IMMED</u></b>, *CLS</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTSRCPF.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="#CRTSRCPF.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="#CRTSRCPF.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="#CRTSRCPF.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="#CRTSRCPF.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="#CRTSRCPF.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="#CRTSRCPF.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="#CRTSRCPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="CRTSRCPF.FILE"></a>
|
||
|
|
<h3>File (FILE)</h3>
|
||
|
|
<p>Specifies the source physical file to be created.
|
||
|
|
</p>
|
||
|
|
<p>If the file is used in a high-level language program, the file name must be consistent with the naming rules of that language. Otherwise, the file must be renamed in the program.
|
||
|
|
</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 source physical file.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Qualifier 2: Library</b>
|
||
|
|
</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>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="#CRTSRCPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTSRCPF.RCDLEN"></a>
|
||
|
|
<h3>Record length (RCDLEN)</h3>
|
||
|
|
<p>Specifies the number of bytes in the length of the records stored in the source physical file. The record format contains three fields: the source sequence number, the date, and the source statement.
|
||
|
|
</p>
|
||
|
|
<p>This parameter must provide 12 positions for the source sequence number and date fields required in each record. These fields are defined with fixed attributes and names, and they have a keyed access path over the sequence number.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>92</u></b></dt>
|
||
|
|
<dd>The record length is 92 bytes. The source sequence number contains 6 bytes, the date contains 6 bytes, and the source statement contains 80 bytes.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>integer</i></b></dt>
|
||
|
|
<dd>Specify the record length of each source record in the file. The value must include 6 bytes for the source sequence number and 6 bytes for the date. Valid values range from 13 through 32766 bytes.
|
||
|
|
<p><b>Double-Byte Character Set Considerations</b>
|
||
|
|
</p>
|
||
|
|
<p>If IGCDTA(*YES) is specified, the RCDLEN parameter must provide six positions for the source sequence number, six positions for the date field, and at least four positions for source start. Valid values for a double-byte character set (DBCS) range from 16 through 32766.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTSRCPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTSRCPF.MBR"></a>
|
||
|
|
<h3>Member (MBR)</h3>
|
||
|
|
<p>Specifies the source file member to be added when the file is created.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No member is added when the file is created.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*FILE</b></dt>
|
||
|
|
<dd>The name of the member to be added is the same as the name specified for the <b>File (FILE)</b> parameter.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the member to be added.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTSRCPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTSRCPF.IGCDTA"></a>
|
||
|
|
<h3>User specified DBCS data (IGCDTA)</h3>
|
||
|
|
<p>Specifies whether the file contains double-byte character set (DBCS) data.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NO</u></b></dt>
|
||
|
|
<dd>The file does not contain DBCS data.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>The file contains DBCS data.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTSRCPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTSRCPF.TEXT"></a>
|
||
|
|
<h3>Text 'description' (TEXT)</h3>
|
||
|
|
<p>Specifies the text that briefly describes the object.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*BLANK</u></b></dt>
|
||
|
|
<dd>No text is specified.
|
||
|
|
</dd>
|
||
|
|
<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="#CRTSRCPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTSRCPF.SYSTEM"></a>
|
||
|
|
<h3>System (SYSTEM)</h3>
|
||
|
|
<p>Specifies whether the source physical file is created on the local system or the remote system.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LCL</u></b></dt>
|
||
|
|
<dd>The source physical file is created on the local system. The file specified for the <b>File (FILE)</b> parameter must not already exist on the system.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*RMT</b></dt>
|
||
|
|
<dd>The source physical file is created on a remote system. The file specified for the FILE parameter must be the name of a DDM file that identifies the remote system and the name of the source 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 source physical file is created on the local system. Otherwise, the file on the FILE parameter must be a DDM file, and the source physical file is created on a remote system. The DDM file identifies the remote system and the name of the source physical file being created.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTSRCPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTSRCPF.EXPDATE"></a>
|
||
|
|
<h3>Expiration date for member (EXPDATE)</h3>
|
||
|
|
<p>Specifies, if a source file member is added when the source physical file is created, the expiration date of the source file member.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>The member being added to the file has no expiration date.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>date</i></b></dt>
|
||
|
|
<dd>Specify the date after which the member being added cannot be used.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTSRCPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTSRCPF.MAXMBRS"></a>
|
||
|
|
<h3>Maximum members (MAXMBRS)</h3>
|
||
|
|
<p>Specifies the maximum number of members that the source physical file can contain.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NOMAX</u></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>intefer</i></b></dt>
|
||
|
|
<dd>Specify the maximum number of members that can be contained in the file. Valid values range from 1 through 32767 members.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTSRCPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTSRCPF.ACCPTHSIZ"></a>
|
||
|
|
<h3>Access path size (ACCPTHSIZ)</h3>
|
||
|
|
<p>Specifies the maximum size of auxiliary storage that can be occupied by access paths that are associated with keyed source physical files. This parameter does not apply to access paths that are created for logical files or for queries that refer to the data in a source 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="#CRTSRCPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTSRCPF.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="#CRTSRCPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTSRCPF.ACCPTH"></a>
|
||
|
|
<h3>Access path type (ACCPTH)</h3>
|
||
|
|
<p>Specifies the type of access path used by all the members in the source physical file.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ARRIVAL</u></b></dt>
|
||
|
|
<dd>The access path is an arrival sequence access path.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*KEYED</b></dt>
|
||
|
|
<dd>The access path is a keyed sequence access path.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTSRCPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTSRCPF.MAINT"></a>
|
||
|
|
<h3>Access path maintenance (MAINT)</h3>
|
||
|
|
<p>Specifies the type of access path maintenance used for all members of the source 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.
|
||
|
|
</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.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*DLY</b></dt>
|
||
|
|
<dd>The maintenance of the access path is delayed until the physical file member is opened for use. 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 open, all changes made to its members are immediately reflected in the access path of those members, no matter what is specified for the MAINT parameter. 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 is small.
|
||
|
|
<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="#CRTSRCPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTSRCPF.RECOVER"></a>
|
||
|
|
<h3>Access path recovery (RECOVER)</h3>
|
||
|
|
<p>Specifies, for files having immediate or delayed maintenance on their access paths, when recovery processing of the file is performed after a system failure occurs while the access path is being changed. This parameter is valid only for files with a keyed access path.
|
||
|
|
</p>
|
||
|
|
<p>If *IMMED or *DLY 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), after IPL has ended (during concurrent job running), 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 paths that must be recovered and what the RECOVER parameter value is for each path. The user can override the RECOVER parameter value on this display. More information 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><u>*NO</u></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.
|
||
|
|
</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 IPL. If a job tries to allocate the file while its access path is being rebuilt, a file open exception occurs. *AFTIPL is the default for files that require unique keys.
|
||
|
|
</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="#CRTSRCPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTSRCPF.FRCACCPTH"></a>
|
||
|
|
<h3>Force keyed access path (FRCACCPTH)</h3>
|
||
|
|
<p>Specifies whether access path changes are forced to auxiliary storage along with the associated records in the source physical file.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NO</u></b></dt>
|
||
|
|
<dd>The access path and the associated records are not written to auxiliary storage whenever the access path is changed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>The access path and the associated records are written to auxiliary storage whenever the access path is changed. *YES cannot be specified if *REBLD is specified for the <b>Access path maintenance (MAINT)</b> parameter.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTSRCPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTSRCPF.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>499</u></b></dt>
|
||
|
|
<dd>A maximum of 499 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="#CRTSRCPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTSRCPF.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="#CRTSRCPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTSRCPF.CONTIG"></a>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTSRCPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTSRCPF.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="#CRTSRCPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTSRCPF.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.
|
||
|
|
</p>
|
||
|
|
<p>The force write ratio specified for a logical file cannot be less than or equal to the smallest force write ratio of its based-on files. If a larger force write ratio is specified, it is ignored and a message is sent informing the user of the action.
|
||
|
|
</p>
|
||
|
|
<p>For example, if the force ratios of three physical files are 2, 6, and 8, the logical file force ratio that is based on these three physical files must be as restrictive as the least of them; that is 2 in this case. Two would be used even if the FRCRATIO parameter is not specified. Thus, each time a program inserts, updates, or deletes two records in the logical file (regardless of which based-on physical files are affected), those records are forced to permanent storage.
|
||
|
|
</p>
|
||
|
|
<p>If a physical file associated with this logical file is being journaled, a large force write ratio or *NONE is specified. More information on journal management is in the Backup and Recovery book, SC41-5304.
|
||
|
|
</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="#CRTSRCPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTSRCPF.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="#CRTSRCPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTSRCPF.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. Immediate allocation of file resources is required.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*NOMAX</b></dt>
|
||
|
|
<dd>The wait time is the maximum allowed by the system, which is 32767 seconds.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>integer</i></b></dt>
|
||
|
|
<dd>Specify the number of seconds that the program waits for a record being changed or deleted. Valid values range from 1 through 32767 seconds.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTSRCPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTSRCPF.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>*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>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTSRCPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTSRCPF.DLTPCT"></a>
|
||
|
|
<h3>Max % deleted records allowed (DLTPCT)</h3>
|
||
|
|
<p>Specifies the maximum percentage of deleted records for each member in the source 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 job log.
|
||
|
|
</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="#CRTSRCPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTSRCPF.CCSID"></a>
|
||
|
|
<h3>Coded character set ID (CCSID)</h3>
|
||
|
|
<p>Specifies the coded character set identifier (CCSID) used to describe character data in the fields of the source file.
|
||
|
|
</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.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTSRCPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTSRCPF.ALWUPD"></a>
|
||
|
|
<h3>Allow update operation (ALWUPD)</h3>
|
||
|
|
<p>Specifies whether records in this source physical file can be updated.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*YES</u></b></dt>
|
||
|
|
<dd>Records in this source file can be updated.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>Records in this source file cannot be updated.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTSRCPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTSRCPF.ALWDLT"></a>
|
||
|
|
<h3>Allow delete operation (ALWDLT)</h3>
|
||
|
|
<p>Specifies whether records in this source physical file can be deleted.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*YES</u></b></dt>
|
||
|
|
<dd>Records in this source file can be deleted.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>Records in this source file cannot be deleted.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTSRCPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTSRCPF.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="#CRTSRCPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CRTSRCPF.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Creating a File Without Members</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CRTSRCPF FILE(SRCLIB/PAYTXS)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command creates a source file named PAYTXS in the SRCLIB library. The file is created without any members; therefore, no data can be put into the file until a member is added later. As many as 32,767 members (*NOMAX) can be added to the file.
|
||
|
|
</p>
|
||
|
|
<p>Each member can have up to 10000 records before automatic extensions (499 increments maximum) occur that add 1000 records to the capacity of the member. Only minimum initial storage is allocated for each member with no restrictions on whether the space is connected. The public has object operational, read, add, delete, and update authority for the file, but no object management or object existence authority.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Creating a File With a Member</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CRTSRCPF FILE(ORDERCTL/ORDERS) MBR(*FILE) SIZE(100 50 5)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command creates a source physical file named ORDERS in the ORDERCTL library. Storage space for the records placed in the file need not be contiguous. The initial allocation of storage provides for up to 100 records, and up to five increments of additional space for 50 records each can be added automatically. These allocation values also apply to members of this source file that will be added later.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 3: Creating a File that Contains DBCS Data</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CRTSRCPF FILE(IGCLIB/IGCSRC) IGCDTA(*YES)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command creates a source physical file named IGCSRC, which is stored in the library IGCLIB, and can contain DBCS data.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTSRCPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CRTSRCPF.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<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="#CRTSRCPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|