FCOPY commands
MPE documents | |
 Complete PDF | |
| Table of Contents | |
| Index |
To Initiate FCOPY
RUN FCOPY.PUB.SYS
FROM=[fromfile | * | $CTUL | $CTUR ]
;TO=[(dfile,kfile) | (tofile) | tofile | * | $CTUL | $CTUR ]
[;functionlist]
Syntax of FCOPY Functions
[;NOUSERLABELS] [;{ CCTL | NOCCTL }] [;NEW]
[;{ CLEAR | KANA } [;{ HEX | OCTAL | HEXO }] [;NORECNUM]
[;TITLE=title]]
[;CHAR [;{ HEX | OCTAL | HEXO }] [;NORECNUM] [;TITLE=title]
[;LANG=language]]
[;{ HEX | OCTAL | HEXO } [;{ CHAR | CLEAR | KANA }] [;NORECNUM]
[;TITLE=title]]
[;DEBLOCK=logical-record-length]
[;{EBCDICIN | EBCDICOUT | BCDICIN | BCDICOUT | EBCDIKIN | EBCDIKOUT}
[={ field | (field [;...]) } [,EXCLUDE]
[;LANG=language]]]
[;FILES={ number-of-files | ALL }]
[;IGNERR[=number-of-errors]] [;COMPARE[=number-of-errors]]
[;SKIPEOF=[{+|-}from-eofs | from-file-number]
[,{+|-}to-eofs | to-file-number]]
[;SUBSET={ "characterstring" [,column] [,EXCLUDE] |
#patternlist# [,column] [,EXCLUDE] |
range | (range [;...]) }
pattern := #n1 [,#n2 [,...]]
range := { start-rec, number-of-recs | start-rec : end-rec }
[;NOKSAM] [;KEY[=character-location]]
[;UPSHIFT[;LANG=language]] [;VERIFY[=number-of-errors]]
FCOPY Functions
BCDICIN/BCDICOUT
BCDICIN translates from BCDIC to ASCII. BCDICOUT translates from ASCII to BCDIC.
;{ BCDICIN | BCDICOUT }[={ field | (field [;...]) } [,EXCLUDE]]
FROM=FILE1;TO=FILE2;BCDICIN=(1,5;10:30),EXCLUDE
CCTL/NOCCTL
CCTL designates the first character of each record in the fromfile as a carriage control character in the tofile; NOCCTL specifies that the first character of each record in the fromfile is not to be used as a carriage control character in the tofile.
;{ CCTL | NOCCTL }
FILE BETA;NOCCTL
CHAR
Displays the contents of a file, record by record, in the form of character symbols in ASCII code.
;CHAR [;{ HEX | HEXO | OCTAL }] [;NORECNUM] [;TITLE=title]
[;LANG=language]
FCOPY FROM=DISPL;TO=;OCTAL;CHAR
CLEAR
Displays the contents of a file, record by record, in the form of character symbols for all codes in the file.
;CLEAR [;{ HEX | HEXO | OCTAL }] [;NORECNUM] [;TITLE=title]
FCOPY FROM=DISPL;TO=;OCTAL;CLEAR
COMPARE
Compares the contents of the fromfile with the contents of the tofile, record by record, without changing either file.
;COMPARE[=number-of-errors] FROM=FILEA;TO=DUP1;COMPARE
COPYACD
Copies the access control definition (ACD) associated with a file when the file is being copied.
;COPYACD FROM=SOURCEF;TO=TARGETF;COPYACDCOPYACD applies only to MPE V Delta 4 and subsequent releases and not to MPE/iX.
DEBLOCK
Removes a record from the blocked status.
;DEBLOCK=logical-record-length FILE TAPEBYTE;REC=-790,1,U,ASCII FROM=*TAPEBYTE;TO=DISC1;DEBLOCK=-79
EBCDICIN/EBCDICOUT
EBCDICIN translates from EBCDIC to the character code specified in the translation table of the language you select. EBCDICOUT translates from the character code specified in the translation table of the language you select to EBCDIC. When you do not specify a language, EBCDICIN translates from EBCDIC to ASCII, and EBCDOUT translates from ASCII to EBCDIC.
;{ EBCDICIN | EBCDICOUT }[={ field | (field [;...]) }[,EXCLUDE]
[;LANG=language]]
FROM=*TAPE;TO=DISC1;EBCDICIN=3:7,14:27
EBCDIKIN/EBCDIKOUT
EBCDIKIN translates from EBCDIK (IBM Standard) to JIS (Japanese Industrial Standard). EBCDIKOUT translates from JIS to EBCDIK.
;{ EBCDIKIN | EBCDIKOUT }[={ field | (field [;...]) }[,EXCLUDE]]
FROM=FILE1;TO=FILE2;EBCDIKIN=3:6,EXCLUDE
FILES
Copies multiple files from unlabeled magnetic tapes, serial disks, and cartridge tapes. FCOPY copies only one file if you do not use the FILES function.
;FILES={ number-of-files | ALL }
FROM=*TAPEA;TO=*TAPEB;FILES=3;SUBSET=11:25
HEX
Displays the contents of a file, record by record, in the form of character code numbers in hexadecimal form.
;HEX [;{ CHAR | CLEAR | KANA }] [;NORECNUM] [;TITLE=title]
FROM=TEXT3;TO=*LP;HEX;CHAR;
TITLE="TITLE LINE FOR CHAR/HEX DISPLAY EXAMPLE"
HEXO
Displays the contents of a file, record by record, in the form of character code numbers, the data in hexadecimal form, and the record number in octal form.
;HEXO [;{ CHAR | CLEAR | KANA }] [;NORECNUM] [;TITLE=title]
FROM=TEXT3;TO=*LP;HEXO;CHAR;
TITLE="TITLE LINE FOR CHAR/HEX DISPLAY EXAMPLE"
IGNERR
Bypasses errors in a magnetic tape fromfile and reports each ignored error.
;IGNERR[=number-of-errors] FROM=*TAPE;TP=FILE3;SUBSET;IGNERR=5
KANA
Displays the contents of a file, record by record, in the form of JIS character symbols. KANA displays symbols not represented by characters in JIS code as decimal points.
;KANA [;{ HEX | HEXO | OCTAL }] [;NORECNUM] [;TITLE=title]
;KANA;OCTAL;TITLE="KANA symbols in OCTAL"
KEY
Chooses a key sequence in which to copy KSAM flies. The KEY function works only with KSAM fromfiles.
;KEY [=character-location] FROM=KSAM;TO=ALPHA;KEY=21
NEW
Creates a new permanent disk file as the tofile.
;NEW FROM=OLDSTUFF;TO=NEWFILE;NEW
NOKSAM
Copies the data file of a KSAM file into another, non-KSAM file.
;NOKSAM FROM=KSAMFILE;TO=FILEX;NOKSAM;NOUSERLABELS
NOUSERLABELS
NOUSERLABELS lets you omit user labels when copying from a tape or disk file to another file.
;NOUSERLABELS FROM=*TAPEA;TO=DISC;NOUSERLABELS
OCTAL
Lets you display the contents of a file, record by record, in the form of character code numbers in octal form.
;OCTAL [;{ CHAR | CLEAR | KANA }] [;NORECNUM] [;TITLE=title]
FROM=TEXT3;TO=*LP;OCTAL
SKIPEOF
SKIPEOF instructs FCOPY to skip end-of-file markers on a serial storage device, in order to position the device at the desired file before copying. SKIPEOF is not applicable to labeled tapes.
;SKIPEOF=[{+|-}from-eofs | from-file-number]
[,{+|-}to-eofs | to-file-number]
FROM=*THISTAPE;TO=*THATTAPE;SKIPEOF=4,5
SUBSET
SUBSET lets you copy only a specific portion (subset) of a file. You can define the subset in one of two ways, either as all records with a certain character string or numeric pattern beginning in a specific column, or as a set of continuous records.
;SUBSET={ "characterstring" [,column] [,EXCLUDE] |
#patternlist# [,column] [,EXCLUDE] |
(range [;...]) }
FROM=MASTER;TO=MEN;SUBSET="MALE",17
UPSHIFT
UPSHIFT converts lowercase Roman alphabetic characters to uppercase as part of the copying operation.
;UPSHIFT [;LANG=language] FROM=LOWER;TO=UPPER;UPSHIFT
VERIFY
VERIFY compares the contents of the tofile with the contents of the fromfile, record by record, immediately after a copy operation.
;VERIFY[=number-of-errors] FROM=OLDDISC;TO=COPY;VERIFY
|
Chapter 4 FCOPY Commands |
Chapter 5 SORT-MERGE/XL Commands |