home *** CD-ROM | disk | FTP | other *** search
/ Frostbyte's 1980s DOS Shareware Collection / floppyshareware.zip / floppyshareware / USCX / DOSUT-16.ZIP / KNEW.DOC < prev    next >
Text File  |  1984-10-14  |  7KB  |  171 lines
  1.                  KOPYNEW - Version 2.00
  2.  
  3.  
  4.     Format:    KNEW
  5.            KNEW S: T:
  6.            KNEW S:FILE.NAM T:
  7.  
  8.     Flags:       /p - do not pause for swapping of diskettes
  9.            /l - do not list messages
  10.            /s - do not list status report at end
  11.  
  12.           KOPYNEW or KNEW copies files from the source drive
  13.      to the target drive if the files have a newer time and date on
  14.      the source or if they are new files on the source drive. The files
  15.      that are copied have the same date and time as they did on the
  16.      source directory.
  17.  
  18.           For example, if there is a file `FILE1.NAM'  dated 10/09/84
  19.      on the source and a file `FILE1.NAM' on the target dated 10/08/84,
  20.      then `FILE1.NAM' would be copied.
  21.  
  22.           If `FILE1.NAM' on the source is dated 10/09/84  with the time
  23.      09:30 am and is dated 10/09/84 on the target but with the time
  24.      stamp of 06:00 am, then it would be copied to the target.
  25.  
  26.           If `FILE1.NAM' is found on the source but not on the target,
  27.      it would be copied.
  28.  
  29.      NOTE: As KOPYNEW uses the time and date stamp from the directories
  30.      to check to see if the source drive has the newer file, the time
  31.      and date must be reasonably accurate. If you do not have a clock
  32.      calendar on you machine, you must set the time and date manually
  33.      or KOPYNEW will not work correctly.
  34.  
  35.      DEFAULTS:
  36.  
  37.           If no drive designators are given, drive C is the
  38.      source and drive A is the target. Otherwise drive S is
  39.      the source and drive T is the target. The drive designators
  40.      must be in the range A to F or a to f.
  41.      FILENAMES:
  42.  
  43.           Standard DOS file names are acceptable for the source drive.
  44.      Wild card characters can be used. There is no facility to accept
  45.      file names for the target drive. Files are copied to the target
  46.      drive and are given the same name as on the source drive. If no
  47.      file name is given, all files are copied. That is, KNEW S: T: and
  48.      KNEW S:*.* T: are equivalent.
  49.  
  50.      FLAGS:
  51.  
  52.           Flags can be added to any of the calling formats. For
  53.      example, KNEW will copy all new or updated files from drive C to
  54.      drive A. KNEW /p will perform the same copy but it will not stop
  55.      and prompt you to insert the diskettes. KNEW /l would also perform
  56.      the same copy but the file by file listing would be omitted.
  57.  
  58.  
  59.           After KNEW is loaded from the disk, it pauses and prompts ypu
  60.      to put the diskettes into the drives. You then press any key to
  61.      continue. If the /p flag is added to the command line, the pause
  62.      is omitted.
  63.  
  64.           KNEW lists the files as they are copied with a status message
  65.      (see below). If the /l flag is added to the status line, no
  66.      messages are listed. The pause is automatically skipped if the /l
  67.      flag is used. This flag also turns off error messages so that it
  68.      should be used with caution.
  69.  
  70.           When KOPYNEW is finished, a summary of the number of files
  71.      copied, not copied and the total number of files is listed.  If
  72.      the /s flag is added to the command line, no summary is listed. As
  73.      the /l and /s flags are independent, the file by file listing can
  74.      be turned off while the summary file can be left on.
  75.  
  76.      STATUS MESSAGES:
  77.  
  78.           S:FILE.NAM Copied - file is newer on the source drive so
  79.                   KNEW copied it to the target drive.
  80.  
  81.           S:FILE.NAM Not Copied - file has the same date and time or
  82.                   is newer on the target drive so it is not
  83.                   copied.
  84.  
  85.           S:FILE.NAM Deleted - file is newer on the source drive so
  86.                   KNEW tried to copy it to the target drive.
  87.                   The copy failed so the file is deleted
  88.                   from the target drive. The file on the
  89.                   source drive is intact.
  90.  
  91.           S:FILE.NAM Created and Copied - file is on the source drive
  92.                   but not the target drive. The file is
  93.                   copied to the target drive.
  94.  
  95.           S:FILE.NAM Created and Deleted - file is on the source drive
  96.                   but not the target drive. The copy
  97.                   failed so the file is deleted from the
  98.                   target drive. The file on the source
  99.                   drive is intact.
  100.  
  101.      OTHER MESSAGES:
  102.  
  103.           Invalid Drive Specification - Drive x
  104.           Drive letters from A to F are acceptable
  105.  
  106.           where x is the invalid drive specification.
  107.  
  108.           Drive or file information not clear
  109.  
  110.           The information on the command line is not clear. Probably,
  111.      the first drive designator or the colon was omitted.
  112.  
  113.           Open Failed for Input File
  114.           Open Failed for Output File
  115.  
  116.           The input or output file could not be opened for some reason.
  117.      Use COPY S:FILE.NAM T: to copy the file that could not be copied
  118.      by KOPYNEW. There could be a problem with the file directory.
  119.  
  120.           All other messages are the same as the Error Return Table
  121.      in the DOS 2.0 manual, appendix D, page D-14. If an unknown
  122.      error code is returned to the programme by DOS, the  message
  123.      `Unexpected Error' is displayed.
  124.  
  125.      Suggested Uses:
  126.  
  127.           KOPYNEW was originally written to be used with ram disks. I
  128.      develop software using a ram disk to hold my Macro Assembler, my
  129.      Linker, my editor and the programme source. As I write in
  130.      assembler, I tend to hang my computer frequently. Therefore I
  131.      always had to copy the programme source, the assembled
  132.      programme and any other files that I did not have a current copy
  133.      of onto a floppy just in case I hung my computer. COPY C:*.* A:
  134.      works but it is slow. KOPYNEW is much faster as it only
  135.      copies new or updated files.
  136.  
  137.           I have also used KOPYNEW in an environment that included a
  138.      regular hard disk with a removable cartridge disk for backup.
  139.      As this was a large dBase II project with over 200 programmes and
  140.      database files, keeping track of which programmes and files had
  141.      been changed during the day become quite difficult. Copying only
  142.      the new or updated files using KNEW C: D: was much faster than
  143.      using COPY C:*.* D:.
  144.  
  145.           I have used KOPYNEW with a Tecmar ram disk, a Tecmar 33
  146.      megabyte hard disk with a 5 megabyte removable cartridge and on a
  147.      Tallgrass 12 megabyte hard disk. I used standard DOS 2.0 function
  148.      calls throughout so that KNEW should work with any hard disk that
  149.      works with DOS 2.0 or higher. If you have any problems, please
  150.      contact me. See below.
  151.  
  152.     Domain:
  153.         KOPYNEW Version 1.00 is copyrighted.
  154.  
  155.         KOPYNEW Version 2.00 is copyrighted. It is, nevertheless,
  156.      public domain software. If you have any comments or suggestions,
  157.      I can be reached through the PCanada Bulletin Board (PC1049) or
  158.      through the CompuServe Network (72365,301). Alternatively, my
  159.      telephone number is 1-416-889-1409.
  160.  
  161.  
  162.  
  163.         This disk copy was originally provided by "The Public Library",
  164.         the software library of the Houston Area League of PC Users.
  165.  
  166.         Programs are available from the Public Library at $2 per disk
  167.         on user-provided disks.  To get a listing of the disks in the
  168.         Public Library, send a self-addressed, stamped envelope to
  169.  
  170.              Nelson Ford,  P.O.Box 61565,  Houston, TX 77208.
  171.