CREATE command: File

From m204wiki
Revision as of 19:08, 16 December 2013 by ELowell (talk | contribs)
Jump to navigation Jump to search

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 is the name of the Model 204 file that is being created (1 to 8 characters). The file name cannot be FILE or GROUP and cannot start with CCA, SYS, OUT, TAPE, or a number. It can contain only letters, numbers, and the following special characters:
Special character name Keyboard symbol
At sign (@)
Pound sign (#)
Dollar sign ($)

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

ddname is 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 ddname specified must match the filename.

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

M204.1903: %C 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 CUSTOM=10.

parameter=value specifies 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 the filename. You can use a continuation character to enter long data set lists in the FROM statement.

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 command and INITIALIZE command).

The default FORMAT option causes the CREATE command to physically format the disk space. NOFORMAT suppresses physical formatting of the disk. If one or more of the data sets in the file are new, use FORMAT.

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.

See Creating a file (File management) for more information about file creation and file parameters.