CP/M/CPM_CDROM.iso/mbug/mbug001.arc/MCOPY.HLP

Text File | 1979-12-31 | 11KB | 282 lines

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 **