;
                                  MCOPY.COM                                   

             Size (recs) CRC   Version    Author/Latest Issue      Disk
               5k (37)   D817  4.7B       Howard Goldstein 3/88    Z3COM6

  1- Syntax/Options  2- Notes  3- Error Messages  4- Examples of Use          



   MCOPY  copies files to and from directories.   It provides an easy  way  to 
backup files.  (CP from an RCP also copies and optionally renames files.)  Vs. 
3.0 (1/83) by R. Conn.
:1

   Syntax:  MCOPY dir:=dir:afn1,afn2,dir:=dir:afn3,... o

  Options:  E  -  test for Existence of file on destination and prompt for  
                  approval before copy is done

            I  -  Inspect each file before copy begins

            M  -  Multiple copy facility; allows user to back up several files
                  to several disks by copying all of the files, prompting
                  the user for a new disk, and then copying the files again,
                  continuing until the user says to stop

            N  -  do Not replace if a file of the same name already exists

            Q  -  Quiet operation (no activity displays)

            V  -  Verify copies
:2

MCOPY Notes:

   a. MCOPY only copies files; MCOPY DOES NOT RENAME FILES.  This is a major 
      difference for those used to PIP.  MCOPY text:f1.txt=f2.txt just copies 
      F2.TXT into TEXT: directory, but it is still named F2.TXT (F1.TXT is 
      ignored).

   b. MCOPY uses the ZCPR3 error flag to indicate the success of copies.  At
      entry, the error flag is set to zero.  It is set to non-zero if any
      attempted copies fail (usually due to lack of disk space or verify
      error).

   c. CRCs are calculated only when verification is requested.  

   d. Source file attributes are properly copied to the destination drive.

   e. The help message reflects the settings of MCOPY's defaults.

   f. The ZEX status flag is set to 2 to suppress automatic input. 


MCOPY Notes (continued):

   g. In copying a file from one directory to another, MCOPY...

      - logs into the source directory and scans for specified files 

      - logs into the destination directory, determines if a copy 
        of the file exists on the destination and deletes it if it does

      - copies the file in the source directory into the destination directory

      - sets the attributes of the file in the destination directory to be 
        the same as those in the source directory

      - optionally verifies both files by means of a CRC Check

   h. If a destination directory is not specified, MCOPY looks for a directory
      named BACKUP: and copies to this directory if found.  If there is no 
      directory named BACKUP:, MCOPY will copy to B0: (this can be changed by
      DDT or reassembly).
:3

MCOPY Error Messages:

   "NO Files -- ^C to Abort" 

      - no files matching the indicated file spec were found.

   "TPA Ovfl" 

      - there was not enough room in the Transient Program Area to 
        support MCOPY.

   "Disk Full"  

      - there is no more room on the destination disk for the files.
:4
Examples of Use:

   a. mcopy file1.*,HELP:file2.hlp,TEMP:=test.txt,hi.*

      - Files matching FILE1.* in the current directory are copied to BACKUP:,
        the file FILE2.HLP in directory HELP is copied to BACKUP:, the file
        TEST.TXT in the current directory is copied to TEMP:, and the files 
        matching HI.* in the current directory are copied to TEMP:.

        Once a DIR:= is encountered, the default destination is redefined.   
        Encountering a different source, however, does not change what the 
        default source directory is.

   b. mcopy RAM:=ROOT:*.com,BASE:nw.* /n
      
      - N option is useful for copying often-used utilities to RAM:.  RAM is 
        name given RAM drive, usually the M: directory (for memory) of less 
        than 512k-byte RAM disks.  ROOT is conventional name given directory 
        where utilities are stored.  BASE is used for application programs.  
        If a file already exists on RAM disk, copy does not occur.


Cmd: C

     Example:

          Assume the following directory:

               A15:ROOT