COPYFILE SINGLE suppresses multiple output mode regardless of the manner
in which the file identifiers are specified.
Figure 5 shows combinations of options
together in the same COPYFILE command.
column is specified, none of the options
coded.
that should not be specified
If the option in the first
in the second column should be r , Option I , APPEND , I EBCDI: FOR FRL ABEL FROM LOW-CASE LRECL NEWDATE NEW FILE NOPRO[1PT NOSPE:S NOTRUNC NOTYPE OLDDA!E OVLY PACK PROMPT RECFM REPLA:E SPECS TOLABEL TRANS TRaNC '!'YPE UNPACK UPCASE Figure 5.
-----,
Incompatible Options LRECL, NEWDATE, NEWFILE, OLDDATE, OVLY, PACK, RECFM, REPLACE, UNPACK PACK, UNPACf{ PACK, TOLABEL, UNPACK FROM, PACK, UNPACK FRLABEL, PACK, UNPACK PACK, UNPACK APPEND, PACK, UNPACK APPEND, OLDDATE APPEND, OVLY, REPLACE PROMPT SPECS TRUNC TYPE APPEtfD, NEWDATE APPEND, NEWFILE, PACK, REPLACE, UNPACK APPEND, EBCDIC, FOR, FRLABEL, FROM, LOWCASE, LRECL, OVLY, RECFM, SPECS, TOLABEL, TRANS, TRUNC, UNPACK, UPCASE NOPROMPT APPEND, PACK, UNPACK APPEND, NEWFILE, OVLY NOSPECS, PACK, UNPACK FOR, PACK, UNPACK PACK, UNPACK NOTRUNC, PACK, UNPACK NOTYPE APPEND, EBCDIC, FOR, FRLABEL, FROM, LOWCASE, LRECL, OVLY, PACK, RECFM, SPECS, TOLABEL, TRANS, TRUNC, UPCASE PACK, UNPACK COPYFILE Option Incompatibilities USING THE COPYFILE COMMAND The simplest use of the COPYFILE command is for copying a single CMS file from one disk to another, or making a duplicate copy of the file on
the same disk. For example:
copyfile test1 assemble a test2 assemble a
makes a copy of the file TESTl ASSEMBLE A and names it TEST2 ASSEMBLE A.
38 IBM VMi370 eMS Command and Macro Reference

For those portions of the file identifier that you want
same, you may code an equal sign in the output fileid.
command line above can be entered:
coPvfile test1 assemble a test2 = = COPYFILE to stay the
Thus, the
The equal sign may be used as a prefix or suffix of a file
identifier. For example, the command:
copvfile abc file= type= =
creates an output file called FILEA TYPEB C. When you copy a file from one
the old and new filemodes, and any
to make; for example: virtual disk to another, you specify
filename or filetype change you want
copvfile test3 assemble c good = a
This command makes a copy of the file TEST3 C, and names it GOOD A.
If you want to copy only particular records in a file, you can use
the PRLABEL/TOLABEL options. Por example:
copvfile old test a new test a (frlabel start for 41 copies 41 records from the file OLD TEST Al, beginning with the record
beginning with the character string START into the file NEW TEST 11. You can combine two or more files into a single file with the COPYFILE command. For example: copyfile test datal a test data2 = test data3 b
copies the files TEST DATAl and TEST DATA2 from your A-disk and combines
them into a file, TEST DATA3, on your B-disk.
Note that if any input file has a filemode number of 3, it is possible that the file will be copied in a sequence different from its
order on the disk.
If you want to combine two more files without creating a new file:
use the APPEND option. Por example:
copyfile new list a old list a (append
appends the file NEW LIST A to the bottom of the existing file labeled OLD LIST A.
Note: If the file NEW LIST A has a different LRECL from the file OLD LIST A, the appended data is padded, or truncated
6 to the LRECL of the file OLD LIST A.
Whenever you code an asterisk (*) in an input fileid, you may cause
one or more files to be copied, depending upon the number of files that
satisfy the remaining conditions. For example:
copyfile * test a combined test a
copies all files with a filetype of TEST on your A-disk into a single
file named TEST. If only one file with a filetype of TEST
exists, only that file is copied.
Section 2. CKS Commands 39