home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 2: Collection B / 17Bit_Collection_B.iso / files / 1359.dms / in.adf / PCopy / PCopy.doc < prev    next >
Encoding:
Text File  |  1990-01-30  |  11.0 KB  |  286 lines
  1.                               PCOPY
  2.  
  3.         Pcopy was made to produce large amounts of different copies in
  4.         busy environs.  Like:  People are talking to you and you are
  5.         searching programs for them in databases.  Others want
  6.         information how to install some driver.  You divert people to
  7.         others you know to be an authority on their problems.  You are
  8.         copiing PD and you have an arrears of two hours.  People ask
  9.         whether their disks are ready yet.
  10.         What are you copiing at the moment?  What have you already
  11.         done?  When to insert the next set?
  12.  
  13.         Pcopy shows the actual situation conveniently arranged, starts
  14.         upon disk insertion, and produces reliable copies, because it
  15.         can verify the written data.
  16.  
  17.         Pcopy does not copy copy-protected disks.  At least not that I
  18.         know.  Its working is similar to that of Trackdisk (The software
  19.         that normally controls the drives).  If Trackdisk cannot read a
  20.         disk, than Pcopy probably will not be able too.
  21.  
  22.         If your source disk is failing, you can let Pcopy try to produce
  23.         a copy with the original data recovered.
  24.  
  25.         Although Pcopy displays a lot of information, I think it is a
  26.         rather dangerous copier (on behalf of its autostart
  27.         capabilities) and its application lies in the production area.
  28.  
  29.  
  30.                               START
  31.  
  32.         Pcopy can be executed from either the CLI or the Workbench.
  33.         Two Trackdisk-drives must be available.  That is, ie., the
  34.         internal and a normal external drive.  Selection is done by
  35.         clicking on/off gadgets in a window.  When ready, one can
  36.         proceed by clicking "DONE". If more than two (or less than
  37.         two!) drives are selected, then clicking "DONE" has no effect.
  38.         It is also possible to give the drivenames on the commandline.
  39.         Pcopy will check for drive presence and type.  If the selected
  40.         drives are available, DOS is asked to stay away from them.
  41.         Pcopy takes control of the drives (as does diskcopy) and sets
  42.         up the user interface.  
  43.  
  44.  
  45.                              WINDOWS
  46.  
  47.         There are two small windows (marked "Now in DFx:") which show
  48.         at any moment the drive's contents.  An empty window means an
  49.         empty drive.  Normally the disknames appear in these windows.
  50.         If the disk cannot produce a name, a classification is
  51.         displayed.  All text different from <VolumeName> is printed in
  52.         another color. (black)
  53.  
  54.         In the window "Copy history" appear the names of all
  55.         successfully copied disks.  If you want a name to disappear,
  56.         double click on it.
  57.  
  58.         In the progression window the progress of the copy process is
  59.         graphical presented.  Although the depth gadgets are invisible
  60.         during the copy, they still exist and work.  The graph shows
  61.         where pcopy HAS written.  If the same track is to be written
  62.         more than once (as may occur with verify), the graph shows at
  63.         that point another color.  The number tells where Pcopy has
  64.         written last.
  65.  
  66.         Then there is the control panel with the gadgets in it.
  67.  
  68.  
  69.                              GADGETS
  70.  
  71.  
  72.         -- Verify  ON/OFF
  73.  
  74.         The destination disk is read back and compared with the write
  75.         buffer.  It can be turned on and off during the the copy process.
  76.  
  77.  
  78.         -- DFx: --> DFy:
  79.  
  80.         Defines which drive is source and which is destination.
  81.         Clicking the arrow reverses the direction.
  82.  
  83.  
  84.         -- Adapt Date
  85.  
  86.         DOS can distinguish the copy from the original if the creation
  87.         and last altered date and time are different on both disks.
  88.         If there are two disks present with the same volumename and
  89.         date/time, DOS will crash.  To prevent this, the standard
  90.         Diskcopy changes these fields.  Also if the BMFLAG is -1, it
  91.         changes it to +1. Pcopy can do this too, thus preventing to
  92.         create an exact copy.  Also if some read error could not be
  93.         repaired, Pcopy can set this flag to zero.  This all happens
  94.         with this gadget set to "ON".  Set to "OFF", the copy will be
  95.         exact (if possible).
  96.  
  97.  
  98.         -- Start Copy
  99.  
  100.         To be used to start the copy process manually.  The command is
  101.         hold until it is possible to start the copy process (two disks
  102.         inserted). A second click before the process is started will
  103.         nullify the start command.  This gadget changes into a
  104.         "Stop Copy" gadget during copiing.  A confirmation is required.
  105.         Disk removal, source as well as destination, is treated as a
  106.         confirmed "Stop Copy".
  107.  
  108.  
  109.         -- Auto Start Condition
  110.  
  111.         This whole area is a gadget.  Click in it to cycle the four
  112.         stages.  See auto start for details.
  113.  
  114.  
  115.         -- Triangle gadget
  116.  
  117.         In the topborder there is a gadget with a triangle.  This
  118.         gadget affects the way Pcopy behaves to other disk users.  Its
  119.         usage of the drive hardware it so intensive, that normally
  120.         (triangle pointing up) other users donot get access to their
  121.         drives.  You can let Pcopy be a little more modest by letting
  122.         this gadget point down.  This costs from 3 to 70 seconds or
  123.         more copy time.
  124.  
  125.  
  126.                            AUTO START
  127.  
  128.         When a disk is inserted, it is classified.  To do so, the root
  129.         track is read and analised.  If an error is detected while
  130.         reading this track, Pcopy tries to repair the track to make
  131.         this classification safe.  Four different types are
  132.         distinguished and its classification apears in the "Now in .."
  133.         window:
  134.  
  135.  
  136.         -- New, Unformatted
  137.  
  138.         No data is detected.
  139.  
  140.  
  141.         -- Non DOS
  142.  
  143.         Some data is found. But its format is unknown by Pcopy.
  144.  
  145.  
  146.         -- DOS, no root
  147.  
  148.         The track can be read, but the root sector was not found.
  149.  
  150.  
  151.         -- <VolumeName>
  152.  
  153.         The root is found and the name of the disk is displayed.
  154.  
  155.  
  156.         Now that Pcopy knows what kind of disk its dealing with, it can
  157.         let the copy start depending on a user selected condition.
  158.         These are listed:  
  159.  
  160.  
  161.         -- Off: Manual Start
  162.  
  163.         Pcopy does not start copy until the Start gadget is clicked.
  164.  
  165.  
  166.         -- Dest must be New
  167.  
  168.         Pcopy starts only when a disk is classified as "New, Unformatted".
  169.         The formats that are known to be detected are MS-DOS, MSX,
  170.         Archimedes, Atari and Mac.  Probably most other formats are
  171.         detected too, but you must check it for yourself.
  172.  
  173.         -- Dest may not be DOS
  174.  
  175.         Pcopy starts only when a disk is classified as "New, Unformatted"
  176.         OR "Non DOS". By other systems already formatted disks are
  177.         overwritten.
  178.  
  179.         -- Unconditional Start
  180.  
  181.         Starts always upon insertion.  If the disk is not write
  182.         protected, it is simply overwritten.  This is a dangerous
  183.         selection and is emphasized by changing the gadged's color.
  184.         If an Amiga-DOS disk is to be overwritten, some sound is heard
  185.         and a three second delay will elapse before the copy process
  186.         starts.  When you remove the disk within this delay or click
  187.         the "Stop Copy" gadget, no writing has taken place.  You can
  188.         look at the Progression window, and if no graph or number is
  189.         visible, you were in time.  I can only say:  Donot use this
  190.         selection.
  191.  
  192.  
  193.                             REQUESTERS
  194.  
  195.         If an error is detected, a requester will appear.  If abort is
  196.         chosen, then the copy process will be terminated.  The actions
  197.         following upon retry are listed below:
  198.  
  199.            Source read error # xx
  200.            On cylinder # yy, head z.
  201.            <Short error description>
  202.  
  203.         Retry tries to read again.
  204.         Salve tries to repair the faulting track by multiple reads and
  205.         analysis.  Copy continues after this action.
  206.  
  207.            Destination write error # xx
  208.            On cylinder # yy, head z.
  209.            <Short error description>
  210.  
  211.         Retry tries to write again.
  212.  
  213.            Verify error # xx
  214.            On cylinder # yy, head z.
  215.  
  216.         Retry rewrites the track and checks again.
  217.  
  218.         If you do not know what the errors mean, ignore them.  Do a few
  219.         retries and abort if no success.
  220.  
  221.         Some actions produce confirmation requesters, like Stop Copy and
  222.         the standard stop gadget.  These are straightforward.  But
  223.         perhaps the system is too low on memory to honor the memory
  224.         requests to build the requester.  Then some defaults become
  225.         active:  "Abort" and "User was serious".
  226.  
  227.         The requester is not a true requester but a window with gadgets.
  228.         So if you use DMouse in a certain way, you have to place the
  229.         mouse pointer in this requester to use the standard keyboard
  230.         shortcuts.
  231.  
  232.  
  233.                            TRACK SALVAGE
  234.  
  235.         Pcopy has capabilities to recover data from a damaged track.  The
  236.         history window changes into a report window.  Each salved track
  237.         produces two lines.  The line starting with 'L' reports the not
  238.         recovered labels.  The 'S' reports not recovered sectors.  Behind
  239.         the 'S' and 'L' the tracknumber is displayed.  If the line
  240.         remains empty, you are lucky.  Otherwise the numbers of the not
  241.         recovered labels or sectors will appear.  Normally labels are not
  242.         used, and diskcopy does not copy them at all.  So ignore the
  243.         label report.  The not recovered sectors are more important.  A
  244.         disk that has been completely copied, but with one or more not
  245.         recovered sectors, appears Italic in the history window.  The
  246.         report remains visible as long as the destination disk stays in
  247.         the drive.  A special Pcopy pattern ('Pcopy2',X,0) is written
  248.         into not recovered sectors.  In that case if "Adapt Date" is ON,
  249.         the BMFLAG is made 0.
  250.  
  251.  
  252.                            PERFORMANCE
  253.  
  254.         Pcopy is fast.  The best times:  100/68 seconds, verify ON/OFF.
  255.  
  256.         Pcopy tries to be friendly to other tasks, it leaves them a lot
  257.         of time.  But in its disk use it is truly unfriendly.
  258.         Therefore you can tell Pcopy to give way to other tasks which
  259.         want to use the disk hardware (other drives than those
  260.         controlled by (this) Pcopy, of course).
  261.  
  262.         Pcopy is completely written over again (Fish 151). The copier
  263.         mostly in assembly and the user interface in C.  The user
  264.         interface became a separate task.  Pcopy uses ONLY code and
  265.         data derived from the original .i and .h files.  Therefore
  266.         I think it will be compatible with future releases of the OS.
  267.  
  268.  
  269.                             COPYRIGHT
  270.  
  271.         Copyright 1989 by D.W.Reisig.  Pcopy is freely distributable
  272.         (FreeWare).  All you may charge for is medium costs.  You must
  273.         include this file (Pcopy.doc) with the program (Pcopy). You
  274.         may not change these files.  
  275.  
  276.  
  277.         I like to receive mail, so if you have any suggestions or
  278.         remarks:
  279.  
  280.         Dirk Reisig
  281.         Woudweeren 10
  282.         1151 AV  Broek in Waterland
  283.         Holland
  284.  
  285.         29-Aug-89
  286.