Creates a sequential disk file or files.
Format
CREATE filespec[,...]
1 – Parameter
filespec[,...]
Specifies the name of one or more input files to be created.
Wildcard characters are not allowed. If you omit either the file
name or the file type, the CREATE command does not supply any
defaults. The file name or file type is null. If the specified
file already exists, a new version is created.
2 – Qualifiers
2.1 /LOG
/LOG
/NOLOG (default)
Displays the file specification of each new file created as the
command executes.
2.2 /OWNER_UIC
/OWNER_UIC=uic
Requires SYSPRV (system privilege) privilege to specify a user
identification code (UIC) other than your own.
Specifies the UIC to be associated with the file being created.
Specify the UIC by using standard UIC format as described in the
OpenVMS User's Manual.
2.3 /PROTECTION
/PROTECTION=(ownership[:access][,...])
Specifies protection for the file.
o Specify the ownership parameter as system (S), owner (O),
group (G), or world (W).
o Specify the access parameter as read (R), write (W), execute
(E), or delete (D).
If you do not specify a value for each access category, or if you
omit the /PROTECTION qualifier, the CREATE command applies the
following protection for each unspecified category:
File
Already
Exists? Protection Applied
Yes Protection of the existing file
No Current default protection
NOTE
If you attempt to create a file with no access, the
file is created with the system default RMS protection
values. To create a file with no access, use the SET
SECURITY/PROTECTION command.
For more information on specifying protection codes, see the VSI
OpenVMS Guide to System Security.
2.4 /SYMLINK
/SYMLINK="text"
Creates a symbolic link containing the specified text without
the enclosing quotation marks. If the created symbolic link is
subsequently encountered during any file-name processing, the
contents of the symbolic link are read and treated as a POSIX
pathname specification. No previous version of the symbolic link
can exist.
If the path is absolute (that is, it starts with a slash
character), RMS attempts to translate its first field as a
logical name.
2.5 /VOLUME
/VOLUME=n
Places the file on the specified relative volume of a multivolume
set. By default, the file is placed arbitrarily in a multivolume
set.
3 – Examples
1.$ CREATE MEET.TXT
John, Residents in the apartment complex will hold their annual
meeting this evening. We hope to see you there, Regards, Elwood
<Ctrl/Z>
The CREATE command in this example creates a text file named
MEET.TXT in your default directory. The text file MEET.TXT
contains the lines that follow until the Ctrl/Z.
2.$ CREATE A.DAT, B.DAT
Input line one for A.DAT...
Input line two for A.DAT...
.
.
.
<Ctrl/Z>
Input line one for B.DAT...
Input line two for B.DAT...
.
.
.
<Ctrl/Z>
$
After you enter the CREATE command from the terminal, the
system reads input lines into the sequential file A.DAT until
Ctrl/Z terminates the first input. The next set of input data
is placed in the second file, B.DAT. Again, Ctrl/Z terminates
the input.
3.$ FILE = F$SEARCH("MEET.TXT")
$ IF FILE .EQS. ""
$ THEN CREATE MEET.TXT
John, Residents in the apartment complex will hold their annual
meeting this evening. We hope to see you there, Regards, Elwood
$ ELSE TYPE MEET.TXT
$ ENDIF
$ EXIT
In this example, the command procedure searches the default
disk and directory for the file MEET.TXT. If the command
procedure determines that the file does not exist, it creates a
file named MEET.TXT using the CREATE command.
4.$ SET DEFAULT DKA500:[TEST]
$ SET PROCESS /CASE=CASE_LOOKUP=SENSITIVE /PARSE_STYLE=EXTENDED
$ CREATE COEfile.txt
<Ctrl/Z>
$ CREATE COEFILE.TXT
<Ctrl/Z>
$ CREATE CoEfIlE.txt
<Ctrl/Z>
$ DIRECTORY
Directory DKA500:[TEST]
CoEfIlE.txt;1
COEFILE.TXT;1
COEfile.txt;1
In this example, DKA500 is an ODS-5 disk. If your process is
set to CASE_LOOKUP=SENSITIVE and you create more than one
file with the same name differing only in case, DCL treats
subsequent files as new files and lists them as such.