home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / fileutil / zcopy101.arj / ZCOPY.DOC < prev    next >
Encoding:
Text File  |  1992-02-24  |  4.5 KB  |  130 lines
  1.  
  2.                                 ZCOPY 1.01
  3.  
  4.                Copyright 1991-1992 InterZone Software, Inc.
  5.                             All Rights Reserved
  6.  
  7.                          Written by Peter Stewart
  8.  
  9.  
  10.                               INTRODUCTION
  11.                               ============
  12.  
  13.     This program was born out of frustration with the existing programs
  14.     to copy files fast and under a multi-node environment where it's
  15.     not unheard of to get sharing violations in the middle of a copy.
  16.     No problem if you're there to press the keys to get it going again
  17.     but if you run a multi-node BBS, often one of your nodes would sit
  18.     the the old Abort, Retry, Fail? waiting for a human to come along and
  19.     give it a tweak.
  20.  
  21.     So we wrote ZCOPY. It is a fast, simple, easy to use commandline copy
  22.     program in the same vein as Xcopy (which comes with DOS).
  23.  
  24.     This program has no warranty or guarantee other than to take up
  25.     space on your hard drive. This program is Freeware and you should
  26.     feel free to use it.
  27.  
  28.     This program MAY NOT be commercially reproduced or sold by anyone.
  29.     This includes as part of a software library in which the user pays
  30.     for the cost of the disk. The author reserves all rights to this
  31.     program.
  32.  
  33.     This program is distributed as FREEWARE. This means that, if you like
  34.     the program and continue to use it why not send us a little thanks.
  35.     Suggestions for improvements/additions are always welcome.
  36.  
  37.  
  38.  
  39.                         HOW TO USE ZCOPY
  40.  
  41.  
  42.   Usage:
  43.  
  44.     COPY FILES:
  45.  
  46.        zcopy [drive:]pathname [drive:][pathname] [switches]
  47.  
  48.     CONCATENATE TWO OR MORE FILES:
  49.  
  50.        zcopy [drive:]pathname+[drive:]pathname [switches]
  51.  
  52.     CONCATENATE SEVERAL FILES TO ONE:
  53.  
  54.        zcopy [drive:]pathname+filename [drive:]pathname [switches]
  55.  
  56.  
  57.   Switches:
  58.  
  59.         /?       Help screen.
  60.  
  61.         /a       Copy only source files with the archive bit set.
  62.  
  63.         /b       Binary mode, don't strip ^Z (concatenation only).
  64.  
  65.         /d:date  Copy files modified on or after specified date (MM-DD-YY).
  66.  
  67.         /e       Copy subdirectories even if they are empty.
  68.  
  69.         /k       Keep attributes of original file.
  70.  
  71.         /m       Same as /a, except it turns off the archive bit on source.
  72.  
  73.         /p       Prompt for confirmation before copying each file.
  74.  
  75.         /r:##    Number of retries on sharing errors (default 10).
  76.  
  77.         /s       Copy subdirectories unless they are empty.
  78.  
  79.         /w       Wait before starting to copy.
  80.  
  81.  
  82.               HOW ZCOPY HANDLES FILE SHARING CONFLICTS
  83.               ========================================
  84.  
  85.    First of all: you should always load share when running in a multi-
  86.    tasking or networking environment. It will prevent programs from
  87.    corrupting the files on your system.
  88.  
  89.    ZCopy always opens all source files in Read-only, Deny-write mode.
  90.  
  91.    Destination files are opened in Read-write, Deny-write mode.
  92.  
  93.    By default, ZCopy will make ten retries, waiting one second between each
  94.    retry, on a sharing error. This is usually enough if two nodes on a BBS, 
  95.    are trying to copy the same file, for example. The number of retries can
  96.    be inreased with the /r: parameter.
  97.  
  98.    The maximum number of retries is 65535. We would recommend that you keep
  99.    the number considerably lower, however...
  100.  
  101.    Example of increasing the number of retries to 99:
  102.  
  103.       ZCOPY file1 file2 /r:99
  104.  
  105.    If ZCopy doesn't succeed after the specified number of retries, it will
  106.    write an error message to the screen, ignore the error and continue
  107.    copying all remaining files in the batch. In an automated system, like
  108.    a BBS or mail system, it is usually preferable that minor errors get
  109.    ignored, so that the system can continue to function as well as 
  110.    possible.
  111.  
  112.                              OTHER INFO
  113.                              ==========
  114.  
  115.     InterZone Software, Inc., also distributes InterMail 2.01, InterPCB
  116.     and other fine programs. Send thanks or inquiries for more information 
  117.     on our other products to:
  118.  
  119.                    InterZone Software, Inc.
  120.                    Peter Stewart/Michele Hamilton-Stewart
  121.                    9050 Pines Blvd., Suite 430
  122.                    Pembroke Pines, Florida 33024
  123.  
  124.  
  125.        Voice: 305-436-4967             InterZone Cafe BBS: 305-436-1085
  126.        Fax: 305-436-5587               SunShine PCBoard: 305-432-2223
  127.        Fidonet: 1:369/35               EchoNet: 50:5030/35
  128.                        RelayNet: ->SUNSHINE
  129.  
  130.