Filter
Top Products
Chapter 3 171
Command Definitions C-E
COPY
COPY
Copies one file to another by creating a new file or by overwriting an existing file.
The COPY command can be used to copy files to and from HFS directories. You cannot use
COPY to copy directories to or from other directories. Users with SM capabilities are able to
copy files to MPE accounts outside of their current logon account.
Syntax
COPY[ FROM=] sourcefile [ { ;TO= | , | blank } targetfile ] [ ASK | YES | NO ]
Parameters
sourcefile The name of the file that is to be copied.
A file with HFS syntax must begin with a dot (.), or a slash (/).
You may not specify system-wide ($ prefix), CM KSAM, or privileged files
as sourcefile or targetfile.
targetfile The name of the file to which sourcefile is to be copied. If targetfile is omitted,
the source file is copied to sourcefile in the user's current working directory
(CWD). You may qualify targetfile with both file and group name, or specify
only the destination group or specify only the destination directory. To
specifiy a group name as the target use .groupname. If only group is
specified, COPY copies the source file to a file named sourcefile targetfile.
Likewise if only a directory is specified, COPY copies the source file to a
file named targetfile/sourcefile.
NOTE Since .groupname can be specified as the targetfile, and HFS file names can also
start with a dot (.), this could lead to confusion as to whether an MPE group
or HFS file name is desired for the targetfile. If the targetfile is an HFS filename
starting with a dot (.), then the targetfile must be preceded with a dot and
slash (./). For example, to represent a targetfile .FOO in an HFS current
working directory, the file must be represented as ./.FOO.
NOTE If the target file is a directory name it may end in a slash (/) to improve
readability of copy in scripts.
NOTE The max extent value for targetfile value may not be the same as for sourcefile.
ASK If targetfile already exists, COPY prompts the user to choose an action with
the following prompt:
PURGE OLD targetfile?
Valid replies to this prompt are:
Y or YES Instructs COPY to purge the original targetfile and create a
new targetfile.