COPYFILE Those columns for which you do not specify any data are filled with
blanks or, if you use the FILL option, the fill character of your
choice. For example:
coPvfile sorted list a (specs noprompt lrecl 20 fill $
1-15 6
copies columns 1 through 15 beginning in column 6 and writes dollar
signs ($) in columns 1 through 5.
If you do want to modify data in particular columns of a file but
want to leave all of the rest of each record unchanged, you can use the OVLY (overlay) option. For example, the sequence: COPYFILE * bracket a (specs ovly noprompt had 1 hbd 80 overlays the characters [ (X' AD') and ] (X' BD') in columns 1 and 80 of
all the files with a filetype of BRACKET on your A-disk. When you copy fixed-length files, records
the record length; variable-length files
specified.
are padded or truncated to
are always written as You can perform conversion on particular characters in CMS files or
groups of files with the TRANS option of the COPYFILE command. When you enter the TRANS option, you receive the message: DMSCPY602R ENTER TRANSLATION LIST:
and a read is presented to your virtual machine. You may enter the
translation list. If you do not wish to receive this message, use the NO PROMPT option.
A translation list consists of one or more pairs of characters or hex
digits, each pair representing the character you want to translate and
the character you want to translate it to, respectively. For example:
copy test file a (trans DMSCPY602R ENTER TRANSLATION LIST:
* -A fO 00 ff
specifies that all occurrences of the character * are to be translated
to -, all A's are to be translated to X'FO' and all X'OO's are
to be translated to X'FF's. If any translation specifications you enter conflict with the LOWCASE, EBCDIC, or OPCASE options specified on the same command line,
the translation list takes precedence. In the preceding example, if LOWCASE had also been specified, all A's would be translated to X'FO's, :not "to a's. You can enter translation pairs on more than one line if you enter a
++ as a continuation indicator.
Section 2. CMS Commands 43

COPYFILE ENTER SPECIFICATION LIST: This message prompts you to enter a list when you use
the SPECS option. DMSCPY602R ENTER TRANSLATION LIST: This message prompts you to enter a translation list when you use
the option. COpy 'fn ft fm' [TO IAPPEND, OVLY] 'fn ft fm' [OLDINEW] FILE
This message appears for each file copied with the TYPE option. It
indicates the names of the input file and output file. When you have multiple input files, the output fileid is displayed only
once. DMSCPY003E SCPY02 4E 9E DMSCPY030E DMSCPY031E DM SCPYOf.J2E DMSCPYOf.J8E OM SCPY054E DMSCPY062E DMSCPY063E OM SCPY06 4E DMSCPY065E DM SCPY066E DM SCPY06 7E DMSCPY068E DM SCPY 1 01 S DMSCPY102S DM SCPY 103 S DMSCPY156E DMSCPY157E Dr! SCPY 172E DMSCPY1 7 3E OM SCPyQO 1 T DM SCPyQ03T DM SCPyQ04T {INPUTIOVERLAY} FILE 'fn ft fm' NOT FOUND RC=28 INVALID OPTION 'option' RC=24
FILE 'fn ft fm' ALREADY EXISTS -- SPECIFY 'REPLACE' RC=28 INVALID PARAMETER 'parameter' IN THE OPTION 'option' FIELD
RC=24
FILE 'fn ft fm' ALREADY ACTIVE RC=28 DISK 'mode' IS READ/ONLY RC=36 NO FILEID(S) SPECIFIED RC=24 INVALID 'mode' RC=24 INCOMPLETE FILEID 'fn (ft'] SPECIFIED RC=24 INVALID CHAR '[=I*lchar]' IN FILEID '[fn ft fmJ' RC=20 NO {TRANSLATIONISPECIFICATION} LIST ENTERED RC=40 INVALID [TRANSLATE] SPECIFICATION AT OR NEAR , ••••••••• RC=24 • option' , option' RC=24 OPTION SPECIFIED TWICE RC=24
AND 'option' ARE CONFLICTING OPTIONS RC=24 INPUT FILES ILLEGAL WITH PACK OR UNPACK INPUT FILE 'fn ft fm' NOT IN PACKED RC=32 DISK 'mode' NOT ACCESSED RC=36 OPTIONS • SPECS' TEMP STRING STORAGE EXHAUSTED AT •••••••••• RC=88 MANY FILEIDS RC=88 NUMBER OF SPECS EXCEEDS MAX 20 RC=88 'FROM nnn' NOT FOUND --FILE 'fn ft fm' HAS ONLY 'nnn' RECORDS RC=32
LABEL 'label' NOT FOUND IN FILE 'fn ft fm' RC=32 TO LABEL 'label' {EQUALS I IS AN INITIAL SUBSTRING OF} FRLABEL
'label' RC=24 NO RECORDS WERE COPIED TO OUTPUT FILE 'fn ft fm' RC=40 ERROR AT 'addr': PLIST 'plist' AT 'addr', BASE 'addr', RC Inn' RC=256 IMPOSSIBLE PHASE CODE 'xx' RC=256 UNPACK ERROR AT 'addr', BASE 'addr' RC=256 44 IBM VM/370 eMS Command and Macro Reference