HELP CREATE — MicroVMS 4.5B
Creates a sequential text file (or files). Specify the content of the file(s) on the lines following the command, one record per line. In interactive mode, terminate the file input with CTRL/Z. In a command procedure, terminate the file input with a line with a dollar sign in column one or with the end of the command procedure. Format CREATE file-spec,...
Additional information available:
Parameters
file-spec Specification(s) of the file(s) being created. Wildcard characters are not allowed. The file name and the file type default to null strings. If the specified file already exists, a new version is created.
Qualifiers
Additional information available:
/LOG/OWNER_UIC/PROTECTION/VOLUME
/LOG
/NOLOG (default) Displays the file specification of each new file created as the command executes.
/OWNER_UIC=uic
Requires SYSPRV privilege for a UIC other than your own. Specifies an owner UIC for the file. The default is the UIC of the current process.
/PROTECTION=(ownership[:access],...)
Specifies protection for the file. Specify ownership as SYSTEM, OWNER, GROUP, or WORLD and protection as R, W, E, or D. The default protection is the current default protection.
/VOLUME=relative-volume-no
Places the file on the specified relative volume of a multivolume set. By default, the file is placed arbitrarily in a multivolume set.
/DIRECTORY
Creates one or more new directories or subdirectories. Format CREATE/DIRECTORY directory-spec,... Requires write access to the master file directory (MFD) to create a first-level directory.
Additional information available:
Parameters
directory-spec,... Valid directory specification optionally preceded by a device name (and colon); the directory defaults to the current default. Wildcard characters are not allowed.
Qualifiers
Additional information available:
/LOG/OWNER_UIC/PROTECTION/VERSION_LIMIT
/VOLUME
/LOG
/NOLOG (default) Displays the directory specification of each directory created as the command executes.
/OWNER_UIC=[uic]
Requires SYSPRV privilege for a UIC other than your own. Specifies an owner UIC for the directory. The default is your UIC. You can specify the keyword PARENT in place of a UIC to mean the UIC of the parent directory. If a user with privileges creates a subdirectory, the default is that the owner of the subdirectory will be the owner of the parent directory (or the owner of the Master File Directory if creating a main level directory). If you do not specifiy the /OWNER_UIC qualifier when creating a directory, the command assigns ownership as follows: (1) if you specify the directory name in either alphanumeric or subdirectory format, the default is your UIC (unless you are privileged in which case the UIC defaults to the parent directory); (2) if you specify the directory in UIC format, the default is the specified UIC.
/PROTECTION=(ownership[:access],...)
Specifies protection for the directory. Specify ownership as SYSTEM, OWNER, GROUP, or WORLD and protection as R, W, E, or D. The default protection is the protection of the parent directory (the master directory for top-level directories) minus any delete access.
/VERSION_LIMIT=limit
Specifies the number of versions of any one file that can exist in the directory. If you go over the limit, the system deletes the lowest numbered version. A specification of 0 means no limit. A maximum limit of approximately 60 versions applies no matter the specification. The default is the limit for the parent directory.
/VOLUME=relative-volume-no
Requests that the directory file be placed on the specified relative volume number of a multi-volume set. By default, the file is placed arbitrarily within the multi-volume set.
/FDL
Creates an empty data file, using the specifications in an FDL (File Definition Language) file. Format CREATE/FDL=fdl-file-spec [data-file-spec] Requires the Program Development Tools Option.
Additional information available:
Parameters
fdl-file-spec Specification of the FDL file that is used to create the data file; the default file type is FDL. data-file-spec Specification of the data file to be created; file name overrides the file name specified in the FDL file.
Qualifiers
Additional information available:
/LOG
/NOLOG (default) Displays the file specification of the created data file.
/NAME_TABLE
Creates a logical name table. Format CREATE/NAME_TABLE table
Additional information available:
Parameters
table A string of from 1 to 31 characters that identifies the logical name table. The string can include alphanumeric characters, the dollar sign, and the underscore.
Qualifiers
Additional information available:
/ATTRIBUTES/EXECUTIVE_MODE/LOG/PARENT_TABLE
/PROTECTION/QUOTA/SUPERVISOR_MODE/USER_MODE
/ATTRIBUTES[=(keyword,...)]
Specifies attributes for the table. By default, no attributes are set. Possible keywords are: +----------+-----------------------------------------------+ | CONFINE | Does not copy the table name or the logical | | | names contained in the table into a spawned | | | subprocess; relevant only for process-private | | | tables. | +----------+-----------------------------------------------+ | NO_ALIAS | Prohibits creation of table names with the | | | same name in an outer (less privileged) access| | | mode in the same logical name table directory;| | | deletes any previously created, identical | | | names in an outer (less privileged) mode in | | | the same logical name directory. | +----------+-----------------------------------------------+ | SUPERSEDE| If a name exists within the appropriate | | | directory at the indicated access mode, it is | | | deleted, and a new table is created. | +----------+-----------------------------------------------+
/EXECUTIVE_MODE
/SUPERVISOR_MODE (default) /USER_MODE Requires SYSNAM privilege for /EXECUTIVE_MODE. Specifies the access mode of the table. If you specify executive mode without having SYSNAM privilege, a supervisor mode logical name table is created.
/LOG (default)
/NOLOG Specifies whether or not an informational message is generated when the SUPERSEDE attribute was specified or when the table already exists but the SUPERSEDE attribute was not specified.
/PARENT_TABLE=table
Requires SYSPRV and ENABLE access to specify a shareable table. Specifies the name of the parent table, which must have the same access mode or an access mode inner to the access mode of table you are creating. Defaults to LNM$PROCESS_DIRECTORY. The parent table determines whether the table is private or shareable and where the quota of the new table comes from.
/PROTECTION=(ownership[:access],...)
Applies the specified protection to shareable name tables. The ownership categories are SYSTEM, OWNER, GROUP, WORLD; the access categories are R (read), W (write), E (enable), and D (delete). The default protection is (SYSTEM:RWED,OWNER:RWED,GROUP:,WORLD:)
/QUOTA=number-of-bytes
Specifies the size limit of the table. The size of each logical name entered in the new table is deducted from this size limit. The new table's quota is statically withdrawn from the parent table's quota holder. The parent table's quota holder is the first logical name table encountered when working upward in the table hierarchy that has an explicit quota and is therefore its own quota holder. If /QUOTA is not specified or the size limit is 0, the parent table's quota holder becomes the new table's quota holder and space is dynamically withdrawn from it whenever a logical name is entered in this new table.
/SUPERVISOR_MODE (default)
See /EXECUTIVE_MODE.
/USER_MODE
See /EXECUTIVE_MODE.