home *** CD-ROM | disk | FTP | other *** search
/ Hot Shareware 35 / hot35.iso / ficheros / DCOM / ZIPFT.ZIP / ZIP.DOC < prev    next >
Text File  |  1998-04-15  |  74KB  |  1,334 lines

  1.  
  2.                                    ZIP.DOC
  3.                                    -------
  4.                            Instructions for ZIP.COM
  5.                           Fast File Transfer Utility
  6.                           version 2.12 (15 Apr 1998)
  7.  
  8.                              (c)1988-98 E. Meyer
  9.  
  10.  
  11.         Requires:  Two PC compatible computers with DOS 2.x or above;
  12.                    Null modem cable.
  13.  
  14.  
  15.  ================================= CONTENTS ==================================
  16.  
  17.      1. INTRODUCTION:  Description, Copyright and Licensing
  18.  
  19.      2. BASIC OPERATION
  20.           A. Transferring files
  21.           B. Directory management
  22.  
  23.      3. SELECTIVE TRANSFER AND BACKUP
  24.           A. Selecting files from a group
  25.           B. Reconciling directory contents
  26.           C. Incremental backup
  27.           D. Backing up all subdirectories
  28.  
  29.      4. ADDITIONAL FEATURES
  30.           A. Setting serial port and speed
  31.           B. Waiting for a connection
  32.           C. File and directory handling
  33.           D. Screen output modes
  34.           E. Clock synchronization
  35.  
  36.      5. EXPERT USAGE
  37.           A. Command-line operation
  38.           B. Summary of options
  39.           C. Automating use of ZIP (Redirection, @files, Batch files)
  40.  
  41.      6. UTILITY PROGRAMS
  42.           A. Copying ZIP itself (ZIPDUP)
  43.           B. Changing defaults (ZIPSET)
  44.  
  45.      7. TECHNICAL INFORMATION
  46.           A. General information
  47.           B. About serial cables
  48.           C. Compatibility with other software
  49.           D. HP95/100/200LX palmtops
  50.           E. Error messages
  51.           F. About ZIP and its author
  52.  
  53.  
  54.  
  55.  ============================= 1. INTRODUCTION ===============================
  56.  
  57.  
  58.      Anyone working with two computers probably needs to transfer files 
  59.  between them regularly.  But especially when large amounts of data are 
  60.  involved, exchanging floppy disks quickly grows tedious; and not all 
  61.  computers have the same disk sizes, or disk drives at all.  Keeping track of 
  62.  new or modified files on each computer gets to be a problem, too.
  63.  
  64.      ZIP is a tiny, fast utility to transfer files between two PC compatible 
  65.  computers, using a common "null modem" serial cable.  It can be used from the 
  66.  DOS command line or a batch file, or run from an interactive menu.  It 
  67.  transfers files as simply as using the COPY command, and has options that 
  68.  make it easy to back up or reconcile directories on both computers.  Ideal 
  69.  for laptop or palmtop computers, even long outdated PCs, it requires very 
  70.  little disk space and memory.
  71.  
  72.      There are good retail programs for this purpose, and most even come with 
  73.  a cable.  But if you already have or can find your own cable, ZIP offers a 
  74.  simpler and cheaper alternative.  ZIP doesn't include as many features as 
  75.  these more elaborate programs; but you don't have to remember to load or 
  76.  install it, and it doesn't consume precious system memory when not actually 
  77.  in use.  In fact, even if you already have another more complex program, you 
  78.  may still find ZIP easier to use in many situations because of its small size 
  79.  and simplicity.
  80.  
  81.      ZIP transfers files many times faster than the binary upload/download 
  82.  protocols (like XMODEM) of ordinary telecommunications software, usually 
  83.  limited to 19200 bps.  ZIP can even work significantly faster than many 
  84.  similar shareware utilities that also operate "at 115200 bps", the maximum 
  85.  speed of the PC serial port.  ZIP's actual throughput depends on your 
  86.  computer, typically running about 8 to 10 kilobytes/second between 8086 PCs, 
  87.  or 16 to 24 k/sec on 80486s; results will vary according to your system 
  88.  configuration and (to some extent) the location or type of files involved.
  89.  
  90.      ZIP is designed to operate at very high transmission speeds with a direct 
  91.  cable connection, but it can also be used at slower speeds in applications 
  92.  that demand this.  Even use with modems over a phone connection established 
  93.  by telecommunications software is conceivable (ZIP might be useful as an 
  94.  "external protocol" due to its backup features, like options /N,E,T,A,S).
  95.  
  96.  (Note: ZIP is a serial communications program, and has no connection with the 
  97.  more recent file archive utility "PKzip", formerly "PKARC", by Phil Katz.)
  98.  
  99.  
  100.                          HOW YOU GOT YOUR COPY OF ZIP
  101.  
  102.      ZIP circulates widely as "shareware", giving you the opportunity to try 
  103.  the program at no cost, and to share it with others -- hence the name.  If it 
  104.  doesn't meet your needs, you don't have to pay for it.  If you find the 
  105.  program valuable and continue to use it, you can "register" your copy for a 
  106.  modest fee.  In return, you get an update disk and support from the author.
  107.  
  108.      Shareware offers some unique advantages over retail software, because 
  109.  users interact directly with the author.  Obviously, costs are kept down 
  110.  because glossy packaging, advertising, and retail markups are eliminated.  
  111.  But shareware can also resist market trends and continue to provide useful 
  112.  kinds of products that the big corporations have abandoned.  And shareware 
  113.  authors can respond more directly to user requests and concerns than software 
  114.  publishers who release an update only when it seems profitable.
  115.  
  116.      Shareware works when users give program authors useful feedback, and most 
  117.  of all, when users support authors by registering their programs.  This makes 
  118.  it possible for quality shareware to continue to develop and improve.  Please 
  119.  support shareware by registering any programs that you use.
  120.  
  121.      The use and distribution of ZIP are governed by the "COPYRIGHT AND 
  122.  LICENSE" information below.  Please read this carefully!
  123.  
  124.  
  125.                             FILES YOU SHOULD HAVE
  126.  
  127.      Be sure you have all the files which should be included in this package:
  128.  
  129.             ZIP.DOC      - This documentation file.
  130.             ZIPxx.UPD    - Update notes and version history.
  131.             ZIP.COM      - The file transfer program.
  132.             ZIPSET.COM   - The default option setting utility.
  133.             ZIPDUP.COM   - The initial duplication utility.
  134.             ZIP.ICN      - An icon for the HP100/200LX Application Manager.
  135.             ORDER.FRM    - Registration/site license order form.
  136.             FILE_ID.DIZ  - Standardized description for BBS operators.
  137.  
  138.  
  139.                       COPYRIGHT AND LICENSE INFORMATION
  140.  
  141.          The ZIP program and documentation are copyright (c)1988-98 
  142.          Eric Meyer, all rights reserved worldwide.  They may not be 
  143.          circulated in any incomplete or modified form, nor sold for 
  144.          profit, without written permission of the author.  The use 
  145.          or sale of ZIP is subject to the following terms:
  146.  
  147.  
  148.  PERSONAL USE.  If you find ZIP valuable and continue to use it, you are 
  149.     encouraged (but not required) to register, and help support the 
  150.     development of high-quality, affordable software:
  151.                    INDIVIDUAL REGISTRATION .....  $30 (US)
  152.     Registered users receive several benefits:
  153.             * The latest version of ZIP (and other useful programs) 
  154.          on disk direct from the author.
  155.             * A registration certificate verifying the legality of 
  156.          your personal use of ZIP at your workplace as well.
  157.             * Technical support if you encounter problems using ZIP.
  158.  
  159.  
  160.  SITE LICENSES.  Any company or institution wishing to use ZIP in the course 
  161.     of its business MUST purchase a SITE LICENSE.  The cost of the license is 
  162.     modest, and varies according to the number of computers on which ZIP may 
  163.     be in use in the workplace:
  164.                 Up to 10 copies................. $50 (US)
  165.                 Up to 20 copies................ $100
  166.                 Additional copies over 20........ $2 each
  167.     The purchaser of a site license receives, in addition to the disk, 
  168.     spelling checker, and technical support described above, a license 
  169.     certificate documenting the legality of your company's use of ZIP.  
  170.     Furthermore, employees can use ZIP at home and share it with others 
  171.     without raising issues of software piracy.
  172.  
  173.  
  174.  ORDERING INFORMATION.  License, registration, and update orders may be mailed 
  175.     directly to the author, with a CHECK or MONEY ORDER; PURCHASE ORDERS are 
  176.     also accepted.  Please use the order form provided (ORDER.FRM).
  177.          All CREDIT CARD orders (VISA/MC/AmEx/Discover, US or international) 
  178.     must be made through the Public Software Library, P.O. Box 35705, Houston 
  179.     TX 77235; mention item #10304.  There is a $5 surcharge from PSL.  PSL's 
  180.     toll-free line FOR ORDERS ONLY is (800)242-4775; all other calls, 
  181.     (713)524-6398; fax (713)524-6398.  Email orders to 10303@pslweb.com, 
  182.     inquiries to authors@pslweb.com.
  183.          Orders from overseas receive full support, including disks by 
  184.     airmail.  Payment can be made by credit card through PSL, or by bank check 
  185.     or money order in US currency, directly to the author; modest amounts of 
  186.     US cash ($50 or less) can also be sent safely by registered mail.
  187.  
  188.  
  189.  SHAREWARE SOURCES.  ZIP is distributed widely through "shareware" channels, 
  190.     usually as an archive file named ZIP###.ZIP (where ### is the version 
  191.     number).  It can be found through many BBS or online systems, and is 
  192.     available by mail from many software libraries, including PSL.
  193.          ZIP can be downloaded directly from either of the two primary 
  194.     distribution points: (1) On CompuServe, file ZIP.ZIP in library 4 (DL4) of 
  195.     the PCCOM forum.  (2) From an Internet list server: to see what's 
  196.     available, send the message "get files" to ftpmail@twty.chi.il.us ; to 
  197.     obtain a specific file, use its name, as in: "get ZIP21.ZIP".
  198.  
  199.  
  200.  COMMERCIAL SALE.  Any software dealer or library may offer ZIP for sale 
  201.     provided that the charge for the disk containing it does not exceed US $6 
  202.     (for CDROM, $30), and its shareware status is clearly noted.  Otherwise 
  203.     the sale of ZIP, either alone or together with other software or hardware, 
  204.     requires a licensing agreement.  Please write for terms.
  205.  
  206.  
  207.        For further information about ZIP, address correspondence to:
  208.  
  209.             Eric Meyer
  210.           3045 4th Street             Internet: 74415.1305@compuserve.com
  211.     Boulder, Colorado  80304  USA
  212.  
  213.  
  214.               THE CUSTOMARY DISCLAIMER:  You undertake to use ZIP at 
  215.          your own risk.  The author does not warrant the suitability 
  216.          of ZIP for any particular purpose, and assumes no liability 
  217.          for damages of any kind resulting from its use.
  218.  
  219.  
  220.  
  221.  ============================ 2. BASIC OPERATION =============================
  222.  
  223.  
  224.      In order to use ZIP, you need to have a copy of the same version of 
  225.  ZIP.COM on both computers, and a "null modem" cable (or equivalent) connected 
  226.  between their serial ports.  If incompatible disk drives prevent you from 
  227.  getting ZIP.COM itself onto the second computer to begin with, you can use 
  228.  the ZIPDUP utility (see COPYING ZIP ITSELF).  If your cable is improperly 
  229.  wired or is not connected to the port you have set ZIP to use, the message 
  230.  "Ready" or "Waiting" will appear and nothing further will happen; correct the 
  231.  problem and try again.  For more about serial ports and cables, see TECHNICAL 
  232.  INFORMATION.
  233.  
  234.      ZIP offers a choice of two user interfaces: MENU-DRIVEN is the simplest 
  235.  method for manual use, and the first described below.  Alternatively, each 
  236.  individual operation can be performed as a single DOS command, an approach 
  237.  often used in batch files; this is described under COMMAND-LINE OPERATION.
  238.  
  239.      There are also two modes for exchanging files: CLIENT/SERVER MODE is 
  240.  often the simplest to use manually, since all commands are issued on a single 
  241.  keyboard (the "client") while the other ("server") just responds 
  242.  automatically to them.  Alternatively, you can use a more symmetrical 
  243.  approach, issuing complementary Send and Receive commands on each computer.
  244.  
  245.  
  246.  --------------------------- A. TRANSFERRING FILES ---------------------------
  247.  
  248.  
  249.      Sending files between computers with ZIP is not much harder than 
  250.  copying them from one disk to another.  Suppose you have a file REPORTS in 
  251.  directory C:\WORK on your laptop computer, and you'd like to send it to 
  252.  directory D:\JONES on your desktop PC.  The cable is connected between the 
  253.  laptop's COM1 port and the desktop's COM2.  (If your setup differs, make the 
  254.  appropriate changes in the procedure described.)  The easiest way to start 
  255.  off using ZIP would be the following: type "ZIP" on each computer, bringing 
  256.  up the command menu:
  257.  
  258.           Port=COM1     Speed=115200 bps
  259.  
  260.           Send      Fetch   Directory   dElete   serVer   Options
  261.           Receive   Log     Compare     Time     Unlink   Quit   :
  262.  
  263.  Each command is selected by pressing the highlighted (usually first) letter.  
  264.  The first thing to note (in this example) is that we need to set ZIP to port 
  265.  COM2 on the desktop, since it defaults to COM1.  Eventually you would want to 
  266.  change the default permanently with ZIPCFG, but for now just use the Options 
  267.  command.  On the desktop, press "O" to bring up the Options menu:
  268.  
  269.           OPTIONS:
  270.             Port:  COM1          Bps:  115200
  271.             Create dirs:  NO     Exit time:  ---
  272.             Hidden files: NO     overwrite Read/only: NO
  273.             System files: NO     copy Archive bit: YES
  274.                                  Mark as archived: YES
  275.  
  276.  Press "P" to change the Port, then "2" for COM2.  Now you're ready to try 
  277.  transferring the file.  On the desktop, you can select either "R"eceive or 
  278.  ser"V"er; the first makes sense if this is all you want to do, the second if 
  279.  you have more files to exchange afterward.  If you use "R"eceive, you will be 
  280.  prompted for the directory to receive into, which was going to be D:\JONES, 
  281.  and "options", which you can leave blank.  If you enter no directory, the 
  282.  current one is the default.  If you use ser"V"er, ZIP will ask for the 
  283.  destination directory on the sending end instead, after the filename.
  284.       Now on the laptop, select "S"end, and give the filename, which was 
  285.  C:\WORK\REPORTS in this example, and once again leave "options" blank.  The 
  286.  file will be sent.  You can return to DOS on each computer by selecting 
  287.  "Q"uit (after pressing [Esc] to exit from server mode, if necessary).
  288.      If you can get such a transfer to work, you can go on to explore other 
  289.  features of ZIP; if not, recheck your cable, port settings, etc.
  290.  
  291.      Another very useful transfer command is Fetch: this allows you to receive 
  292.  files from the server as well, without having to switch to sending from the 
  293.  other keyboard.  In the above example, if you leave the desktop PC in server 
  294.  mode, you can get a file from it to the laptop by selecting "F"etch on the 
  295.  laptop, giving the filename on the desktop PC (any path included must be its 
  296.  location on the server, for example, D:\JONES\MEMO), and once again the 
  297.  directory to put it in (perhaps C:\WORK again).  The transfer should proceed.
  298.      Server mode can even be terminated from the client end, with the "U"nlink 
  299.  command (or the equivalent command-line option /U).
  300.  
  301.      In general, you can reply to a prompt to "SEND or FETCH files:" with a 
  302.  single filename, or a filespec like "*.DOC", or a list of several filespecs 
  303.  separated by commas.  A path is required only if the files are not in the 
  304.  default directory.  If the filespec is "*.*", you can abbreviate it as "."; 
  305.  or, if you are using options, you can type just a slash and options, and *.* 
  306.  will be assumed.
  307.  
  308.      During file transfer, ZIP will show each filename in succession, 
  309.  including its full source or destination directory.  Files within any group 
  310.  are processed alphabetically; disposition of files remains visible until they 
  311.  scroll off the top of the screen.  The size of each file to be sent is shown 
  312.  in "k" (1k = 1024 bytes), and the transfer in progress is indicated by 
  313.  continuously updating the amount sent until the file is complete.
  314.      If necessary, ZIP can be interrupted by pressing [Esc] or Ctrl-Break 
  315.  during the initial connection attempt; at any user prompt; or during file 
  316.  transfer (on the receiving end, the current file will be completed first).
  317.      ZIP will send even empty (0k) files.  A received file bears the same 
  318.  filename, DOS timestamp, and file attributes as the file sent (except that 
  319.  whether the Archive attribute is copied is an option.)
  320.  
  321.      CAUTION!  Because backing up work in progress is one of the purposes for 
  322.  which ZIP is designed, files sent with ZIP can overwrite any of the same name 
  323.  that may exist on the other computer, without warning or confirmation.  
  324.  (Several options described below, including /N,/T,/P, can prevent overwriting 
  325.  in various circumstances.)  Be careful not to inadvertently destroy important 
  326.  files, especially files like CONFIG.SYS or COMMAND.COM which may differ in 
  327.  the root directory of each computer's hard disk.
  328.  
  329.  
  330.  ------------------------- B. DIRECTORY MANAGEMENT ---------------------------
  331.  
  332.  
  333.      The menu also offers several directory management commands: Directory, 
  334.  Compare, dElete, and Log allow you to list or delete files and change 
  335.  directories without exiting ZIP.COM.  These functions can also be applied to 
  336.  the other computer if it has ZIP running in server mode.  (They are available 
  337.  in command-line usage as the options /D,C,K,L.)
  338.      Whether or not ZIP can see DOS Hidden or System files, and whether it 
  339.  will delete Read/only files, are user-configurable options.
  340.  
  341.                                  Directory
  342.  
  343.      The "D"irectory command provides an alphabetized file listing for your 
  344.  reference, including total size and free disk space (if less than 64mb).  You 
  345.  will be prompted for the files to list.  If you just press [Enter], ZIP lists 
  346.  all files (*.*) in the default directory.  Subdirectory names, if any, will 
  347.  be preceded by a backslash "\".
  348.      The option "/A" is also allowed after the filespec, in which case only 
  349.  files with the Archive attribute are shown.  This can function as a preview 
  350.  of files that would be transferred with the /A option in effect.
  351.  
  352.                                    dElete
  353.  
  354.      The d"E"lete command prompts for a filespec to delete; as always, a path 
  355.  and/or wildcards may be included, though it accepts only a single filespec, 
  356.  not a list of them.  The default directory applies if none is given.
  357.      CAUTION: ZIP does not prompt for further confirmation before deleting 
  358.  specified file(s); be careful, especially when using wildcards.
  359.  
  360.                                     Log
  361.  
  362.      Although you can always type the full path information for any files you 
  363.  want to look for or transfer, if you're going to be working in a different 
  364.  directory for a while, it can be more convenient to change ZIP's default 
  365.  directory.  The "L"og command will let you do this; you will be prompted for 
  366.  the new drive and/or directory, or you can just press [Enter] to check the 
  367.  current directory.  Initially, of course, the default is the current DOS 
  368.  directory.  Depending on option settings, if the directory you specify does 
  369.  not exist, ZIP may create it.
  370.      (The Log command works much like the DOS commands CHDIR/MKDIR, except 
  371.  that ZIP does not actually change the current DOS directory, it simply keeps 
  372.  its own record of the directory you want to be working in.)
  373.  
  374.                               Server option ">"
  375.  
  376.      With any of these three commands, you can simply type a ">" before an 
  377.  argument to indicate that it applies to the server computer.  This can be 
  378.  done either alone, or following a request on the client end:
  379.               Directory: \WORK\*.BAK                client alone
  380.                  Delete: >B:\BACKUP\OLD.FIL         server alone
  381.                     Log: \WORK>B:\BACKUP            both
  382.  
  383.      As a convenience, since the two computers may have a similar directory 
  384.  structure, you can also type a quote mark (") to log the same default 
  385.  directory for the server.
  386.               Log: >"              log same dir on the server as client
  387.               Log: C:\WORK>"       log C:\WORK on both
  388.               Log: C:\WORK>D:"     log C:\WORK on client, D:\WORK on server
  389.  
  390.                                    Compare
  391.  
  392.      If your other computer is running ZIP in server mode, you can also 
  393.  compare the contents of directories, showing files that appear in one but not 
  394.  the other, or that exist in different versions.  Common identical files are 
  395.  not shown.  Note that only the files' DOS timestamps are compared, not their 
  396.  data.  (This can function as a preview of what files will be transferred if 
  397.  you use the /N or /T option.)
  398.      When you select "C"ompare, you will be prompted for the files to compare.  
  399.  If you just press [Enter], ZIP compares all files ("*.*") in the default 
  400.  directory on each end.  Besides a filespec, you can also use a ">" if you 
  401.  want to specify a different directory on the server:
  402.           Compare: >\BACKUP           client *.*   with server \BACKUP\*.*
  403.           Compare: *.DOC              client *.DOC with server *.DOC
  404.           Compare: *.DOC>\BACKUP      client *.DOC with server \BACKUP\*.DOC
  405.  
  406.      ZIP will produce two listings: first files on the client that don't match 
  407.  up with those on the server, and then vice versa.  If a file appears on both 
  408.  but in differing versions, it will be flagged with a "+" or "-" to indicate 
  409.  which appears to be the later (+) or earlier (-) version, according to the 
  410.  files' timestamps.  This is more efficient than simply displaying the full 
  411.  directory contents on both ends (though you can do that too, with Directory.)
  412.  
  413.  
  414.  
  415.  ==================== 3. SELECTIVE TRANSFER AND BACKUP =======================
  416.  
  417.                        A. SELECTING FILES FROM A GROUP
  418.  
  419.      If you want to transfer only certain files from a group (*.*, *.DOC) with 
  420.  ZIP, you can request that you be prompted to confirm each file individually: 
  421.  you will be asked to press a key (Y/N) to determine whether each file is to 
  422.  be sent.  After the file (or for receiving, directory) names, specify the 
  423.  option:
  424.               /P  = PROMPT to confirm files individually
  425.  
  426.  (In menu mode, if you haven't entered options with a slash "/" you may be 
  427.  prompted for them, and can just enter "P".)
  428.      As the transfer proceeds, in addition to "Y" or "N" for each file shown, 
  429.  you can also reply "*" to conclude the prompting process and accept all 
  430.  remaining files, or [Esc] to abort the operation.
  431.      If /P is in use on the receiving end and "N" is entered, the message 
  432.  "<Declined>" will appear on the sending end.  /P can be used independently on 
  433.  either or both ends, but has no effect in server mode.
  434.  
  435.  
  436.  --------------------- B. RECONCILING DIRECTORY CONTENTS ---------------------
  437.  
  438.  
  439.      ZIP offers a pair of options that are particulary useful for reconciling 
  440.  the contents of directories which need to be duplicated (in whole or part) on 
  441.  both computers.  By default, ZIP doesn't care what files may already exist on 
  442.  the receiving end: it will transfer all files specified, whether or not they 
  443.  overwrite existing ones.  These options are provided to modify this behavior.  
  444.  After the names of files to be transferred, specify one of these options:
  445.  
  446.               /N  = send NEW files only
  447.               /E  = send EXISTING files only
  448.  
  449.  (In menu mode, if you haven't entered options with a slash "/" you may be 
  450.  prompted for them, and can just enter "N" or "E".)
  451.      The /N option sends only new files, saving time by not bothering to 
  452.  transfer and overwrite files which already exist on the receiving end.
  453.      The /E option is seldom useful by itself, since it would send just those 
  454.  files which do already exist, but it can be combined with other options in 
  455.  various ways.  Together with the /T or /A option described below, it is ideal 
  456.  for incremental backup.  Together with /P, it can be used in situations where 
  457.  there may be just some existing files that you wouldn't want to overwrite.  
  458.  (Use /EP first, to make those choices, and then do the same transfer again 
  459.  with /N if desired to pick up the remaining files.)
  460.      These options can be specified only on the client or sending end.
  461.  
  462.  
  463.  --------------------------- C. INCREMENTAL BACKUP ---------------------------
  464.  
  465.  
  466.      ZIP offers two different methods of "incremental backup" -- transferring 
  467.  only those few files recently modified between directories whose contents are 
  468.  otherwise already identical.
  469.  
  470.               /T  = latest TIMESTAMP determines files sent
  471.               /A  = ARCHIVE attribute determines files sent
  472.  
  473.  (In menu mode, if you haven't entered options with a slash "/" you may be 
  474.  prompted for them, and can just enter "T" or "A".)  These options can be 
  475.  specified only on the client or sending end.
  476.      Of these, /T is probably the most straightforward and widely used for 
  477.  casual backup purposes.  The /T option allows overwriting existing files only 
  478.  when the copy to be sent has a more recent timestamp.  Thus, used alone, it 
  479.  will transfer both completely new files and newer versions of existing files, 
  480.  while not bothering with unchanged files.  /T can also be combined with /E, 
  481.  and this /ET combination is ideal for partial backup: it transfers only more 
  482.  recent versions of existing files, without sending files that don't already 
  483.  exist or that haven't changed.
  484.  
  485.      The other incremental backup alternative is /A, which is based on the 
  486.  Archive "attribute" maintained in each file's directory entry by DOS.  
  487.  Whenever a file is created or modified, this attribute is automatically set.  
  488.  (It can also be set or cleared manually by various utilities including the 
  489.  DOS command ATTRIB.)  The attribute is intended for use by backup software, 
  490.  including the XCOPY command (see its archive/mark options /A,M).  The backup 
  491.  program copies files that have this attribute, and clears it.  So at some 
  492.  later date, the files that once again have it set are those you have created 
  493.  or changed since, and need to back up now.
  494.      That is just what ZIP does when the /A option is used.  (At least by 
  495.  default; ZIPSET offers a choice of whether files sent are marked by clearing 
  496.  the attribute.)  Again, the /E option can be used along with /A in order to 
  497.  archive only a certain subset of those files, for example, to back up the 
  498.  contents of a large directory onto multiple diskettes.
  499.      Obviously, the first time you start using this backup procedure, every 
  500.  file you have is marked with the Archive attribute and will have to be 
  501.  copied, so the operation may take awhile.  If the directory contents are 
  502.  actually identical to begin with, you can save a lot of time by clearing the 
  503.  Archive attribute on all the files with a utility like ATTRIB.  (In fact, 
  504.  whether or not you rely on the automatic use of the Archive bit for backup 
  505.  purposes, you can always set or clear it on certain files in order to include 
  506.  or exclude them when transferring with /A.)
  507.      This method of archiving files generally makes more sense when used in a 
  508.  regular backup routine with a dedicated mass backup device, such as a tape 
  509.  drive or removable hard disk.
  510.  
  511.      CAUTIONS: the /T option relies on the DOS timestamps of files.  If your 
  512.  system clock is not well maintained (example: clocks without battery backup 
  513.  that may not be properly set when the system is started), use of /T is not 
  514.  recommended.
  515.      The /A option is independent of your system clock, but it does depend 
  516.  upon proper maintenance of the Archive attribute.  Be careful about using 
  517.  other programs, like XCOPY /M, which may also affect it; also, some software 
  518.  may not correctly preserve this attribute when manipulating files.
  519.      Finally, both of these backup methods assume that only one version of 
  520.  each file has been modified since they were last identical.  ZIP doesn't 
  521.  examine the actual contents of files, so if different changes have been made 
  522.  to both versions, ZIP can't reconcile them; it just overwrites one of them 
  523.  with the other.  If possible, you should avoid working on the same material 
  524.  on both computers in between backups; but if you can't and frequently do get 
  525.  into such situations, you may need more sophisticated backup software.
  526.  
  527.  
  528.  ---------------------- D. BACKING UP ALL SUBDIRECTORIES ---------------------
  529.  
  530.  
  531.      In many situations, you may want to set up or maintain a (fully or 
  532.  partially) matching set of subdirectories on two computers.  While you could 
  533.  use the above methods to accomplish this one subdirectory at a time, ZIP 
  534.  offers an option to do this automatically.  In either menu or command-line 
  535.  mode, after the transfer filespec, specify:
  536.  
  537.               /S  = process all SUBDIRECTORIES
  538.  
  539.  (In menu mode, if you haven't entered options with a slash "/" you may be 
  540.  prompted for them, and can just enter "S".)  This option can only be 
  541.  specified on the client or sending end.
  542.      Like the /S switch of the DOS XCOPY command, this causes the given 
  543.  command to be processed on files in a directory, and then also throughout all 
  544.  its subdirectories.  The source directory is first put in correspondence with 
  545.  the destination directory, and thereafter ZIP will either seek or create 
  546.  subdirectories of the destination directory to match those of the source.  
  547.  Suppose the two computers have the following directory trees:
  548.         Sender:  C:\                 Receiver:  D:\
  549.                     \WORK                          \BACKUP
  550.                          \PROG                            ...
  551.                          \ACCT                     \OTHER
  552.                     \GAMES                                ...
  553.  
  554.  The command "ZIP C:\WORK\*.* /S[D:\BACKUP]" will begin by transferring files 
  555.  from C:\WORK to D:\BACKUP, then C:\WORK\PROG to D:\BACKUP\PROG, and so on.
  556.      If any target directory (like D:\BACKUP\PROG) does not already exist, the 
  557.  Options menu choices "create dirs: Yes, Just" (or the corresponding /I,J 
  558.  options), which can also be selected by default with ZIPSET, will cause it to 
  559.  be created; otherwise, the operation will simply terminate with an error 
  560.  message.
  561.  
  562.      The /S option can be combined with any of ZIP's other file transfer 
  563.  options.  It is most commonly used for backup purposes either together with 
  564.  /I or /J, when you are trying to establish a corresponding directory 
  565.  structure in the first place, and want the required directories to be 
  566.  created; or after that, with /T or /A, to back up files within those 
  567.  directories according to their timestamps.
  568.  
  569.      CAUTIONS: with /S, complete specification of drive and path for both 
  570.  source and destination directory is highly recommended to avoid unanticipated 
  571.  results (such as creation of unintended subdirectories).
  572.      Always be careful when sending files to the root directory of a hard 
  573.  disk; critical DOS files such as AUTOEXEC.BAT, CONFIG.SYS, COMMAND.COM might 
  574.  get overwritten.  An excellent way to avoid this danger when backing up an 
  575.  entire drive is to use /P together with /S.  You can control each file sent 
  576.  to the root directory individually, and when that's done, press "*" to 
  577.  continue through all the subdirectories without further prompting.
  578.  
  579.  
  580.  
  581.  ========================= 4. ADDITIONAL FEATURES ============================
  582.  
  583.                        A. SETTING SERIAL PORT AND SPEED
  584.  
  585.      PC-compatible computers may have anywhere from one to four serial ports, 
  586.  denoted as COM1 through COM4, and on each computer ZIP must know which port 
  587.  to use.  Most people connect their cable to the same port every time, so this 
  588.  is normally something to set once and then forget about.  By default ZIP uses 
  589.  COM1; if you will be using another port, you can simply use ZIPSET to change 
  590.  the default.  But until you have done that, or in the event that you want to 
  591.  try another port temporarily: in menu mode, choose "O"ptions, then select a 
  592.  port.  (On the command line, specify option /1-4.)
  593.      If in doubt as to which designation corresponds to each socket on your 
  594.  computer, consult your manual; see also the description of ports and cables 
  595.  under TECHNICAL INFORMATION.
  596.  
  597.      Most users will never need to change the transmission speed (baud rate).  
  598.  ZIP normally works at the fastest speed a PC serial port allows, 115200 bps 
  599.  (bits/sec); use of slower speeds is not recommended, unless you find it to be 
  600.  necessary to accommodate certain computers or software environments.  In any 
  601.  event, the same speed must be set on both ends.  In menu mode, choose 
  602.  "O"ptions, then select a speed.  (On the command line, use the /B option.)  
  603.  The default speed can also be changed with ZIPSET, if desired.
  604.  
  605.      You will see a note in the ZIP signon message, "Port=____ Speed=____", 
  606.  giving the port address and speed currently in use.  (The port will display 
  607.  as COM1-4 if it is a standard address, in hexadecimal otherwise.)
  608.  
  609.  
  610.  ----------------------- B. WAITING FOR A CONNECTION -------------------------
  611.  
  612.  
  613.      Normally, once a process is initiated (file transfer, directory request, 
  614.  etc) ZIP will wait indefinitely until a connection with another copy of ZIP 
  615.  is established on the selected port.  As soon as the corresponding process is 
  616.  initiated on the other end, the operation will proceed.
  617.      However, in some circumstances this behavior may not be desirable: for 
  618.  example, a batch file containing ZIP commands would stall if ZIP was not 
  619.  found running on the other end in server or receive mode.  So an option is 
  620.  provided to have ZIP give up and exit (returning a Connect Error, which you 
  621.  can test for) if a connection is not promptly established.
  622.      In menu mode, select "O"ptions, then "E"xit time, and select an interval, 
  623.  0-9 minutes or None.  (On the command line, use the /X option.)  Typically an 
  624.  exit time of 0 would be used when issuing commands when you already know ZIP 
  625.  should be running in server mode on the other end.  Note that server mode 
  626.  will also terminate automatically if it had an exit time specified, and no 
  627.  commands have been received.
  628.  
  629.  
  630.  ---------------------- C. FILE AND DIRECTORY HANDLING -----------------------
  631.  
  632.  
  633.      ZIP allows you to specify how you want it to handle DOS file attributes.  
  634.  (If you don't know what any of this means, you can either crack open your DOS 
  635.  manual or decide not to worry about it.)  By default, ZIP does not list or 
  636.  transfer Hidden or System files; an error occurs if you attempt to overwrite 
  637.  or delete a Read/only file; all DOS attributes, including Archive, are copied 
  638.  as they were on each source file; but the /A option marks source files as 
  639.  archived by removing that attribute.
  640.      You can also choose whether you want ZIP to create new directories on the 
  641.  receiving end; by default, ZIP simply reports an error if the required 
  642.  directory does not already exist.
  643.  
  644.      These settings may be specified independently on either end; the settings 
  645.  on the client or sending end govern each operation.  To examine or alter 
  646.  them, in menu mode, choose "O"ptions.  For file attributes, there are five 
  647.  settings:
  648.         include Hidden files?     overwrite Read/only files?
  649.         include System files?     copy Archive bit?
  650.                                   Mark as archived?  (when /A in use)
  651.  
  652.  Press a letter "H,S,R,A,M" to change any of these from YES to NO.  For 
  653.  directory creation, there are three alternatives:
  654.                "Y"es - whenever corresponding directory doesn't exist
  655.     "J"ust if needed - only when required for an operation to succeed
  656.                 "N"o - don't create directories (report error if nonexistent)
  657.  
  658.  The "Y,J" settings both affect requests to log or send files to a directory 
  659.  that doesn't already exist; in addition, "Y" will create corresponding 
  660.  directories during a subdirectory (/S) transfer operation even when there are 
  661.  no files to be sent to them.  This suits it to situations where you initially 
  662.  need to establish an identical directory structure.
  663.  
  664.      ZIPSET can be used to select the defaults of your choice for all these 
  665.  options.  (On the command line, the /I,J options are used for directory 
  666.  creation.)
  667.  
  668.  
  669.  -------------------------- D. SCREEN OUTPUT MODES ---------------------------
  670.  
  671.  
  672.      ZIP is capable of displaying in several colors or shades on computers 
  673.  with color or greyscale capability via the PC BIOS (colors are chosen with 
  674.  ZIPSET).  However, you can instead select simple DOS (monochrome) output mode 
  675.  if you prefer.  This may be desirable on displays that are hard to read or 
  676.  cannot display different colors or video attributes effectively; it is also 
  677.  necessary if you wish to redirect screen output (see AUTOMATING).  Color 
  678.  output is the normal default, but you can make monochrome your default with 
  679.  ZIPSET.  (The command-line option /M will always reverse the chosen default.)
  680.  
  681.  
  682.  ------------------------- E. CLOCK SYNCHRONIZATION --------------------------
  683.  
  684.  
  685.      It is advisable to ensure that the system clocks on your computers agree 
  686.  closely with each other; if they differ significantly, the timestamps on 
  687.  files may not accurately indicate which computer has the later revisions.  
  688.  Therefore, the first time you perform an operation which involves file 
  689.  timestamps -- a directory Compare (/C), or a file transfer by timestamp (/T) 
  690.  -- ZIP compares the two system clocks.  If they differ by more than a certain 
  691.  amount, the "clock synch tolerance", a warning is given.  (The synch 
  692.  tolerance, 5 minutes by default, can be changed or disabled with ZIPSET.)  If 
  693.  a file transfer is beginning and you think the results might be undesirable, 
  694.  you can abort the operation by pressing [Esc] and investigate further.
  695.  
  696.      To bring the two clocks into agreement, instead of having to quit ZIP and 
  697.  use the DOS commands TIME (and/or DATE) on each computer, you can synchronize 
  698.  the clocks automatically using ZIP itself.  With your other computer running 
  699.  ZIP in server mode, just select "T"ime from the ZIP menu.  The current system 
  700.  time (and date) will be displayed, and you will be prompted in a manner much 
  701.  like the DOS command TIME:
  702.  
  703.               To synchronize, enter new time or press [Enter]:
  704.  
  705.  [Enter] alone uses the client's current time.  You can also press [Esc] (as 
  706.  always) to quit.  Time can be entered in either 12 or 24-hour format, as 
  707.  desired: "1:47pm" is equivalent to "13:47".
  708.  
  709.      Performing this function periodically is an easy way to ensure that your 
  710.  computer clocks remain in agreement.  (On the command line, you can use the 
  711.  /Y option, which doesn't prompt for a time, just using the current one.)
  712.      (Notes: it's OK to wait a bit before pressing [Enter] alone, since the 
  713.  time is read once again when you do that.  This function resets the date as 
  714.  well as the time on the server to match that of the client computer, but it 
  715.  does not accept date corrections; use the DOS DATE command for that.)
  716.  
  717.  
  718.  
  719.  ============================= 5. EXPERT USAGE ===============================
  720.  
  721.                            A. COMMAND-LINE OPERATION
  722.  
  723.      Sending files between computers with ZIP is as easy as copying them from 
  724.  one disk to another.  As mentioned above, any individual ZIP operation can be 
  725.  performed from the DOS command line with certain arguments and/or options, 
  726.  without entering menu mode.  The usual application for this is batch files 
  727.  (see AUTOMATING, below) but there are also times when manual use of command- 
  728.  line syntax is convenient.  For example, you could do a quick little file 
  729.  transfer simply by typing something like:
  730.           Laptop:  ZIP REPORTS              Desktop:  ZIP /R
  731.  
  732.      The menu commands for the following operations have already been 
  733.  described; here are the command-line equivalents:
  734.  
  735.      Send     > ZIP fspec /[dir]          Directory  > ZIP /D[fspec]
  736.      Fetch    > ZIP fspec /F[dir]         dElete     > ZIP /K[fspec]
  737.      Receive  > ZIP /R[dir]               Log        > ZIP /L[dir]
  738.      serVer   > ZIP /V[dir]               Compare    > ZIP fspec /C[dir]
  739.      Unlink   > ZIP /U                    Time       > ZIP /Y
  740.  
  741.      The option letters mostly agree with the menu letters, except /K (Kill) 
  742.  and /Y (sYnch).  (Send has no option letter; it is the default operation.)
  743.      The transfer operations will also accept an optional directory name in 
  744.  square brackets "[dir]" to specify a destination, as will /C for a server 
  745.  directory to compare to.  (For /V, this is a default directory, overridden by 
  746.  any specified by the client.)
  747.      Directory, delete and log commands require their argument in square 
  748.  brackets along with the option letter, and they operate on the server only.  
  749.  (Other utilities like DIR, DEL, or CHDIR may be used to perform these 
  750.  operations on the client.)
  751.      /U can be used by itself or combined with another operation, in which 
  752.  case it releases the server after that operation is complete.
  753.      The transfer "fspec" can be a single FILE (including path), or a GROUP 
  754.  specified by wildcards (eg, *.BAK), or an "@FILE" (see AUTOMATING), or a LIST 
  755.  of any of these delimited by commas or spaces.  In such a list, each item 
  756.  assumes or continues the same path as the previous one, unless the new one 
  757.  begins with a drive or root directory.  Thus the list:
  758.               d:\sf\gort, rvws\*.892, klaatu, \foo
  759.  refers to files D:\SF\GORT, D:\SF\RVWS\*.892, D:\SF\RVWS\KLAATU, D:\FOO.
  760.  
  761.      The Option menu selections for the following settings have already been 
  762.  described; here are the command-line equivalents:
  763.  
  764.           /1-4   = use port COM1-4
  765.           /Bnn   = use speed "nn" BPS (nn=115200, 57600, 38400, 19200, 9600,
  766.                      4800, or 2400; can be abbreviated to as few as 2 digits)
  767.           /Xn    = EXIT time, "n" minutes (n=0-9)
  768.           /I     = create IDENTICAL directories
  769.           /J     = create directories JUST as needed
  770.  
  771.  (These configuration options can be used even when you invoke ZIP in menu 
  772.  mode, as an alternative to using the "O"ptions command.)  It is the sender or 
  773.  client's /I,J options that determine whether directories will be created.
  774.  
  775.      The file selection options /E,N,P,T,A and the subdirectory option /S are 
  776.  used after the filename on the command line just as they can be in menu mode.  
  777.  Of them, only /P may be used when receiving.
  778.  
  779.      For a brief help message explaining command-line syntax and options, you 
  780.  can type "ZIP /?".     Here are some usage examples:
  781.  
  782.     SENDING FILES:
  783.  
  784.  C> zip b:myfile *.doc             send files B:MYFILE, B:*.DOC
  785.  
  786.  C> zip *.bak /[b:\recs]           send files *.BAK to directory B:\RECS
  787.  
  788.  C> zip my.* /2 /p                 send files C:MY.* over COM2, with prompts
  789.                                  to confirm each file individually
  790.  
  791.  C> zip *.* /n                     send all files which don't already exist
  792.                                  in receiver's default directory
  793.  
  794.  C> zip a:chapter.* /et            send all files A:CHAPTER.* of which an
  795.                                  older version exists on the receiving end
  796.     RECEIVING FILES:
  797.  
  798.  C> zip /r3                        receive files over COM3
  799.  
  800.  C> zip /rp[\temp]                 receive, with default directory C:\TEMP,
  801.                                  prompting to confirm each file individually
  802.     SUBDIRECTORIES:
  803.  
  804.  C> zip \work\*.* /si[f:\work]     duplicate the entire subdirectory tree from
  805.                                  C:\WORK on down, to receiver's drive F:
  806.  
  807.  C> zip \*.* /st[d:\cbkup]         back up all new or modified files on drive
  808.                                  C: (based on "t"imestamp) to corresponding
  809.                                  directory tree D:\CBKUP...
  810.     ENTERING SERVER MODE:
  811.  
  812.  C> zip /v /2b38 /x3               server mode, at 38400 bps on COM2 (but quit
  813.                                  with error after 3 minutes if no connection)
  814.  
  815.  C> zip /v[d:\temp]                server mode,with default directory D:\TEMP
  816.  
  817.     EXCHANGING FILES WITH SERVER:
  818.  
  819.  C> zip b:\recs\my.* /f[\orig]     fetch files MY.* from server directory
  820.                                  B:\RECS into client directory C:\ORIG
  821.  
  822.  C> zip my.fil,my.bak /u           send MY.FIL and MY.BAK to server's default
  823.                                  directory, then unlink server
  824.  
  825.     OTHER OPERATIONS WITH SERVER:
  826.  
  827.  C> zip /ad[\work\*.bak]           show all server's files \WORK\*.BAK with
  828.                                  the Archive attribute
  829.  
  830.  C> zip /k[junk]                   delete server's file JUNK
  831.  
  832.  C> zip *.txt /c[\mydir]           compare *.TXT with server's \MYDIR\*.TXT
  833.  
  834.  C> zip /lj[c:\recs]               log server directory C:\RECS, creating it
  835.                                  if it doesn't already exist
  836.  
  837.  
  838.  -------------------------- B. SUMMARY OF OPTIONS ----------------------------
  839.  
  840.  
  841.      The following options may be used in either menu or command-line mode:
  842.               /E,N       Existing, New files only
  843.               /T         more recent Timestamp only
  844.               /A         Archive marked files only
  845.               /P         Prompt to confirm each
  846.               /S         process Subdirectories
  847.      These command-line options are replaced by menu choices in menu mode:
  848.              (none)      "Send" files
  849.               /R         "Receive" files
  850.               /F         "Fetch" from server
  851.               /V         "serVer" mode
  852.               /D[fspec]  "Directory" from server
  853.               /L[dir]    "Log" dir on server
  854.               /K[fspec]  "dElete" files on server (Kill)
  855.               /C[dir]    "Compare" with server dir
  856.               /Y         "Time" synchronization with server
  857.               /U         "Unlink" server
  858.               /1-4       port COM1-COM4          \
  859.               /Bnn       speed 2400-115200 Bps    \
  860.               /Xn        eXit time 0-9 min         > "Options"
  861.               /I         create Identical dirs    /
  862.               /J         create Just when needed /
  863.      These options are available only on the command line:
  864.               /M         Monochrome (DOS) output
  865.               /?         program information and brief instructions
  866.      These options are available only in menu mode or via ZIPSET:
  867.                          "Options": include Hidden, System files
  868.                                     overwrite Read/only files
  869.                                     copy Archive bit, Mark as archived
  870.      These options are available only via ZIPSET:
  871.                           Clock synch tolerance
  872.                           Display colors
  873.  
  874.  
  875.  ------------------------ C. AUTOMATING USE OF ZIP ---------------------------
  876.  
  877.  
  878.      There are several ways of performing complex repetitive tasks, like 
  879.  backing up specific groups of files, more easily with ZIP, by taking 
  880.  advantage of its own features (indirect filename lists in "@files") or those 
  881.  provided by DOS (batch files, input/output redirection).
  882.  
  883.                               Redirected Output
  884.  
  885.      Standard DOS command line output redirection (">") can be used with ZIP.  
  886.  Thus, for example, "ZIP /D[*.BAK] >ZOUTPUT" can be used to capture the output 
  887.  of a ZIP directory listing in a file ZOUTPUT, to be examined or processed 
  888.  later.  (As a side effect, nothing displays on the screen; thus you can also 
  889.  use ">NUL" to simply suppress output, if desired.)
  890.      Note that for output redirection to work, ZIP must be using ordinary DOS 
  891.  output, not color output; this can be selected with the ZIPSET utility, or 
  892.  changed with the /M option.
  893.  
  894.                                Redirected Input
  895.  
  896.      Because ZIP accepts standard DOS input redirection ("<"), you can 
  897.  automate a frequently performed series of tasks (sending groups of files to 
  898.  different directories, etc) by running ZIP in menu mode with redirected 
  899.  input.  (Batch files are usually a better method, however.)
  900.      Redirected input is a sort of "script" describing a complex task.  You 
  901.  will need to create a text file containing exactly the keystrokes you would 
  902.  use to perform a task; think about the way ZIP prompts for input, and work 
  903.  out your responses carefully.  (Note, for example, that when you select an 
  904.  option like "S"end you don't press [Enter] afterward, but when you provide a 
  905.  filename you do.)  If you use the /P option while running ZIP with redirected 
  906.  input, you will still have to type any "Y/N" responses from the keyboard 
  907.  yourself.  You must always end the file with "Q" to quit; DOS does not return 
  908.  to the keyboard for further input if the end of the input file is reached 
  909.  while the program is still running, so your system would just lock up.
  910.  
  911.                          Indirect File Lists (@files)
  912.  
  913.      A number of file management and communications utilities can write a list 
  914.  of filenames selected according to various criteria to a file, or accept the 
  915.  name of such a file following an "@" sign to process all the filenames it 
  916.  contains; ZIP also honors this convention.  You can also create such a file 
  917.  yourself, with any text editor, inserting the names of files which you may 
  918.  often want to transfer as a group.  Such an "@file" should contain complete 
  919.  filespecs (with drive and path), separated by spaces and/or carriage returns, 
  920.  for example:        c:\work\*.bak
  921.                      c:\myfile  (...)
  922.  If this was a file called FLIST, then "ZIP @FLIST" would send those files.
  923.      Note that an @file is equivalent to a comma-delimited list of filespecs, 
  924.  so all will be sent to the same destination directory.  Options can only be 
  925.  specified on the command line after the @file name (not within the @file), 
  926.  and will affect all files transferred.
  927.  
  928.                                  Batch Files
  929.  
  930.      Since each individual function can be performed from the DOS command 
  931.  line, ZIP is easy to use in batch (.BAT) files.  Batch files are a convenient 
  932.  way to automate frequently repeated tasks, since they can contain replaceable 
  933.  arguments, tests for the existence of files or directories, prompts and jumps 
  934.  for the user to choose different courses of action, and other powerful 
  935.  features.  (See your DOS manual for details of batch file programming.)  The 
  936.  simplest approach is to put one computer in server mode and execute a series 
  937.  of ZIP commands from the other, then unlink.
  938.      Use of the /X option is recommended in batch files, so that an alternate 
  939.  course of action can be taken if a connection cannot be promptly established.
  940.  
  941.      If an error occurs during operation in command-line mode, ZIP sets the 
  942.  DOS error code, so that a batch file can test the ERRORLEVEL to determine 
  943.  subsequent action.  Normally 0, the value returned will indicate which of the 
  944.  following errors occurred:
  945.      1 = argument error                   8 = transmission error
  946.      2 = out of memory/too many files    16 = disk read/write error (full?)
  947.      4 = connect error/no server        128 = user abort
  948.  It is always advisable to test for errors and abort execution of a batch file 
  949.  if an operation (upon which later actions may rely) has failed.  For example, 
  950.  the following batch file fetches certain files from a server, deletes the 
  951.  originals on the server ONLY IF the transfer was successful, then unlinks:
  952.               ZIP \SOURCE\*.* /F [\DEST]
  953.               IF ERRORLEVEL 1 GOTO BADXFR
  954.               ZIP /K [\SOURCE\*.*]
  955.               :BADXFR
  956.               ZIP /U
  957.  (Note that in DOS batch language, the test "IF ERRORLEVEL #" is true if the 
  958.  value is greater than OR equal to "#", so "IF ERRORLEVEL 1" catches any error 
  959.  at all.)
  960.  
  961.  
  962.  
  963.  =========================== 6. UTILITY PROGRAMS =============================
  964.  
  965.                             A. COPYING ZIP ITSELF
  966.  
  967.      ZIPDUP 1.02 is a simple utility that allows you to duplicate ZIP.COM on 
  968.  another computer initially, when your two computers don't share a common disk 
  969.  format.  Because this procedure is quite different from ZIP's usual mode of 
  970.  operation and will be used only rarely, it's not built into ZIP itself.
  971.  
  972.      1.  Connect the cable to serial port COM1 or COM2 (only) on each 
  973.  computer.  Your cable must have all seven lines shown in the diagram under 
  974.  TECHNICAL INFORMATION wired properly for ZIPDUP to work.
  975.  
  976.      2.  On the receiving end:  Make sure the DOS utilities DEBUG and MODE are 
  977.  available (either in the current directory or on your PATH).  Then prepare to 
  978.  receive by typing these two commands:
  979.                      MODE COM#:96,N,8,1,P     ("#" = 1 or 2)
  980.                      CTTY COM#
  981.  (Note: under DOS 4 or earlier, the ",P" may not be necessary in the MODE 
  982.  command.)  The CTTY command gives control to the sending computer, via the 
  983.  serial port.  The receiving system will seem to "lock up", showing nothing on 
  984.  screen and ignoring any keyboard input.
  985.      CAUTION: if the ZIPDUP transfer fails now, you will need to reboot!  
  986.  There is no other way to regain keyboard control from CTTY.
  987.  
  988.      3.  Now, on the sending end, be sure that ZIP.COM (which will be sent) is 
  989.  in the current directory along with ZIPDUP, and just type:
  990.                      ZIPDUP
  991.  You will be asked to specify the COM port (1 or 2) that the cable is 
  992.  connected to; if the connection can be made, the transfer will proceed.  When 
  993.  ZIPDUP is finished, you will find a duplicate copy of ZIP.COM in the current 
  994.  directory on the receiving computer.
  995.  
  996.      (Note: another possible way to get ZIP.COM transferred initially would be 
  997.  with the file upload/download capability of any telecom software you may have 
  998.  (it doesn't have to be the same program on both computers).  Choose the 
  999.  correct ports, set compatible parameters on both ends (recommended: 19200 
  1000.  bps, 8 bits, No parity, 1 stop bit, XMODEM protocol), and use the upload 
  1001.  command on the sending end and download on the other to transfer ZIP.COM.)
  1002.  
  1003.  
  1004.  --------------------------- B. CHANGING DEFAULTS ----------------------------
  1005.  
  1006.  
  1007.      The ZIPSET utility allows you to customize ZIP to your own requirements.  
  1008.  Certain "defaults" that are assumed unless you specify otherwise (via menu 
  1009.  choices or command-line options) can be changed: transfer speed and port, 
  1010.  synch tolerance, attribute handling, directory creation, and colors.  Type:
  1011.                      ZIPSET ZIP.COM
  1012.  (Actually, you can omit the filename if it is "ZIP.COM"; otherwise, type it.)  
  1013.  Your current default settings will be displayed.  To change them, select 
  1014.  "Edit" from the ZIPSET menu, make changes, then select "Save"; to restore the 
  1015.  original distribution settings, select "Restore".  To exit without saving 
  1016.  changes, select "Quit".
  1017.  
  1018.      The Edit procedure steps through a sequence of settings you can change.  
  1019.  For the port you may enter simply "COM1" through "COM4", or any specific 
  1020.  hexadecimal address required by your hardware ("03F0", etc).  For the speed 
  1021.  you must choose by number from the allowed values.  For the clock synch 
  1022.  tolerance, enter a value from 1 to 99 minutes, or 0 to disable synch testing.
  1023.  
  1024.      The next set of choices configure ZIP's treatment of DOS file attributes 
  1025.  and nonexistent directories.  You can determine whether or not Hidden or 
  1026.  System files will be included in ZIP's operations; whether ZIP can overwrite 
  1027.  or delete files that have the Read/Only attribute; whether a file's Archive 
  1028.  attribute should be copied, if set; whether use of the /A backup option 
  1029.  should mark source files as archived, by removing that attribute; and 
  1030.  finally, whether ZIP should create new directories when those required do not 
  1031.  already exist.  Press "Y"/"N" for yes or no, or for directory creation, "J" 
  1032.  for just-as-needed.
  1033.  
  1034.      Next there is an option to control the prompting for options 
  1035.  (/S,N,E,T,A,P) that will normally occur in menu mode if options are not 
  1036.  specified after the transfer filespec.  Select "N" to defeat it.
  1037.  
  1038.      Finally, ZIPSET offers you a choice of color output (via the PC BIOS) or 
  1039.  standard DOS output.  You might want to select DOS output if color output 
  1040.  does not display correctly on your video system, or if you will want to 
  1041.  redirect output from ZIP to a file or device (color output does not 
  1042.  redirect).  Whichever default you choose, the /M option will change to the 
  1043.  other.
  1044.      If you select color, ZIPSET displays a palette and offers you a choice of 
  1045.  text colors.  ZIP uses three different colors: a "message" color, a "hilight" 
  1046.  color for contrast, and an "active" color (during file transfer activity).  
  1047.  Each is specified by an "attribute byte" consisting of two hex digits, for a 
  1048.  background and foreground color.  ("17" = "1", blue background, & "7", white 
  1049.  text.)  The color digits are:
  1050.          0 = BLACK   4 = red       8 = GREY           C = bright red
  1051.          1 = blue    5 = magenta   9 = bright blue    D = bright magenta
  1052.          2 = green   6 = brown     A = bright green   E = yellow
  1053.          3 = cyan    7 = WHITE     B = bright cyan    F = BRIGHT WHITE
  1054.      The palette will include 128 colors from 00-7F.  Use of colors 8-F as 
  1055.  background (80-FF) is also possible but not recommended, since on most 
  1056.  systems this produces blinking video.  Some colors may be invisible or 
  1057.  indistinguishable on monochrome screens, though all MDA systems can display 
  1058.  BLACK, WHITE and BRIGHT WHITE, and in some cases GREY also.
  1059.  
  1060.      ZIP also offers a DEBUG patch allowing use with the DIET compression 
  1061.  utility; see COMPATIBILITY below.  Although this patch is not done with 
  1062.  ZIPSET, selecting "Restore defaults" will undo it.
  1063.  
  1064.      Please DO NOT distribute modified copies of ZIP.COM; this could confuse 
  1065.  other users.
  1066.  
  1067.  
  1068.  
  1069.  ========================= 7. TECHNICAL INFORMATION ==========================
  1070.  
  1071.                             A. GENERAL INFORMATION
  1072.  
  1073.      The amount of free memory ZIP requires in order to operate is displayed 
  1074.  when the "/?" option is used.  ZIP 2.01, for example, reports: "Requires 71- 
  1075.  120-170k RAM", meaning that a minimum of 71k RAM is necessary, 120k is 
  1076.  recommended for 8086/286 systems, and ZIP will use up to 170k, if available, 
  1077.  for fastest operation on 80386+ systems.  If this extra RAM is not available 
  1078.  on such systems, the ZIP signon message will report "(Limited memory)", 
  1079.  indicating that optimum performance will not be achieved.
  1080.      When receiving data, ZIP writes to a temporary file, so as not to 
  1081.  overwrite any existing file until the integrity of the received file is 
  1082.  verified; there must be enough free disk space to receive the complete file.
  1083.      ZIP can only process about 1000 (selected) files at once; if you attempt 
  1084.  to use it on a directory with more files than that, you may get the "too many 
  1085.  files" error.  If this happens, you can try to break up the task by using 
  1086.  more restrictive filespecs, like *.DOC instead of *.*.  ZIP can only display 
  1087.  file sizes up to 65535k (64mb); after that it will report "+++++".
  1088.      To achieve the fastest transfers, you should send files to/from hard 
  1089.  disks or RAMdisks, rather than slow floppy disk drives.  Also, certain kinds 
  1090.  of memory-resident software, especially disk compression utilities like 
  1091.  DBL/DRVSPACE or STACKER, can significantly reduce ZIP's effective speed, 
  1092.  particularly on slower computers like palmtops.
  1093.  
  1094.      Be sure you are using the same version of ZIP on each end; if the 
  1095.  protocol has been revised, a connection will not be established.  Do not 
  1096.  disturb the cable while ZIP is transferring files, as this will abort the 
  1097.  current operation.
  1098.      ZIP's proprietary binary transfer protocol differs from other standards 
  1099.  (XMODEM etc), but it does include full CRC (Cyclic Redundancy Checksum) 
  1100.  verification on the data to guarantee accurate transfer.
  1101.      There is no need to worry about IRQ assignments or conflicts, but do not 
  1102.  use ZIP while another program may be accessing the same serial port.  Most 
  1103.  users also will not need to worry about "port addresses", since these have 
  1104.  become well standardized, but some computers (including IBM PS/2's) use 
  1105.  nonstandard addresses for the COM3 and COM4 ports in particular.  Check your 
  1106.  computer manual to be sure; the standard port addresses assumed by ZIP are:
  1107.                    COM1: 03F8h         COM3: 03E8h
  1108.                    COM2: 02F8h         COM4: 02E8h
  1109.  For ZIP to use another nonstandard port address, you must enter the address 
  1110.  itself as a default port using ZIPSET.
  1111.  
  1112.  
  1113.  -------------------------- B. ABOUT SERIAL CABLES ---------------------------
  1114.  
  1115.  
  1116.      Serial (RS232C) cabling is potentially quite complicated, but the simple 
  1117.  fact is that ZIP can transfer files using ANY serial cable you might already 
  1118.  have at hand.  If the connectors don't fit your serial ports, you can attach 
  1119.  a size or gender converter.  It doesn't matter how many wires the cable has; 
  1120.  depending on how they're connected, the cable will either work as is, or 
  1121.  require a "null modem adapter" attached to one end.  If you're shopping for a 
  1122.  cable specifically for use with ZIP, ask for a 3 to 6 foot "null modem cable" 
  1123.  with the correct size and gender connectors to fit the serial ports you 
  1124.  intend to use, or a "laplink cable" with multiple connectors to fit any port.  
  1125.  These cables are inexpensive (typically about $15) and widely available: 
  1126.  check your local computer or electronics store, or a mail-order catalog.
  1127.  
  1128.      PCs typically have two serial ports (though laptops may have only one, 
  1129.  and up to four are possible); they are generally labeled SERIAL, RS232C, 
  1130.  COM1, COM2, COMMS, etc.  Your computer may have one or both of the standard 
  1131.  connector sizes, 9 or 25 pin (DB9, DB25).  Cable connectors are either "male" 
  1132.  (with pins) or "female" (with holes); while most PC ports are female, 
  1133.  requiring male cables, the designers of the IBM PC decided (rather oddly) 
  1134.  that its serial ports should be male, which requires PC serial cables to have 
  1135.  female connectors.
  1136.  
  1137.      Serial cables can be wired internally in various ways: a "null modem" 
  1138.  cable, intended to connect two PCs, has the transmit and receive data lines 
  1139.  crossed.  A normal serial cable, designed to connect a PC to a communication 
  1140.  device like a modem, has these lines wired straight through, but a "null 
  1141.  modem adapter" can be attached to the cable to cross them.  (Modems have 
  1142.  their serial ports wired differently from PCs, so that straight-through 
  1143.  cables can be used to connect them; in RS232C terminology they are DCE, "data 
  1144.  communications equipment", rather than DTE, "data terminal equipment".)  The 
  1145.  simplest cables contain only three wires, these two plus a ground; some have 
  1146.  seven, or more, for other signals used by some serial devices, which makes 
  1147.  them more widely useful, but ZIP doesn't care.  (Note: ZIPDUP does require 
  1148.  the additional handshaking connections shown.)  If you're building or testing 
  1149.  a null modem cable, here is the wiring diagram:
  1150.  
  1151.      |--COMPUTER 1--|             |--COMPUTER 2--|
  1152.       DB9  or   DB25               DB25  or   DB9
  1153.  pin # 2 - - - - 3 - - connect - - - 2 - - - - 3   TD transmit data \
  1154.        3 - - - - 2 - - -  to - - - - 3 - - - - 2   RD receive data   >REQUIRED
  1155.        5 - - - - 7 - - - - - - - - - 7 - - - - 5   SG signal ground /
  1156.  
  1157.  pin # 4 - - - - 20  - - - - - - - - 6 - - - - 6   \
  1158.        6 - - - - 6 - - - - - - - - - 20  - - - 4    \ DTR,CTS etc (optional;
  1159.        7 - - - - 4 - - - - - - - - - 5 - - - - 8    /   required for ZIPDUP)
  1160.        8 - - - - 5 - - - - - - - - - 4 - - - - 7   /
  1161.  
  1162.      Use of a short, well shielded cable is highly recommended; high speed 
  1163.  transmissions can be susceptible to RF interference.
  1164.  
  1165.  
  1166.  ------------------- C. COMPATIBILITY WITH OTHER SOFTWARE --------------------
  1167.  
  1168.  
  1169.      ZIP was designed for use in an MSDOS environment; it is also DESQview- 
  1170.  aware, so that task switching under Quarterdeck's DESQview will not interfere 
  1171.  with its operation.  With appropriate precautions, ZIP can also be used in a 
  1172.  "DOS session" or "box" under other multitasking environments, including 
  1173.  Windows 3.x or 95, and OS/2 (it is not known to work reliably under Windows 
  1174.  NT).  To avoid erratic performance or the need for slower transmission 
  1175.  speeds, ZIP should be given a "non-swappable", "priority task", or 
  1176.  "foreground operation" status, by the appropriate method for your operating 
  1177.  system (window settings, PIF file, etc).  Under Windows 95, ZIP should be run 
  1178.  in DOS mode, not from a DOS "window"; ZIP works only with 11-character DOS- 
  1179.  compatible filenames, and won't recognize or preserve Win95 "long file 
  1180.  names".  Under OS/2, the COM port must be enabled in the settings for the DOS 
  1181.  window, and use of IBM's own COM.SYS serial driver, which has been 
  1182.  substantially improved since its initial release, is recommended; alternative 
  1183.  drivers (like SIO.SYS) may not work with ZIP.
  1184.  
  1185.      ZIP works well with most other software, though it is possible for 
  1186.  certain kinds of memory-resident software (TSRs or caches) to interfere with 
  1187.  its operation, in which case ZIP can't be used with that software loaded.
  1188.  
  1189.      Most disk compression utilities (STACKER, DBLSPACE, etc) operate 
  1190.  transparently -- although files are actually being compressed when written to 
  1191.  disk or decompressed when read back, your other programs will never know.  
  1192.  Unfortunately, there are exceptions -- for example, a shareware utility 
  1193.  called DIET, which reports the compressed sizes of files to other software 
  1194.  instead of the original sizes.  This will confuse a program like ZIP, which 
  1195.  obtains the file size and expects the amount of data read and sent to match 
  1196.  it, leading to errors whenever you attempt to send a file.
  1197.      If you are using a utility like DIET, or if your system is not reporting 
  1198.  the correct sizes of files for any other reason, you can patch ZIP to work 
  1199.  around this problem.  Simply modify ZIP.COM with the DOS utility DEBUG, as 
  1200.  follows:     C>debug zip.com
  1201.               -e103 FF
  1202.               -w
  1203.               -q
  1204.  Once this has been done, the ZIP signon message will report "(Patch 0103)".  
  1205.  You can undo this modification later, by substituting "00" for "FF" above, or 
  1206.  by running ZIPSET and selecting "Restore defaults".
  1207.      In order to transfer files from a system with this problem, you must run 
  1208.  modified copies of ZIP on BOTH ends.  You will also want to keep an 
  1209.  unmodified copy of ZIP for use on other computers, since this patch defeats a 
  1210.  useful safety check and also prevents ZIP from operating as fast as possible 
  1211.  on 80386+ systems.
  1212.  
  1213.  
  1214.  ------------------------ D. HP95/100/200LX PALMTOPS -------------------------
  1215.  
  1216.  
  1217.      The Hewlett-Packard 95/100/200LX palmtop computers are "nearly" PC- 
  1218.  compatible; ZIP will work on them, but there are some special considerations.  
  1219.  You will need the special HP serial cable, which is sold either separately or 
  1220.  as part of the Connectivity Pack.  (ZIP doesn't work with the infrared port.)
  1221.      ZIP automatically detects the LX palmtop and its actual screen size, 
  1222.  setting 40-column operation unless the LX is in 80-column mode, and adjusting 
  1223.  after any use of the ZOOM key.  ZIP also prevents the palmtop from going to 
  1224.  sleep during file transfer operations.
  1225.      If you're going to use the LX's built-in serial port, ZIP should be set 
  1226.  for COM1 in the usual way.  (ZIP doesn't restrict itself to COM1 on the LX, 
  1227.  since a PCMCIA card can function as COM2.)  ZIP powers up the serial port as 
  1228.  needed and turns it off again afterward to conserve batteries, so you don't 
  1229.  need to leave serial port power on in SETUP or worry about using SERCTL.
  1230.      Transfer rates with the LX palmtop are typical of XT-class PCs, about 8 
  1231.  k/sec; disk compression software on a RAM card will reduce this speed.
  1232.  
  1233.                                  HP 100/200LX
  1234.  
  1235.      The 100/200LX System Manager software can interfere with ZIP's use of the 
  1236.  serial port, making file transfer likely to fail if you just run ZIP from 
  1237.  Filer, or from a DOS session under System Manager.  Typically, due to the 
  1238.  complex nature of the LX palmtop, you can avoid this problem in several ways:
  1239.    (1) Terminate SYSMGR (from Application Manager, press MENU,A,T,Enter) and 
  1240.  run ZIP from the DOS prompt.  Type 100 or 200 to restart SYSMGR.
  1241.    (2) Run ZIP from Application Manager.  ZIP should be installed as:
  1242.                   Name: &Zip
  1243.                   Path: C:\ZIP.COM |120
  1244.                Comment: [Fn+!][Fn+?]
  1245.  The "&" lets you run ZIP by pressing "Z".  This Path shows ZIP residing in 
  1246.  "C:\", but you can use any directory you like.  The "|120" after the Path 
  1247.  specifies a memory allocation; use the second RAM figure from the "ZIP /?" 
  1248.  information message.  An upside-down exclamation point (press Fn,!) is 
  1249.  required at the start of the Comment field to tell SYSMGR not to interrupt 
  1250.  ZIP.  The Fn,? is optional on the 200LX, to return directly to SYSMGR when 
  1251.  you select Quit.  Note that while you are editing this AppMgr entry, you can 
  1252.  install the included ZIP icon as well; just put ZIP.ICN in the same directory 
  1253.  as ZIP.COM.
  1254.    (3) Install and use Mark Scardina's free ASERCTL utility, available on the 
  1255.  CompuServe HPHAND forum, or on your ZIP registration disk.  It not only gives 
  1256.  you keyboard control over serial port power, but also prevents interference 
  1257.  from SYSMGR.  ZIP can then be run in any way you like.
  1258.  
  1259.      ZIPDUP is not customized for the LX palmtops; serial port power must 
  1260.  first be turned on (via SETUP or SERCTL /W).  It is advisable to operate 
  1261.  ZIPDUP from DOS alone, without loading SYSMGR.
  1262.  
  1263.                                    HP 95LX
  1264.  
  1265.      On the 95LX, ZIP can be run in a variety of ways, including from Filer 
  1266.  (highlight ZIP.COM and press F4=Run) or from the DOS system prompt.
  1267.  
  1268.      File transfers can fail on early versions of the 512k 95LX due to a bug 
  1269.  in its serial port handling.  You can avoid this by performing a [Ctrl+Up+On] 
  1270.  reset (answering "No" at the prompt, to preserve your C: drive!) before 
  1271.  running ZIP, or often (for some unknown reason) by just performing a server 
  1272.  Directory request with ZIP before transferring files.
  1273.  
  1274.      The 95LX serial port and cable don't have the additional signal lines 
  1275.  that ZIPDUP requires to operate; instead, to transfer ZIP.COM to the 95LX, 
  1276.  you must use the 95LX's internal software: either the built-in COMM utility 
  1277.  together with any PC telecom program supporting XMODEM or KERMIT protocol, or 
  1278.  the Connectivity Pack.
  1279.  
  1280.  
  1281.  ---------------------------- E. ERROR MESSAGES ------------------------------
  1282.  
  1283.  
  1284.        Ready / Waiting  connection has not yet been established.
  1285.       <Argument error>  invalid filespec, option, etc.
  1286.  <Insufficient memory>  not enough memory to load and run ZIP.
  1287.        <Connect error>  can't connect -- bad cable? wrong version? timeout?
  1288.            <No server>  function requires server mode on other computer.
  1289.       <Too many files>  filespec includes too many files to process at once.
  1290.          <@file error>  @file nested or too large to read.
  1291.        <Bad directory>  specified directory doesn't exist or can't be created.
  1292.        <Name conflict>  filename conflicts with directory or read/only file.
  1293.         <Delete error>  specified file doesn't exist, is read/only, etc.
  1294.           <Read error>  error reading a file: access denied, etc.
  1295.          <Write error>  error writing a file: disk full, invalid path, etc.
  1296.              <Aborted>  you pressed Esc/^C/Ctrl-Break.
  1297.                <Error>  communication error, or ANY error on OTHER computer.
  1298.                           (see message on other computer for cause)
  1299.  
  1300.      Error return (ERRORLEVEL) codes are described under "Batch Files" above.
  1301.  
  1302.  
  1303.  ----------------------- F. ABOUT ZIP AND ITS AUTHOR -------------------------
  1304.  
  1305.  
  1306.      ZIP has been well reviewed in numerous computer newsletters; it has been 
  1307.  included on the HP Palmtop Paper's subscriber disk for HP95/100LX users, and 
  1308.  on disk with the following computer books:
  1309.      "DOS 6.0 Power Tools" by John Goodman & John Socha (Bantam Books)
  1310.      "DOS Stuff Microsoft Forgot" by Tim Stanley (Que Books)
  1311.      "The Little Laptop Book" by Steve Cummings (Peachpit Press)
  1312.  
  1313.  
  1314.          "lightning fast and simple to learn... simply dazzling... 
  1315.          ZIP provides the fastest file transfer between PCs using 
  1316.          the tiniest amount of disk space...  a simple, lean, and 
  1317.          very effective program, not to mention the fastest of all 
  1318.          the programs we looked at for this review."
  1319.                          -- Bil. Alvernaz, Quantum PC Report, June 1992
  1320.  
  1321.  
  1322.      Eric Meyer has also written the shareware VDE editor/word processor and 
  1323.  Meyer File/Directory (MFD) utilities, as well as a number of free utilities 
  1324.  for IBM PC compatibles.  He holds an A.B. in physics and a Ph.D. in history 
  1325.  and philosophy of science, and has taught at the Universities of Indiana, 
  1326.  Oklahoma, and Colorado.  A longtime computer enthusiast, he has programmed in 
  1327.  languages from APL to Z80; this DOS software is written in 8086 assembler.  
  1328.  Despite industry trends toward complexity and instant obsolescence, he still 
  1329.  believes that useful, inexpensive programs should remain available to users 
  1330.  of even the simplest personal computers worldwide.
  1331.  
  1332.  
  1333.  ====================================[end]====================================
  1334.