home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / NOVELL / C_B203.ZIP / CBAF66H.DOC < prev   
Encoding:
Text File  |  1988-07-19  |  12.0 KB  |  229 lines
  1.  
  2.        -----------------------------------------------------------------
  3.                                CB version 2.03
  4.                                ~~~~~~~~~~~~~~~
  5.            Copyright (C) 1988 F.M. de Monasterio. All rights reserved
  6.              For personal, non-commercial use only. Cannot be sold.
  7.        -----------------------------------------------------------------
  8.  
  9.                           A Copy and Backup utility
  10.  
  11.  
  12.     Purpose      CB is a fast copy utility that accepts the wildcards
  13.     ~~~~~~~      '*' and '?'  Unlike the copy command of DOS, CB does
  14.                  not allow for changing the name of the copied file.
  15.  
  16.                  The most powerful property of CB.COM is that it will
  17.                  only copy a file (1) for which another with the same
  18.                  name does not already exist in the target or (2), if
  19.                  it does, its time and date stamp is older than that
  20.      --          of the source file, or -if requested by the user- (3)
  21.      --          the archive bit of the source file is on (indicating
  22.                  that this file was opened [irrespective of whether a
  23.                  modification actually took place]).
  24.  
  25.                  Hence, CB is a good substitute for DOS' commands COPY
  26.                  and BACKUP, with the advantage that one does not have
  27.                  to RESTORE the backup files, and that CB warns if the
  28.                  target disk is full.
  29.  
  30. --------------------------------------------------------------------------------
  31.  
  32.     Input        Arguments in the command line:
  33.     ~~~~~
  34.                             ⌐--- copy ---¬  ⌐-- to --¬
  35.                         CB  [d:\path\]File  [d:\]Path\  [/switch(es)]
  36.  
  37.                  Valid switches are:
  38.  
  39.      --          /A = force copy of source file(s) with Archive bit on,
  40.      --               within the updating criteria determined by other
  41.      --               switches (especially /D).  In the absence of any
  42.      --               switch, CB defaults to copy new and more recent
  43.      --               source files.  (The archive bit on indicates the
  44.                       file was at least opened and possibly modified.)
  45.  
  46.                  /B = cancel the default reset of the archive Bit. Use
  47.                       this switch if you intend to use another backup
  48.                       utility, or to make a further backups to another
  49.                       target.
  50.  
  51.                  /D = select only source file(s) for which a Duplicate
  52.                       exists in the target path.   Use to avoid backup
  53.                       of new source files to a target that contains the
  54.                       duplicates.
  55.  
  56.                  /E = cancel the default Echo to screen of the file(s)
  57.                       being copied.  Do not use redirection to the NUL
  58.                       device (bit bucket) as this results in no copy.
  59.  
  60.                  /M = Move the source file to target path.  This switch
  61.                       results in the deletion of the source file after
  62.      --               a successful copy to the target. If an actual copy
  63.      --               was NOT made the source file is NOT erased, even
  64.      --               if a duplicate (target) file already exists which
  65.      --               satisfies the selected update criteria.
  66.  
  67.      --          /N = select only New source file(s), i.e. non-duplicate
  68.      --               ones.  Use to avoid backup of duplicate files. /N
  69.      --               and /D switches are incompatible.
  70.  
  71.                  /R = reject copy to Read only target.  CB defaults to
  72.                       copy to a duplicate target file with or without a
  73.                       Read-Only attribute.  Use this switch to protect
  74.                       RO duplicate target files.
  75.  
  76.                  /T = select Today's date file(s) only. CB will backup
  77.                       only those source files whose date stamp matches
  78.                       the current date provided by DOS to CB (this may
  79.                       not be necessarily the correct date for the day).
  80.  
  81.      --          Some combinations of these switches are incompatible or
  82.      --          conflicting.  To the extent possible, CB honors switches
  83.      --          following the rank:  T > N > D > A
  84.  
  85.                  Wilcards '*' and '?' are accepted in the source's name
  86.                  and are expanded according to DOS rules.
  87.  
  88.                  Note that NAME.EXT is not to be provided for the target
  89.                  copy since the source's name is preserved.  There is no
  90.                  provision for a verify switch (/v) because DOS's verify
  91.                  does not verify the copied data, but only that the disk
  92.                  can be read.
  93.  
  94.                  Also notice that CB will copy source files whose path is
  95.                  indicated or, if a path has not been specified, files of
  96.                  the current directory.  Source files of subordinate level
  97.                  subdirectories are NOT copied to the target path.
  98.  
  99.      --          Although CB checks for obvious attempts of copying a file
  100.      --          to itself, it is possible to defeat these checks and ruin
  101.      --          the file, especially when the /A switch is specified.  It
  102.      --          is YOUR responsibility to avoid such erroneous commands.
  103.  
  104. --------------------------------------------------------------------------------
  105.  
  106.     Output       The selected file (or files if using wild cards) are
  107.     ~~~~~~       written to the selected target path depending on their
  108.                  properties (new, more recent, and/or modified) and the
  109.                  selected combination of switches.
  110.  
  111.  
  112.                  The help screen below is diplayed by invoking CB with
  113.                  a null argument or a '?':
  114.  
  115.  
  116.                        ┌─┘ SYNTAX └───────────────────────────────┐
  117.                        │    ⌐--- copy ---¬ ⌐-- to --¬             │
  118.                        │CB [d:\path\]File [d:\]Path\ [/switch(es)]│
  119.                        │   /A = force Archive+ source file copy   │
  120.                        │   /B = cancel default archive Bit reset  │
  121.                        │   /D = select Duplicate file only        │
  122.                        │   /E = cancel default Echo to screen     │
  123.                        │   /M = Move source file to target path   │
  124.                        │   /N = select New source file only       │
  125.                        │   /R = reject copy to Read only target   │
  126.                        │   /T = select Today's date file only     │
  127.                        └───────────────────────────── Press a key ┘
  128.  
  129.  
  130.     Messages     CB will prompt the user to alternative action if a DOS'
  131.     ~~~~~~~~     critical (disk) error is detected: disk write protected,
  132.                  diskette bay door open, missing diskette, etc; or if the
  133.      --          target disk(ette) is full.  In addition to these sources
  134.      --          of disk error messages, other unexpected sources include
  135.      --          the following:
  136.      
  137.      --          1) The /B switch was not used and the *source* drive is
  138.      --             write-protected: the write-protect error message will
  139.      --             be displayed because CB attempts to reset the archive
  140.      --             bit of the source file.
  141.      --          Solution:
  142.      --             Remove the write protection or use the /B switch.
  143.  
  144.      --          2) If a diskette drive door is opened when copying files
  145.      --             (e.g. CB *.* d:), several messages will be displayed:
  146.      --             first indicating a Disk error 'drive door opened' and
  147.      --             then (erroneously) that the target disk is full.
  148.      --          Solution:
  149.      --             Press ENTER during the 'disk-full' message and copying
  150.      --             will resume at the point it was interupted.
  151.                  
  152. --------------------------------------------------------------------------------
  153.  
  154.    Display      The program has been tested in both EGA and Mono displays
  155.    ~~~~~~~      with no obvious problem.  For displaying the windows, test
  156.                 for display type is made via interrupt 11h.  Text under the
  157.                 window will NOT be restored in graphics mode.  The display
  158.                 colors can be changed with DEBUG in locations 02C1 to 02C4:
  159.  
  160.                 xxxx:02C0  FF 0E 31 1B 1B 00 00 00-00 00 00 00 00 00 00 00
  161.                               ~~ ~~ ~~ ~~
  162.                 where 02C1 is the color of non-window messages, 02C2 that of
  163.                 the critical-error-handler window, 02C3 that of the syntax
  164.                 window, and 02C4 that of the full-disk window.
  165.  
  166. --------------------------------------------------------------------------------
  167.  
  168.    Remarks       Tested in an IBM-AT with an Inboard 386/AT running at a
  169.    ~~~~~~~       Norton SI index of 16.2, and a Landmark test AT "speed"
  170.                  of 24 Mhz, operating under DOS 3.1x or 3.2x, and an IBM
  171.                  XT running at 4.77 Mhz.
  172.  
  173.    Release       Both CB.COM and its documentation are copyrighted,  and
  174.    ~~~~~~~       distributed free of charge for personal, non-commercial
  175.                  use only.  The author makes no warranty, either implied
  176.                  or expressed, including  without limitation any warran-
  177.                  ties with respect to the software documented here,  its
  178.                  quality, performance or fitness for any particular pur-
  179.                  pose. The entire risk as to the quality and performance
  180.                  of the software is with the user.  In no event will the
  181.                  author be liable for any damages, whether direct, indi-
  182.                  rect, special, incidental or consequential arising from
  183.                  the use of or any defect in the software.  By using the
  184.                  program you acknowledge (1) to have read and understood
  185.                  all parts of the disclaimer and (2) to have agreed with
  186.                  and accepted each and all of its provisions.
  187.  
  188. --------------------------------------------------------------------------------
  189.  
  190.    Packing       CB.ARC contains the following files with the noted CRC
  191.    ~~~~~~~       hexadecimal values:
  192.  
  193.                  CB????h  DOC    12290   7-18-88    2:03   CRC: see name
  194.                  CB       COM     6032   7-18-88    2:03   CRC: 03E6h
  195.  
  196.                  The DOC file contains 12290 characters in 1485 words and
  197.                  228 lines; its CRC is shown by the 4 digits in the ARCed
  198.                  DOC file.
  199.  
  200.  
  201. --------------------------------------------------------------------------------
  202.  
  203.    History       Versions 1.00 thru 1.6 were written between 20 Jan 1988
  204.    ~~~~~~~       and 15 June 1988 and beta-tested in situ.
  205.  
  206.    Ver 2.00      11 July 1988 -- circulated in local BBS.
  207.  
  208.    Ver 2.01      13 July 1988 -- Forced CB to check for BREAK request before
  209.                  reseting source's archive bit or before deleting the source
  210.                  file on a move request.  Cleaned up some code.
  211.  
  212.    Ver 2.02      15 July 1988 -- Number of bytes left in disk are shown in 
  213.                  the 'full-disk' window.  The disk letter is now identified
  214.                  in the 'full-disk' string on the screen.  Rearranged code
  215.                  location and added some additional subroutines.
  216.  
  217.    Ver 2.03      18 July 1988 -- Added /N switch to select new files only,
  218.                  and changed /A switch to force the (now) non-default copy
  219.                  of source files with the archive bit on.  Added test for
  220.                  fixed vs. removable medium, and changed the full-disk msg
  221.                  to give option to new disk for removable media only. Added
  222.                  more controls to check for self-copy requests, and modified
  223.                  location of window colors to allow for easier debugging by
  224.                  user.
  225.  
  226. --------------------------------------------------------------------------------         
  227.            F.M. de Monasterio --  phone: 301-496-4269 after 5 pm EST
  228. 
  229.