CREATE command: File: Difference between revisions

From m204wiki
Jump to navigation Jump to search
No edit summary
 
(8 intermediate revisions by 6 users not shown)
Line 8: Line 8:


==Syntax==
==Syntax==
<p class="syntax">CREATE [FILE] [(FORMAT) | (NOFORMAT)] <var class="term">filename</var>
<p class="syntax">CREATE [FILE] [(FORMAT) | (NOFORMAT)] <var class="term">filename</var> [FROM <var class="term">ddname</var> [,<var class="term">ddname</var>]...]
[FROM <var class="term">ddname</var> [,<var class="term">ddname</var>]...]
[PARAMETER <var class="term">parameter</var>=<var class="term">value</var> [,<var class="term">parameter</var>=<var class="term">value</var>]...]
[PARAMETER <var class="term">parameter</var>=<var class="term">value</var> [,<var class="term">parameter</var>=<var class="term">value</var>]...]
[PARAMETER <var class="term">parameter</var>=<var class="term">value</var> [,<var class="term">parameter</var>=<var class="term">value</var>]...]
[PARAMETER <var class="term">parameter</var>=<var class="term">value</var> [,<var class="term">parameter</var>=<var class="term">value</var>]...]
Line 18: Line 17:
</p>
</p>
   
   
<b>Where:</b>
Where:
<table>  
<table>  
<tr>
<tr>
<th>filename</th>
<th>filename</th>
<td>The name of the <var class="product">Model&nbsp;204</var> file that is being created (1 to 8 characters; 1 to 7 on DOS systems).  
<td>The name of the <var class="product">Model&nbsp;204</var> file that is being created (1 to 8 characters; 1 to 7 on DOS systems).  
<p>The file name cannot be FILE or GROUP and cannot start with CCA, SYS, OUT, TAPE, or a number. The only exception is CCASYS: it can be created in a single user run with the <var>[[SYSOPT parameter|SYSOPT]]</var> X’01’ bit turned off to prevent Model&nbsp;204 from opening CCASYS to make it available for APSY.</p>
<p>The file name cannot be FILE or GROUP and cannot start with CCA, SYS, OUT, TAPE, or a number. The only exception is CCASYS: it can be created in a single user run with the <var>[[SYSOPT parameter|SYSOPT]]</var> X’01’ bit turned off to prevent Model&nbsp;204 from opening CCASYS to make it available for [[Application_Subsystem_development|APSY]].</p>
<p>Otherwise, <var class="term">filename</var> can contain only uppercase letters, numbers, and the following special characters:</p>
<p>Otherwise, <var class="term">filename</var> can contain only uppercase letters, numbers, and the following special characters:
<table>
</p>
 
