FCOPY commands

Description of all the FCOPY commands.

To Initiate FCOPY

RUN FCOPY.PUB.SYS

   FROM[=fromfile
        =tofile
        =*
        =];TO[=(dfile,kfile)
              =(tofile)
              =tofile
              =*
              =][;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}[={field
                   (field[;field[;...]])} [,EXCLUDE][;LANG=language]]]
   [;{BCDICIN
      BCDICOUT
      EBCDIKIN
      EBCDIKOUT}[={field
                   (field[;field[;...]])}[,EXCLUDE]]]
   [;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][;...])]]
   [;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[;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;COPYACD

COPYACD 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[;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[;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[;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