HELP COPY — MicroVMS 4.5B
Creates a new file (or files) from one or more existing files. If device or directory is not specified, your current default device and directory are used. Format COPY input-file-spec,... output-file-spec
Additional information available:
Parameters
input-file-spec Specification(s) of existing file(s) to be copied. Wildcard characters are allowed. Use a plus sign or a comma to concatenate multiple file specifications. If the input file is a directory file, a new empty directory is created as a subdirectory of the named directory. output-file-spec Name of the resultant output file(s). Wildcard characters can be used in place of the directory name, file name, file type, and/or version number to generate multiple output files. You must specify at least one field in the output file specification. Normally, the owner of the output file will be the same as the creator of the output file. However, if a user with extended privileges creates the output file, the owner will be that of the parent directory, or a previous version of the output file if it exists.
Qualifiers
Additional information available:
/ALLOCATION/BACKUP/BEFORE/BY_OWNER/CONCATENATE
/CONFIRM/CONTIGUOUS/CREATED/EXCLUDE/EXPIRED/EXTENSION
/LOG/MODIFIED/OVERLAY/PROTECTION/READ_CHECK
/REPLACE/SINCE/TRUNCATE/VOLUME/WRITE_CHECK
/ALLOCATION=number-of-blocks
Qualifies output-file-spec. Forces the initial allocation of the output file to the specified number of 512-byte blocks. If you do not specify the /ALLOCATION qualifier, the initial allocation of the output file is determined by the size of the input file.
/BACKUP
/CREATED (default) /EXPIRED /MODIFIED Selects files for the copy operation according to the dates of their most recent backups, their creation dates, their expiration dates, or the dates of their last modifications. Relevant only with the /BEFORE and /SINCE qualifiers.
/BEFORE[=time]
Selects for the copy operation only those files with dates (creation, modification, expiration, or backup) that precede the specified time. You can specify time as an absolute time, as a combination of absolute and delta times, or as one of the following keywords: TODAY (default), TOMORROW, YESTERDAY.
/BY_OWNER[=uic]
Selects for the copy operation only those files with the specified user identification code. The default user identification code is that of the current process.
/CONCATENATE (default)
/NOCONCATENATE Creates one output file from multiple input files when wildcard characters are not used in the output-file-spec. A specification of /NOCONCATENATE generates multiple output files. Files from Files-11 Structure Level 2 disks are concatenated in alphanumeric order; if you specify a wild card in the file version field, files are copied in descending order by version number. Files from Files-11 Structure Level 1 disks are concatenated in random order.
/CONFIRM
/NOCONFIRM (default) Issues a request for confirmation before each copy operation. The following responses are valid: +----------+-----------------------------------------------+ | YES | Perform the copy operation | +----------+-----------------------------------------------+ | NO | Do not perform the copy operation | +----------+-----------------------------------------------+ | TRUE | Perform the copy operation | +----------+-----------------------------------------------+ | FALSE | Do not perform the copy operation | +----------+-----------------------------------------------+ | 1 | Perform the copy operation | +----------+-----------------------------------------------+ | 0 | Do not perform the copy operation | +----------+-----------------------------------------------+ | <RETURN> | Perform the copy operation | +----------+-----------------------------------------------+ | ALL | Continue execution of the command with no | | | further confirmation prompts | +----------+-----------------------------------------------+ | <CTRL/Z> | Stop execution of the command | +----------+-----------------------------------------------+ | QUIT | Stop execution of the command | +----------+-----------------------------------------------+
/CONTIGUOUS
/NOCONTIGUOUS Qualifies output-file-spec. Specifies that the output file must occupy contiguous physical disk blocks. By default, the COPY command creates an output file in the same format as the corresponding input file and does not report an error if not enough space exists for a contiguous allocation. The /CONTIGUOUS qualifier has no effect when you copy files to or from tapes because the size of the file on tape cannot be determined until after it is copied to the disk. If you copy a file from a tape and want the file to be contiguous, use the COPY command twice: once to copy the file from the tape, and a second to create a contiguous file.
/CREATED
See /BACKUP.
/EXCLUDE=(file-spec,...)
Omits the specified file(s) from the copy operation. You can include a directory but not a device in the file specification(s). Wildcard characters are supported for file specifications. However, you cannot use relative version numbers to exclude a specific version.
/EXPIRED
See /BACKUP.
/EXTENSION=n
Qualifies output-file-spec. Sets the default extend quantity for the output file.
/LOG
/NOLOG (default) Displays file specifications of input and output files as well as the number of blocks or records copied after each copy operation. Displays the number of files created after the entire copy operation.
/MODIFIED
See /BACKUP.
/OVERLAY
/NOOVERLAY (default) Qualifies output-file-spec Overlays the existing specified file rather than allocating new space for the file.
/PROTECTION=(ownership[:access],...)
Qualifies output-file-spec. Specifies protection for the output file. Specify ownership as SYSTEM, OWNER, GROUP, or WORLD and access as R, W, E, or D. The default protection is that of the existing output file; if no output file exists, the current default protection applies.
/READ_CHECK
/NOREAD_CHECK (default) Qualifies input-file-spec. Reads each record in the input file(s) twice to verify that it has been read correctly.
/REPLACE
/NOREPLACE (default) Qualifies output-file-spec. Deletes (if a version number is specified in the output file) the existing file with that specification and creates a new file (allocating new space). If no version number is specified in the output file specification, a new version of the output file is created (regardless of /REPLACE). If an existing version number is specified in the output file specification without /REPLACE, an error occurs.
/SINCE[=time]
Selects for the copy operation only those files dated (creation, modification, expiration, or backup) after the specified time. You can specify time as an absolute time, a combination of absolute and delta times, or as one of the following keywords: TODAY (default), TOMORROW, YESTERDAY.
/TRUNCATE
/NOTRUNCATE (default) Qualifies output-file-spec. Truncates the output file at end of file during the copy operation. By default, the size of the output file is determined by the allocation of the input file.
/VOLUME=relative-volume-no
Qualifies output-file-spec. Places the output file on the specified relative volume number (n) of a multivolume set. By default, the output file is placed arbitrarily in a multivolume set.
/WRITE_CHECK
/NOWRITE_CHECK (default) Qualifies output-file-spec. Reads each record in the output file(s) after the record is written to verify that it is written correctly.