MCOPY Overview
MCOPY Command Line Options
MCOPY Interactive Mode
Sample MCOPY Sessions
:MCOPY Overview

    MCOP٠ i� � fil� cop� progra� designe� fo� us� unde� ZCPR2�  �
I� support� man�� feature� relate� specificall�� t� th� ZCPR� �
System and is very intimately tied into the ZCPR2 System.

    Th� basi� purpos� o� MCOP� i� t� cop�� file� fro� on� �
director� (disk/use� area� t� anothe� unde� ZCPR2��  I� support� �
th堠 name� director�� form� o� ZCPR2��� an� th� sourc� an� �
destinatio� directorie� ca� b� specifie� i� term� o� name� �
directories or DU: forms or both.

    MCOP٠ i� als� intende� t� b� use� fo� backu� purposes��  I� �
ha� th� abilit�� t� repeatedl� cop� � se� o� file� fro� on� �
director�� t� another�� pausin� betwee� successiv� cop� passe� t� �
allo�� th� use� t� chang� disks��  � ke� t� th� us� o� MCOP٠ i� �
genera� i� tha� onc� MCOP� ha� begu� operations�� th� use� nee� �
neve� concer� himsel� wit� War� Bootin� th� syste� afte� changin� �
disks; MCOPY is doing that for him.


    I� copyin� � fil� fro� on� director�� t� another�� MCOP� �
performs the following steps:

         1�  I� log� int� th� sourc� director� an� scan� fo� th� �
files specified by the user

         2��  I� log� int� th� destinatio� directory� determine� �
i� � cop� o� th� fil� exist� o� th� destinatio� an� delete� i� i� �
it does

         3��  MCOP� copie� th� fil� i� th� sourc� director� int� �
the destination directory

         4��  MCOP٠ set� th� attribute� o� th� fil� i� th� �
destinatio� director�� t� b� th� sam� a� thos� i� th� sourc� �
directory

         5��  MCOP� optionall� verifie� bot� file� b� mean� o� � �
CRC Check

    MCOPY is invoked by one of the following forms:

         MCOPY //                 <-- Print Help
         MCOP�                    <-- Ente� Interactiv� Mode
         MCOPY files options      <-- Immediately Copy

    Th� "MCOP� file� options� for� i� extremel� flexibl� i� it� �
capabilities���  Whe firs� invoked��� MCOP٠ ha� ᠠ defaul� �
destinatio� director� define� (b� GENINS)��  Th� "files� fiel� i� �
� serie� o� fil� assignmen� specifications��� wher� suc� � �
specification is of the form:

         dir:=dir:filename.typ or dir:filename.typ

I� th� firs� for� i� encountered�� th� defaul� destinatio� i� �
temporaril�� redefine� t� b� th� director� indicate� o� th� lef� �
o� th� "=� character�� an� al� file� reference� thereafte� unti� �
the next "dir:=dir:filename.typ" form are copied to this default.

    To illustrate my point, note the following example:

         MCOPY FILE1.*,HELP:FILE2.HLP,TEMP:=TEST.TXT,HI.*

Let'� assum� tha� th� defaul� define� b� GENIN� i� th� director� �
name� BACKUP��  I� thi� case�� file� matchin� FILE1.�� i� th� �
curren� director� ar� copie� t� BACKUP�� th� fil� FILE2.HLРi� �
director�� HELР i� copie� t� BACKUP�� th� fil� TEST.TXԠ i� th� �
curren� director� i� copie� t� TEMP�� an� th� file� matchin� HI.� �
in the current directory are copied to TEMP.

    Onc� � DIR:� i� encountered�� th� defaul� destinatio� i� �
redefined��  Encounterin� � differenc� source�� however� doe� no� �
change what the default source directory is.

:MCOPY Command Line Options

    Th� option� portio� o� th� "MCOP� file� options� comman� i� �
a set of none or more of the following characters:

         E -- Test for Existence of File on Destination and
              User Approves Copy before Copy is Done

         I -- User Approves Each File before Copy Begins

         M -- Multiple Copy (Repeat) Facility

         Q -- Quiet Operation (No Activity Displays)

         V -- Verify Facility

    GENIN� i� use� t� se� th� defaul� setting� fo� eac� o� thes� �
option� (turnin� the� o� o� off)� an� th� optio� character� serv� �
to toggle the settings from the defaults.


    Th� Š optio� (Existenc� Test� look� o� th� destinatio� �
director�� t� se� i� th� fil� i� i� abou� t� cop�� i� alread� �
there�  I� the� tell� th� use� o� it� finding� an� ask� hi� i� h� �
want� t� g� ahea� wit� th� copy��  Th� use� ma� elec� t� cop�� o� �
no� cop� a� h� desires.

    Th� ɠ optio� (Inspect� display� al� file� whic� matc� th� �
indicate� sourc� file� t� th� user�� allowin� hi� t� selec� whic� �
file� h� want� t� copy��  I� the� copie� th� selecte� files�  �
MCOP٠ perform� thi� operatio� fo� eac� se� o� file� i� th� �
command line (separated by commas).

    Th� ͠ optio� (Multipl� Copy� pause� befor� startin� th� �
copy�� allowin� th� use� t� abor� th� procedur� o� inser� � dis� �
int� th� source�� th� destination�� o� bot� an� instruc� MCOP� t� �
proceed��  Afte� copyin� al� o� th� indicate� files�� MCOP٠ the� �
pause� again�� allowin� th� use� t� agai� chang� disks��  Thi� �
continues until the user aborts the procedure.


    Th� � optio� (Quiet� turn� of� th� MCOP� activit�� display�  �
I� norma� operation� MCOP� i� constantl� tellin� th� use� wha� i� �
i� doing��  ɠ fee� tha� thi� i� bette� tha� quietl�� havin� �
problems without the user knowing what is going on.

    Th� ֠ optio� (Verify� i� use� t� chec� th� copie� fil� t� �
insur� tha� th� cop� i� good��  Wit� thi� optio� engaged�� MCOP� �
compute� � CR� valu� o� th� sourc� fil� a� i� read� it��  Whe� �
MCOP� ha� complete� th� copy� i� read� th� destinatio� fil� back� �
computin� it� CR� value�� and� whe� complete� i� compare� th� tw� �
CRà values�� tellin� th� use� i� a� erro� i� th� cop�� occurre� �
(i.e., different CRC values resulted).

:MCOPY Interactive Mode

    I栠 th� user'� comman� i� simpl�� "MCOPY"��� the th� �
Interactiv� Mod� i� enabled��  I� respons� t� thi� command� MCOP� �
displays the following prompt:

MCOPY Status: EIMQV -- MCOPY Command (? for Help)?

wher� an� o� th� character� i� "EIMQV� ma� b� omitted�  Th� EIMQ� �
character� indicat� th� statu� o� th� variou� MCOP٠ options� �
namely:

         E indicates that File Existence Test is ON
         I indicates that Inspect Mode is ON
         M indicates that Multiple Copy is ON
         Q indicates that Quiet Mode is ON
         V indicates that MCOPY will Verify

    Th� MCOP� comman� prompte� fo� i� � singl� character�� cas� �
insignificant��  Yo�� ca� toggl� eac� on� o� thes� option� b� �
simply striking the appropriate letter.

    Ther� ar� si� MCOP� Command� t� perfor� variou� functions�  �
These commands are:

         C - Copy a File or Set of Files
         D - Directory Display
         F - Compute Amount of Free Space on Disk
         L - Log in New Directories
         S - Display MCOPY Status
         X or ^C - Exit

    Th� à comman� (Copy�� allow� yo�� t� specif�� � se� o� �
destinations� sources� an� file� a� yo� coul� a� th� comman� lin� �
level����  Eac蠠� se� i� separate䠠 b���� comma󠠠 (like� �
"dir:=dir:f1.typ,f2.typ,dir:=dir:f3.typ").


    Th� � comman� (Directory� display� � sorte� director� t� th� �
use� o� th� defaul� director� o� on� o� hi� choice��  Name� �
directorie� o� th� DU� for� ma� b� use� t� specif� th� directory�  �
Th� defaul� director� i� th� las� destinatio� director� copie� t� �
or selected by the L command.

    Th� Ơ comman� compute� th� amoun� o� fre� spac� lef� o� �
disk.  The user may select the disk or ride with the default.

    Th� � comman� allow� th� use� t� specif� � ne�� destinatio� �
or source directory.

    Th堠 Ӡ comman� tell� th� use� th� Statu� o栠 MCOPY� �
particularl�� wha� th� curren� sourc� an� destinatio� directorie� �
are.

    X or ^C exits MCOPY to ZCPR2.

:Sample MCOPY Sessions

B7>mcopy help:=mcopy.hlp
MCOPY  Version 2.8
       Copy B  7: MCOPY   .HLP to A 16:
No Original File MCOPY   .HLP on Destination
Reading     7K  Writing     7K

   Copy Complete,  Verify Phase --
Reading     7K
   Verify Complete
**** MCOPY Compete ****
           1 File Copied     0 Copy Errors


B7>mcopy 1:=*.hlp,*.txt i
MCOPY  Version 2.8
       Copy B  7: ????????.HLP to B  1:
MCOPY   .HLP -- Copy (Y/N/Q=Quit and Skip Rest/<CR>=Y)? Y
No Original File MCOPY   .HLP on Destination
Reading     7K  Writing     7K

   Copy Complete,  Verify Phase --
Reading     7K
   Verify Complete
       Copy B  7: ????????.TXT to B  1:
HELP    .TXT -- Copy (Y/N/Q=Quit and Skip Rest/<CR>=Y)? Y
S100    .TXT -- Copy (Y/N/Q=Quit and Skip Rest/<CR>=Y)? N
No Orginal File HELP    .TXT on Destination
Reading     1K  Writing     1K

   Copy Complete,  Verify Phase --
Reading     1K
   Verify Complete
**** MCOPY Complete ****
           2 Files Copied     0 Copy Errors

B7>mcopy
MCOPY  Version 2.8
MCOPY Status:     V -- MCOPY Command (? for Help)? ?
       MCOPY Status:  E I M Q V
These Status Characters have the following meanings:
  E - File Existence Test Mode is ON
  I - File Selection Inspect Mode is ON
  M - Muliple Copy Function Mode is ON
  Q - Quiet Mode is ON
  V - Verify Mode is ON

The Status Characters, as commands, toggle their respective modes.
Other valid MCOPY Commands are:
  C - Copy a File or Set of Files
  D - Directory Display
  F - Compute Amount of Free Space on Disk
  L - Log in New User/Disks
  S - Display MCOPY Status (Cur and Dest User/Disk)
  X or ^C - Exit MCOPY


MCOPY Status:     V -- MCOPY Command (? for Help)? d
** Directory Display **
       File Spec (<CR>=C  0:*.*)? b1:
DEMO    .COM    4K  DEMO    .MAC    4K  DEMO    .ZEX    4K  GENINS  .MAC   44K
HELP    .TXT    4K  MCOPY   .HLP    8K  TEMPLATE.MAC   12K
**    80K Occupied by Displayed Files,  4048K Remaining on Disk B **

MCOPY Status:     V -- MCOPY Command (? for Help)? c
       File Spec (<CR>=Abort)? zcpr:=mcopy.hlp
       Copy B  7: MCOPY   .HLP to A 11:
No Original File MCOPY   .HLP on Destination
Reading     7K  Writing     7K

   Copy Complete,  Verify Phase --
Reading     7K
   Verify Complete
**** MCOPY Complete ****
           1 File Copied     0 Copy Errors


MCOPY Status:     V -- MCOPY Command (? for Help)? f
** Free Space Data **
       Disk (<CR>=A)?

1328K Bytes Remaining on Disk A
MCOPY Status:     V -- MCOPY Command (? for Help)? f
** Free Space Data **
       Disk (<CR>=A)? B

4048K Bytes Remaining on Disk B

MCOPY Status:     V -- MCOPY Command (? for Help)? x
** MCOPY Exiting **