home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / FLOPPIES / KOPY2.ZIP / KOPY.DOC next >
Encoding:
Text File  |  1990-07-15  |  11.0 KB  |  288 lines
  1.  
  2.  
  3.  
  4.  
  5.      KOPY 1.6
  6.  
  7.      Program and Documentation by Kyle E. Clarke
  8.      Portions copyright (c) 1989 by Kyle E. Clarke, 201 Boylston
  9.          St. Unit B, Jamaica Plains, MA 02130
  10.  
  11.  
  12. I.   GENERAL DESCRIPTION
  13.  
  14.      Kopy makes the task of copying a large directory from a hard
  15.      disk to multiple diskettes easier. You specify the
  16.      directory, and KOPY will split the files across diskettes,
  17.      automatically, prompting you only to insert new diskettes.
  18.      It can serve as a convenient supplement to DOS's BACKUP
  19.      command.
  20.  
  21.      Kopy can be useful at a large facility where there are many
  22.      PC's in use, running several different DOS versions. While
  23.      DOS's BACKUP is incompatible across major version numbers
  24.      (for example, from 3.3 to 4.0), Kopy uses straight copy
  25.      commands, making files copied with Kopy directly accessible.
  26.  
  27.  
  28. II.  DISTRIBUTION
  29.  
  30.      Kopy is shareware/bannerware, and may be used free of cost.
  31.      It may not be sold without my permission. Public domain
  32.      distributors and users groups may charge nominal fees for
  33.      distributing this program.
  34.  
  35.  
  36. III. INSTRUCTIONS
  37.  
  38.      A. Installation
  39.  
  40.         Put Kopy.exe in the same directory as your DOS files on
  41.         your hard disk (for example, C:\DOS). From that point on,
  42.         you can access Kopy from any location on your PC, the
  43.         same way as you access standard DOS programs.
  44.  
  45.  
  46.      B. Using Kopy
  47.  
  48.         When you start Kopy, you will be presented with two
  49.         windows. The first window, at the top of the screen, is
  50.         the interactive window. Kopy asks you questions, requests
  51.         your replies, and sends you messages through the
  52.         interactive window.
  53.  
  54.         ┌───────────────────────────────────────────────────────┐
  55.         │ Press F1 for program information, or...               │
  56.         │                                                       │
  57.         │ Please enter directory files will be copied FROM.     │
  58.         │ Format = drive:[\dir][\subdir][wildcards]             │
  59.         │ For example, c:\lotus  or  c:\wp\wpdat\*.doc  ...     │
  60.         │ >                                                     │
  61.         │                                                       │
  62.         │                                                       │
  63.         │                                                       │
  64.         │                                                       │
  65.         └───────────────────────────────────────────────────────┘
  66.  
  67.         The second window you see is the file display window. In
  68.         this window, once you begin copying files, you will see
  69.         the current file being copied, that file's size, the
  70.         amount of space remaining on the target disk, and the
  71.         capacity of the target disk (in bytes). You will also see
  72.         the maximum number of files that the target diskette can
  73.         hold in its root directory, and the current number of
  74.         files in its root directory. Finally, you will see
  75.         the total number of files you have requested to copy, and
  76.         the sum of the files copied at any point in the copying
  77.         process.
  78.  
  79. ┌───────────────────────────────────────────────────────────────┐
  80. │    File Name              Space, Capacity,   ┌─Root DIR  :──┐ │
  81. │ being copied File Size  Drive  :  Drive  :   │Capacity:     │ │
  82. │ ------------ --------- --------- ---------   │Current :     │ │
  83. │                                              └──────────────┘ │
  84. │                                                               │
  85. │ Files copied:                             Total # Files:      │
  86. └───────────────────────────────────────────────────────────────┘
  87.  
  88.         There are only two prompts (questions) that you need to
  89.         answer: the first, to specify the files to be copied; and
  90.         the second, to specify the location the files are to be
  91.         copied to.
  92.  
  93.  
  94.      C. The First Prompt
  95.  
  96.         The first message you see in the interactive window is:
  97.  
  98.             Press F1 for program information, or...
  99.  
  100.             Please enter directory files will be copied FROM.
  101.             Format = drive:[\dir][\subdir][wildcards]
  102.             For example, c:\lotus  or  c:\wp\wpdat\*.doc  ...
  103.             >
  104.  
  105.         At the prompt ' > ', you should enter a full pathname for
  106.         the files to be copied. Wildcards are optional, and can
  107.         be used to filter what files you would like copied.
  108.         Otherwise, the entire contents of the directory you
  109.         specify will be copied.
  110.  
  111.         Some examples of valid responses to the prompt:
  112.  
  113.             C:\
  114.             C:\DBASE
  115.             C:\????????.BAT
  116.             C:\DOS\*.*
  117.             C:\123\*.WK1
  118.             C:\WP50\*.DOC
  119.             C:\TC\TCFILE\KC*.*
  120.             C:\*.EXE
  121.             C:\LOTUS\????????.WK?
  122.             A:\
  123.  
  124.         Alternately, you could have pressed the F1 key, in which
  125.         case an information screen about the KOPY program would
  126.         have been displayed. From the information screen, by
  127.         pressing any key, you would have returned to the original
  128.         KOPY screen.
  129.  
  130.  
  131.      D. The Second Prompt
  132.  
  133.         The second prompt you will see is as follows:
  134.  
  135.             Please enter the TARGET diskette drive you will
  136.             be copying to, i.e., a, b,...:
  137.  
  138.         You should type in the letter representing the TARGET
  139.         diskette to which you will be copying your files. Note
  140.         well that whatever diskettes you will be copying to, will
  141.         have the contents of their root directories erased.
  142.  
  143.         You have now specified your SOURCE and your TARGET.
  144.  
  145.  
  146.      E. What Happens Next (the File Copying)
  147.  
  148.         In the interactive window, you get three messages. First, you
  149.         get a "Reading Files..." message. Second, Kopy tells
  150.         you how many files it found at the source you specified.
  151.         Third, you get a "Sorting Files..." message, telling you that
  152.         the program is ordering a list of the files that it found.
  153.  
  154.         Then, you will get the following message:
  155.  
  156.             Please insert disk 1 into drive a:
  157.             and press any key to proceed...
  158.  
  159.         Now you can put your first disk in the disk drive, and
  160.         press any key to continue.
  161.  
  162.         The program will switch to the File Display Window, and
  163.         the first filename and filesize will show up, as well as
  164.         the capacity and available space on the target drive.
  165.  
  166.         As more files get copied, their names will show up in the
  167.         File Display Window, as well as the adjusted figure for
  168.         available space on the target drive.
  169.  
  170.         If you have more files than will fit on disk 1, you will
  171.         get the following prompt:
  172.  
  173.             Please insert disk 2 into drive a:
  174.             and press any key to proceed...
  175.  
  176.         Place the second diskette in the target drive, and press
  177.         any key. The process will continue, for as many diskettes
  178.         as it takes to copy the files you have specified.
  179.  
  180.         When the copying is done, Kopy will tell you so, and then
  181.         return you to the DOS prompt.
  182.  
  183.  
  184.      F. What if the file is too big to fit on a diskette?
  185.  
  186.         If the size of a file exceeds the CAPACITY of the first
  187.         diskette that you used, it will be placed aside in a "not
  188.         copied" list. When the KOPY program finishes, it will
  189.         display a list of files, if any, that were too large to
  190.         fit on the "benchmark" first diskette. Kopy will not
  191.         split files across diskettes.
  192.  
  193.  
  194. IV. Kopy FEATURE LIST
  195.  
  196.      1. Up to 1998 files can be copied from a directory.
  197.  
  198.      2. When the capacity of a target diskette's root directory
  199.         has been reached (in terms of total number of file
  200.         entries possible), Kopy will ask you to remove that
  201.         diskette, and place a new one in the diskette drive.
  202.  
  203.      3. Any size diskette can be used. Kopy automatically detects
  204.         the size of the diskette and the free space available on
  205.         the diskette.
  206.  
  207.      4. If any files exceed the capacity of the first (benchmark)
  208.         diskette you use as a target diskette, Kopy will notify
  209.         you of the names of these files, upon program
  210.         termination.
  211.  
  212.      5. Disk drives A-J theoretically can be copied to. (I'd
  213.         appreciate any feedback from anyone with many disk
  214.         drives... e, f, g, etc.).
  215.  
  216.      6. Disk drives A-H theoretically can be copied from.
  217.  
  218.      7. Kopy recognizes all wildcards.
  219.  
  220.      8. Command-line values can be passed to Kopy. For example,
  221.  
  222.             kopy c:\main\*.* a
  223.  
  224.      9. ESC, Ctrl-Break or Ctrl-C may be pressed to abort the
  225.         program.
  226.  
  227.     10. Lots of useful information about the diskette you are
  228.         copying to is provided. An example of what you would see
  229.         when copying is:
  230.  
  231. ┌───────────────────────────────────────────────────────────────┐
  232. │    File Name              Space, Capacity,   ┌─Root DIR A:──┐ │
  233. │ being copied File Size  Drive A:  Drive A:   │Capacity:   64│ │
  234. │ ------------ --------- --------- ---------   │Current :    3│ │
  235. │   DMDRVR.BIN      8442     56832    160256   └──────────────┘ │
  236. │                                                               │
  237. │ Files copied: 3                           Total # Files: 14   │
  238. └───────────────────────────────────────────────────────────────┘
  239.  
  240.  
  241.  
  242. V. REVISION HISTORY
  243.  
  244.      5/15/89  Copy-Master 1.0
  245.  
  246.      5/29/89  Now the program will copy to disk drives besides
  247.               drive a:
  248.  
  249.      5/29/89  The file allocation unit read from each target diskette
  250.               is now used in all operations affecting files copied to
  251.               that diskette.
  252.  
  253.      6/01/89  Copy-Master 1.05
  254.  
  255.      9/1/89   Fixed problem where on certain PC's, or with certain
  256.               versions of DOS, full syntax of destination pathname
  257.               must be specified in order for files to be copied to
  258.               diskette correctly.
  259.  
  260.      9/1/89   Copy-Master 1.06
  261.  
  262.      9/10/89  Revamped entire interface, with introduction of multiple
  263.               windows. Information on the status of file copying,
  264.               the # files, and the capacity and current space
  265.               available on the target disk is displayed in the second
  266.               window.
  267.  
  268.      10/1/89  Copy-Master 1.50
  269.  
  270.      10/2/89  Fixed how program handles files that are beyond the
  271.               capacity of the target diskette, or beyond the
  272.               available initial space on the target diskette.
  273.  
  274.      10/19/89 Shrunk .EXE file size from 61K to 27K.
  275.  
  276.      10/19/89 Copy-Master 1.51
  277.  
  278.      11/25/89 Revised documentation.
  279.  
  280.      7/14/90  Kopy 1.6. Now I'm calling the program KOPY. I
  281.               thoroughly revised the program. No more C2 -- can
  282.               now handle copying to root directories of any size
  283.               disk, without exceeding the root directory's
  284.               capacity. Redid the whole interface, the file
  285.               sorting algorithm, added much more error-checking,
  286.               added a list of files too big to be copied, new
  287.               doc's, etc. EXE size down to 21K.
  288.