Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

Parameters

Qualifiers

/ALLOCATION

/BACKUP

/BEFORE

/BY_OWNER

/CONCATENATE

/CONFIRM

/CONTIGUOUS

/CREATED

/EXCLUDE

/EXPIRED

/EXTENSION

/LOG

/MODIFIED

/OVERLAY

/PROTECTION

/READ_CHECK

/REPLACE

/SINCE

/TRUNCATE

/VOLUME

/WRITE_CHECK

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:

ParametersQualifiers

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.

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026