<table>  
<tr class="head"> <th>Special character name</th> <th>Keyboard symbol</th> </tr>
<tr class="head"> <th>Special character name</th>  
<th>Keyboard symbol</th> </tr>
    
    
<tr> <th><var>At sign </var></th> <td>(@)</td> </tr>
<tr> <th><var>At sign </var></th>  
<td>(@)</td> </tr>
   
   
<tr> <th><var>Pound sign </var></th> <td>(#)</td> </tr>
<tr> <th><var>Pound sign </var></th>  
<td>(#)</td> </tr>
   
   
<tr> <th><var>Dollar sign </var></th> <td>($) <br />(alternately displayed as &#163;)</td> </tr>   
<tr> <th><var>Dollar sign </var></th>  
<td>($) <br />(alternately displayed as &#163;)</td> </tr>   
</table>
</table>


<p>
<p>
The file name must be the ddname of the first or only data set in the file.</p>
The file name must be the DD name of the first or only data set in the file.</p>
</td></tr>
</td></tr>
   
   
<tr>
<tr>
<th>ddname</th>
<th>ddname</th>
<td>The name of a data set from which to create the file; it is required when the file is being created from more than one data set. The first <var class="term">ddname</var> specified must match <var class="term">filename</var>.
<td>The DD name of a data set from which to create the file; it is required when the file is being created from more than one data set. The first <var class="term">ddname</var> specified must match <var class="term">filename</var>.
<p>
<p>
<var class="term">ddname</var> cannot be longer than eight characters; if it is, the command is rejected and the following message is issued: </p>
<var class="term">ddname</var> cannot be longer than eight characters; if it is, the command is rejected and the following message is issued: </p>
<p class="code">M204.1903: %C EXCEEDS 8 CHARACTERS IN LENGTH
<p class="code">M204.1903: <i>item</i> exceeds 8 characters in length
</p>
</p>
<p>
<p>
Line 54: Line 57:
<tr>
<tr>
<th>parameter=value</th>
<th>parameter=value</th>
<td><var class="product">Model&nbsp;204</var> file parameters. Any number of PARAMETER statements can immediately follow the command, and each statement can contain as many parameters in any order as will fit on one input line. File parameters are optional. If you specify no values for the BSIZE, CSIZE, and DSIZE parameters, defaults are used. However, you can calculate and set values for parameters as described in [[Managing file and table sizes]].</td>
<td><var class="product">Model&nbsp;204</var> file parameters. Any number of PARAMETER statements can immediately follow the command, and each statement can contain as many parameters in any order as will fit on one input line. File parameters are optional. If you specify no values for the <var>[[BSIZE_parameter|BSIZE]]</var>, <var>[[CSIZE_parameter|CSIZE]]</var>, and <var>[[DSIZE_parameter|DSIZE]]</var> parameters, defaults are used. However, you can calculate and set values for parameters as described in [[Managing file and table sizes]].</td>
</tr>  
</tr>  
</table>
</table>
Line 62: Line 65:
<li>The <var>FROM</var> clause is optional for files containing a single data set.</li>
<li>The <var>FROM</var> clause is optional for files containing a single data set.</li>


<li>If specified, the <var class="term">ddname</var> of the first data set must match <var class="term">filename</var>. You can use a continuation character to enter long data set lists in the <var>FROM</var> statement.</li>
<li>If specified, the <var class="term">ddname</var> of the first data set must match <var class="term">filename</var>. You can use a continuation character to enter DD name lists in the <var>FROM</var> clause.</li>


<li><var>NO FORMAT</var> is a synonym for <var>NOFORMAT</var>.</li>
<li><var>NO FORMAT</var> is a synonym for <var>NOFORMAT</var>.</li>
Line 79: Line 82:


==Usage notes==
==Usage notes==
<ul>
<li><var>CREATE FILE</var> creates a <var class="product">Model&nbsp;204</var> file. It sets the file parameters and builds the [[File_Control_Table_(File_architecture)|File Control Table (FCT)]]. It should be issued after the values for file parameters are calculated and data sets are allocated. After a file is created, it must be opened and initialized (see the <var>[[OPEN FILE command|OPEN FILE]]</var> and <var>[[INITIALIZE command|INITIALIZE]]</var> commands). </li>
<li>The default <var>FORMAT</var> option causes the <var>CREATE</var> command to physically format the disk space. <var>NOFORMAT</var> suppresses physical formatting of the disk and can result in a significant reduction in elapsed time for the CREATE process, especially in large files. However, if one or more of the data sets in the file are new, you must use <var>FORMAT</var>.
<p>
<p>
<var>CREATE FILE</var> creates a <var class="product">Model&nbsp;204</var> file. It sets the file parameters and builds the File Control Table (FCT). It should be issued after the values for file parameters are calculated and data sets are allocated. After a file is created, it must be opened and initialized (see the [[OPEN FILE command]] and the [[INITIALIZE command]]).     </p>
If <var>NOFORMAT</var> is used and the disk space of the first or only data set is unformatted, Model&nbsp;204 will force formatting anyway and issue the following message.  
<p>
</p>
The default <var>FORMAT</var> option causes the <var>CREATE</var> command to physically format the disk space. <var>NOFORMAT</var> suppresses physical formatting of the disk. If one or more of the data sets in the file are new, use <var>FORMAT</var>.</p>
<p class="code">M204.0793: I​/​O error forced formatting </p>
<p>
<p>  
<var>CREATE</var> establishes the file name and ddnames for all data sets in the file. Once a file is created, you can change the file name and ddname only by recreating the file or by running the [[RESTORE command]]. However, you can add new data sets to the file with the [[INCREASE command]].</p>
In the case of a file that has multiple data sets, Model&nbsp;204 checks the formatting of only the first data set.  If the first data set is formatted, but subsequent data sets are not, the <code>CREATE FILE (NOFORMAT)</code> command fails, and the following message is issued:
<p>
When it processes <var>CREATE FILE</var>, <var class="product">Model&nbsp;204</var> ends any update unit in progress and begins a [[File integrity and recovery#Model 204 update units|non-backoutable update unit]].
</p>
</p>
<p>
<p class="code">M204.2369: DKUPDT disk write failure: </p></li>
See [[Creating a file]] for more information about file creation and file parameters.</p>
 
<li><var>CREATE</var> establishes the file name and DDnames for all data sets in the file. Once a file is created, you can change the file name and DDname only by recreating the file or by running the <var>[[RESTORE command|RESTORE]]</var> command. However, you can add new data sets to the file with the <var>[[INCREASE command|INCREASE]]</var> command. </li>
 
<li>When it processes <var>CREATE FILE</var>, <var class="product">Model&nbsp;204</var> ends any update unit in progress and begins a [[File integrity and recovery#Model 204 update units|non-backoutable update unit]].
</li>
 
<li>For more information about file creation and file parameters, see [[Creating a file]].</li>
</ul>


[[Category: Superuser commands]]
[[Category: Superuser commands]]
[[Category:Commands]]
[[Category:Commands]]

Latest revision as of 15:16, 11 February 2019

Summary

Privileges
Superuser
Function
Creates a Model 204 file

Syntax

CREATE [FILE] [(FORMAT) | (NOFORMAT)] filename [FROM ddname [,ddname]...] [PARAMETER parameter=value [,parameter=value]...] [PARAMETER parameter=value [,parameter=value]...] . . . END

Where:

filename The name of the Model 204 file that is being created (1 to 8 characters; 1 to 7 on DOS systems).

The file name cannot be FILE or GROUP and cannot start with CCA, SYS, OUT, TAPE, or a number. The only exception is CCASYS: it can be created in a single user run with the SYSOPT X’01’ bit turned off to prevent Model 204 from opening CCASYS to make it available for APSY.

Otherwise, filename can contain only uppercase letters, numbers, and the following special characters:

Special character name Keyboard symbol
At sign (@)
Pound sign (#)
Dollar sign ($)
(alternately displayed as £)

The file name must be the DD name of the first or only data set in the file.

ddname The DD name of a data set from which to create the file; it is required when the file is being created from more than one data set. The first ddname specified must match filename.

ddname cannot be longer than eight characters; if it is, the command is rejected and the following message is issued:

M204.1903: item exceeds 8 characters in length

To allow a name of more than eight characters (although only the first eight characters will be used), set the CUSTOM parameter to 10.

parameter=value Model 204 file parameters. Any number of PARAMETER statements can immediately follow the command, and each statement can contain as many parameters in any order as will fit on one input line. File parameters are optional. If you specify no values for the BSIZE, CSIZE, and DSIZE parameters, defaults are used. However, you can calculate and set values for parameters as described in Managing file and table sizes.

Syntax notes

  • The FROM clause is optional for files containing a single data set.
  • If specified, the ddname of the first data set must match filename. You can use a continuation character to enter DD name lists in the FROM clause.
  • NO FORMAT is a synonym for NOFORMAT.
  • A CREATE command must be concluded by an END statement.

Example

CREATE FILE PEOPLE PARAMETER ATRPG=1, FVFPG=10, MVFPG=10 PARAMETER ASTRPPG=345 PARAMETER BSIZE=704, BRECPPG=23, BRESERVE=268 PARAMETER CSIZE=78, DSIZE=470 END

Usage notes

  • CREATE FILE creates a Model 204 file. It sets the file parameters and builds the File Control Table (FCT). It should be issued after the values for file parameters are calculated and data sets are allocated. After a file is created, it must be opened and initialized (see the OPEN FILE and INITIALIZE commands).
  • The default FORMAT option causes the CREATE command to physically format the disk space. NOFORMAT suppresses physical formatting of the disk and can result in a significant reduction in elapsed time for the CREATE process, especially in large files. However, if one or more of the data sets in the file are new, you must use FORMAT.

    If NOFORMAT is used and the disk space of the first or only data set is unformatted, Model 204 will force formatting anyway and issue the following message.

    M204.0793: I​/​O error forced formatting

    In the case of a file that has multiple data sets, Model 204 checks the formatting of only the first data set. If the first data set is formatted, but subsequent data sets are not, the CREATE FILE (NOFORMAT) command fails, and the following message is issued:

    M204.2369: DKUPDT disk write failure:

  • CREATE establishes the file name and DDnames for all data sets in the file. Once a file is created, you can change the file name and DDname only by recreating the file or by running the RESTORE command. However, you can add new data sets to the file with the INCREASE command.
  • When it processes CREATE FILE, Model 204 ends any update unit in progress and begins a non-backoutable update unit.
  • For more information about file creation and file parameters, see Creating a file.