home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / zsus / z3help / c.lbr / CSWEEP.HZP / CSWEEP.HLP
Encoding:
Text File  |  1991-11-18  |  3.6 KB  |  78 lines
  1. ;
  2.                                  CSWEEP.COM                                   
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5.               15k (120)  AAA8  3.0        Lindsay Haisley          Z3COM2
  6.  
  7.   1- Syntax/Options  2- Notes  3- Examples of Use                             
  8.  
  9.    CSWEEP  is a file copy program similar in function to the popular SWEEP and
  10. NEWSWEEP programs,  except that it operates entirely from command line options 
  11. and has no interactive mode.  It differs from PIP in that it allows:
  12.  
  13.    1. Multiple copies to and from different du: areas with a single operation
  14.    2. ZCPR3 style du: access.
  15.    3. Deletion of source files after copying
  16.    4. True CRC file copy checking
  17.    5. Archiving support for making disk backups
  18.    6. Pre-copy file size and disk freespace check
  19. :1
  20.  
  21.    Syntax:  CSWEEP du:f1 [du:f2 .. du:fn] ddu1: [ddu2: ... ddu6:] [options]
  22.  
  23. f1, f2, etc.      <-- Ambiguous file names (! prefix excludes)
  24. ddu1:, ddu2, etc. <-- Destination disk/user or * for current
  25.  
  26.   Options:  -v    <-- Verify (CRC)
  27.             -d    <-- Delete source copies
  28.             -q    <-- Report stats only
  29.             -r    <-- Report stats and copy
  30.             -a    <-- Copy non-archived files and archive source after copying
  31.             -s    <-- Exclude system files from copy
  32.  
  33.    All du: designations are in  the form of  a drive letter followed by a user 
  34. area  number followed by a colon, as in the example above.   If either spec is
  35. omitted,  the current du: is assumed.   Any other format will be flagged as an
  36. error.  The use of the "*" for any destination du: spec designates the current
  37. disk drive and user area.   Filenames,  du: specs and options may be  given in
  38. any order.
  39. :2
  40.     
  41. CSWEEP Notes:
  42.  
  43.    a. CSWEEP is extremely useful for copying  or moving files with any program
  44.       or  operating system that uses  command files,  such as SUBMIT.  It will
  45.       also save  many  keystrokes  over SWEEP or NEWSWEEP  when  moving  large
  46.       numbers  of files  around in your disk system.   CSWEEP is  as  fast  or
  47.       faster than these programs for all types of file copy operations.
  48.  
  49.    b. CSWEEP accepts ambiguous file names  of the standard CP/M sort  with one
  50.       addition.   An ambiguous  file name (afn) preceded  by a "!" causes  all
  51.       names matching the given afn  to  be EXCLUDED from  the  resulting copy.
  52.       When giving  a "!" afn,  "*" chars  in  the string match  to the  end of
  53.       either the filename or extension,  just like CP/M,  but "?" chars  match
  54.       ONE and ONLY ONE character in either the filename or extension.
  55.  
  56.  
  57. CSWEEP Notes (continued):
  58.  
  59.    c. CSWEEP will copy  all files  as instructed unless  a BDOS  file error is
  60.       encountered in  the copy process.   If an  error occurs  in creating  or
  61.       writing to a copy file, CSWEEP will report the error, delete the partial
  62.       copy (if any) and drop  the du: in which the error occurred from further
  63.       copy operations.   Under the -d option,  if  a write error  of  any sort
  64.       occurs during a file copy,  the source file will NOT be deleted.   After
  65.       completing  its work,  CSWEEP will report  a tally of files  copied  and
  66.       errors encountered.
  67.  
  68.    d. If any of the files to be copied already exist on a target disk then the
  69.       space  report  for that  disk will  be in error.   New files will simply
  70.       overwrite old files of the same name.
  71. :3
  72.  
  73. Examples of Use:
  74.  
  75.    a. A>CSWEEP *.* !*.COM B: C0:   
  76.  
  77.       -- Copy all files except *.COM files from the current du: to B: and C0:.
  78.