home *** CD-ROM | disk | FTP | other *** search
/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / UT / UT058.ZIP / ZIP.DOC < prev    next >
Text File  |  1989-11-26  |  23KB  |  464 lines
  1.  
  2.                                    ZIP.DOC
  3.                                    -------
  4.                            Instructions for ZIP.COM
  5.                    IBM PC Fast Serial File Transfer Utility
  6.                            Version 1.41 (11/26/89)
  7.  
  8.                              (c)1988-89 E. Meyer
  9.  
  10.  
  11.         Requires:  two IBM PC compatible computers with DOS 2.x or above;
  12.                    appropriate serial (null modem) cable.
  13.  
  14.  
  15.  
  16.      ZIP is a tiny, fast utility to transfer files between two IBM compatible 
  17. computers over an ordinary serial cable connection.  This is especially useful 
  18. when the computers don't share a common disk size or format.
  19.  
  20.  
  21. ===============================  USAGE POLICY  ===============================
  22.  
  23.  
  24.      The ZIP utility and its documentation are copyright (c)1988-89 Eric 
  25. Meyer, all rights reserved.  They may not be circulated in any incomplete or 
  26. modified form, nor sold for profit, without written permission of the author.  
  27. The use or sale of ZIP is subject to the following terms:
  28.  
  29. INDIVIDUAL USE:       ZIP may be freely used and shared with others; there is 
  30. ----------         no required registration fee.  (If you like ZIP and find it 
  31.                    useful, please do consider sending a contribution!)
  32.  
  33. INSTITUTIONAL USE:    Any corporation or institution wishing to use ZIP in the 
  34. -------------      course of its business must purchase a SITE LICENSE.  A 
  35.                    standard license, allowing the use of ZIP on up to 20 
  36.                    different computers, can be ordered for US $50.00; write 
  37.                    for terms concerning larger quantities.  A disk containing 
  38.                    the latest release of ZIP will be included at no additional 
  39.                    charge (please specify 5.25" 360k or 3.5" 720k disk).
  40.  
  41. COMMERCIAL SALE:      Any software dealer or library may offer ZIP for sale, 
  42.            ----    as long as the price of the disk containing the program 
  43.                    does not exceed US $5.00.  With this single exception, the 
  44.                    sale of ZIP for profit, either alone or together with other 
  45.                    software or hardware, requires a contract to provide for 
  46.                    royalty payments.  Please write to the author for terms.
  47.  
  48. CUSTOMIZATION:        It is often possible to develop modified versions of ZIP 
  49.                    for special applications.  Contact the author for details.
  50.  
  51.  
  52.            Eric Meyer
  53.            401 12th Ave SE, #139            CompuServe [74415,1305]
  54.            Norman, OK  73071  USA
  55.  
  56.  
  57.      DISCLAIMER: You undertake to use ZIP at your own risk.  The author 
  58. assumes no liability for damages of any kind resulting from your use of ZIP.
  59.  
  60.  
  61. ===============================  INTRODUCTION  ===============================
  62.  
  63.  
  64.      Anyone with two computers probably needs to transfer programs or data 
  65. between them.  There are a number of ways to do this:
  66.  
  67.      (1) If you have compatible disk drives, you can just swap disks back and 
  68. forth.  But if you're transferring large amounts of data, or do this 
  69. frequently, that's slow, and a lot of wasted motion.  And if you have a data 
  70. file that's too big for one disk, you're out of luck.
  71.      (2) If you have incompatible drives, like a PC/AT's 5.25" disks and a 
  72. laptop or PS/2's 3.5" disks, you'd have to buy an expensive hardware add-on.  
  73. Want to fill another slot with a proprietary card to communicate with your 
  74. laptop?  Want to buy an external disk drive, and haul it around with you?
  75.      (3) You can buy a commercial file transfer program like LapLink or 
  76. Brooklyn Bridge.  Great software, and they even include a cable -- but often 
  77. cost over $100, almost as much as a hardware solution.  And their TSR drivers 
  78. consume precious system memory.
  79.      (4) You can buy or make a simple null modem cable, and transfer files 
  80. using the XMODEM protocol of your favorite telecom program.  This cheap 
  81. solution will work (I used to do it all the time) but even at 19200 bps it 
  82. seems slow, and the software is cumbersome to set up and exit.
  83.      (5) You can search the free/shareware world for a simple, efficient 
  84. program designed to do this faster, by taking the data rate all the way up to 
  85. 115200 bps like the commercial programs (LL,BB) do.  PCMag's ZCOPY is one... 
  86. but ZIP transmits about twice as fast (using a faster serial I/O technique), 
  87. and has more powerful features.
  88.  
  89.      ZIP can transfer data up to 6 times faster than a telecom program over a 
  90. serial cable... 48 times faster than typical modem transfers.
  91.             Telecom programs: modem       2400 bps            0.3 K/sec
  92.                             : cable      19200 bps            2.3 K/sec
  93.             ZIP: cable                  115200 bps     up to 14.1 K/sec
  94.      If you don't own the latest '386, ZIP will come about as close to this 
  95. amazing throughput as your computer speed allows.  (Between my 8MHz XT clone 
  96. and 4.77MHz laptop, it reaches about 10K/sec.)  Of course, disk access also 
  97. takes time; with any system, large amounts of data can be sent more quickly 
  98. using hard or RAM disks, rather than (slow) floppy disk drives.
  99.  
  100.  
  101.                            XMODEM TRANSFER BY CABLE
  102.  
  103.      As mentioned above, you can use most telecom programs to transfer files 
  104. between computers by cable, without a modem.  In fact, you may need to do this 
  105. in order to get a copy of ZIP.COM on both computers before you can begin using 
  106. it!  The file transfer will work the same way as with a remote system, except 
  107. that there is no modem and no dialing involved.  You will need a serial 
  108. (RS232) "null modem" cable -- NOT the same cable you connect to your modem, 
  109. though such a cable should work if you attach a "null modem" adapter to it.
  110.      Connect the serial cable; enter the telecom program and set the 
  111. parameters (try 19200 bps, 8 bits, no parity) on both computers; enter 
  112. terminal mode, unless (as in ProComm for example) you're there already; then 
  113. try typing, and see if the characters appear on the other end.  If not, you 
  114. have a problem with the parameters, the port selection, or the cable.  If so, 
  115. go ahead and run the upload function on the machine that has ZIP, and download 
  116. on the other, with your usual protocol (XMODEM or whatever).
  117.  
  118.  
  119.                                  RUNNING ZIP
  120.  
  121.      Once you have a copy of ZIP on both computers, transferring a file is as 
  122. easy as copying it from one disk to another.  To transfer files, once the 
  123. cable is properly connected to the serial ports of the two computers, from the 
  124. DOS prompt:
  125.  
  126.            1.  MENU-DRIVEN OPERATION.  Simply type "ZIP" on both 
  127.       machines; the program will step you through all the necessary 
  128.       choices, including transferring or receiving files.
  129.            You will also have the option to view file directories 
  130.       and/or delete files.
  131.  
  132.            2.  Command line operation, for experienced users.  (See 
  133.       full explanations and usage examples, below.)
  134.               C>zip FILENAME      to send a file
  135.               C>zip /R            to receive
  136.               C>zip FILENAME /F   to fetch a file from serer
  137.               C>zip /S            to enter server mode
  138.  
  139.      As each file is transferred you should see a line of "=" signs 
  140. representing the remaining file length (if over 64k), with a blinking asterisk 
  141. ("*") at the end.
  142.      When ZIP is running, it can be aborted by pressing ^C (or Ctrl-Break):       
  143.               (1) on either end, during initial handshaking
  144.               (2) on sending end, during file transfer
  145.                     (will abort once current file is finished)
  146.               (3) at a server directory input prompt.
  147.  
  148.  
  149.                                 SENDING FILES
  150.  
  151.      In menu mode, simply select "S"end, and you will be prompted for the 
  152. filename(s).  For command-line use, specify the name(s) of the file(s) to send:
  153.  
  154.               C>zip FILENAME
  155.  
  156. The "FILENAME" can be a single file (including directory), or a GROUP 
  157. specified by wildcards (eg, *.BAK), or a LIST of these delimited by commas or 
  158. semicolons (FILE1,FILE2).  A comma assumes the same drive/directory as the 
  159. previous item (unless the new item begins with a drive or root directory), a 
  160. semicolon does not.  Thus
  161.  
  162.               C:\WRK>zip B:\SF\GORT,LTRS\*.892;KLAATU
  163.  
  164. will send files B:\SF\GORT, B:\SF\LTRS\*.892, and C:\WRK\KLAATU.
  165.      Any desired options may follow the filename(s).  Files will appear with 
  166. the same filename, in the receiving directory.  Take care not to send two 
  167. files with the same name, as one would overwrite the other.
  168.  
  169.  
  170.                                RECEIVING FILES
  171.  
  172.      In menu mode, simply select "R"eceive, and you will be prompted for the 
  173. directory to receive into.  For command-line use, specify the option "/R" for 
  174. RECEIVE:
  175.               C>zip /R
  176.  
  177. Each file will appear with its original filename.  Files are received into the 
  178. current directory, unless you specify another.  In command line mode, this can 
  179. be done in square brackets after the /R option:
  180.  
  181.               C>zip /r[DIRECTORY]
  182.  
  183. (Note: ZIP also still accepts the syntax of earlier versions, where the 
  184. directory was specified from the command line by typing:
  185.               C>zip DIRECTORY /r
  186. but this tends to seem confusing, and may not continue to be supported.)
  187.  
  188.  
  189.                           SELECTING THE SERIAL PORT
  190.  
  191.      IBM-compatible computers have anywhere from one to four serial (RS232) 
  192. ports.  By default ZIP uses the COM1 port.  The standard port addresses are:
  193.               COM1: 03F8h         COM3:03E8h
  194.               COM2: 02F8h         COM4:02E8h
  195. Some computers (including PS/2s!) use different port addresses for COM3 and 
  196. COM4; to use a nonstandard port address, you must modify ZIP.COM with ZIPCFG.
  197.      You can select any standard COM port during operation of ZIP:  in menu 
  198. mode, just select the choice to modify "P"arameters.  In command line mode, 
  199. specify one of the following options:
  200.  
  201.             /1-4  = Use port COM1-4.
  202.  
  203.      You will see a note in the ZIP signon message, "Port=____", giving the 
  204. port address in use.
  205.  
  206.  
  207.                          SELECTING FILES FROM A GROUP
  208.  
  209.      If you want to transfer only certain files in a group (such as *.BAK) 
  210. with ZIP, you can request that you be prompted to confirm each file 
  211. individually: you will be asked to hit a key (Y/N) to determine whether the 
  212. file is to be sent.  (In menu mode, you can select "O"ptions for a help 
  213. message describing the selective copy operations.)  After the names of files 
  214. to be transferred, in menu or command line mode, specify this option:
  215.  
  216.               /P  = PROMPT to confirm files individually
  217.  
  218.      This option (which can be combined with others) can be specified on 
  219. either end -- but the option on the SENDING (or active) end governs each 
  220. transfer.  You will see a note in the ZIP signon message, "Option /P", if this 
  221. option is in effect.
  222.  
  223.  
  224.                               OVERWRITING FILES
  225.  
  226.      It is possible that a file already exists on the receiving end with the 
  227. same name as the one being sent.  By default, ZIP doesn't care: it will 
  228. transfer all files specified, whether or not they overwrite existing ones.  
  229. Several options are provided to modify this behavior.  (In menu mode, you can 
  230. select "O"ptions for a help message describing the selective copy operations.)  
  231. After the names of files to be transferred, in menu or command line mode, 
  232. specify one (or two) of these options:
  233.  
  234.               /N  = copy NONexisting files only
  235.                        (cannot be used with /E or /T)
  236.               /E  = copy EXISTING files only
  237.               /T  = TIMESTAMP determines files sent
  238.  
  239.      The /N option will prevent all files from being overwritten.  The /T 
  240. option will allow overwrites only when the new copy has a more recent time 
  241. stamp.  The /ET combination is especially useful for backup purposes: it 
  242. transfers only more recent copies of files that already exist.
  243.      These options can be specified independently on either computer -- but 
  244. the options on the SENDING (or active) end govern each transfer.  You will see 
  245. a note in the ZIP signon message, "Option /_", if an option is in effect.
  246.  
  247.  
  248.                                  SERVER MODE
  249.  
  250.      It would obviously be easier to transfer files if you could do all the 
  251. typing from one keyboard -- and "server mode" lets you do just that.  In 
  252. server mode, ZIP stays "on line" on one end, ready to send or receive files, 
  253. or answer directory requests, from the other end automatically.  To enter 
  254. server mode: in menu mode, just select the choice for ser"V"er.  In command 
  255. line mode, specify the option /S for SERVER:
  256.  
  257.               C>zip /S
  258.  
  259.      ZIP will then remain ready to exchange files until such time as you press 
  260. ^C or Ctrl-Break to exit server mode.
  261.  
  262.      From the other ("active") keyboard, you can then transfer files TO the 
  263. server; these will be received into the default directory, either the current 
  264. one or another that you specify in square brackets:
  265.  
  266.               C>zip /s[NEWDIR]  = Server mode, default directory NEWDIR.
  267.  
  268.      In any event, when you send files to the server, you will be prompted for 
  269. a destination directory (if desired) to override the default on the server end.  
  270. In command-line mode, you can specify this on the command line in brackets:
  271.  
  272.               C>zip sendfile /[DESTDIR]
  273.  
  274. (Specify "/[]" if you simply want to avoid the prompt and use the default, for 
  275. example, when running ZIP from a batch file.)
  276.  
  277.      You can also fetch files FROM the server.  In menu mode, just select the 
  278. choice to "F"etch files.  In command line mode, specify the option:
  279.  
  280.               /F  = Fetch specified files from server.
  281.  
  282.      You must specify the directory with the filenames, if they are not in the 
  283. default directory on the server end.  You will be prompted for a directory to 
  284. receive the files into, unless you specify one in square brackets after the /F 
  285. option:
  286.               C>zip filename /f[DESTDIR]  = Fetch into directory DESTDIR.
  287.  
  288. (Again, specify "/f[]" to avoid the prompt and use the current directory.)
  289.      A fetch request will not be completed until server mode is detected on 
  290. the other end.
  291.  
  292.  
  293.                     VIEWING DIRECTORIES and DELETING FILES
  294.  
  295.      When ZIP is in menu-driven mode, you will see choices for "D"irectory and 
  296. d"E"lete, offering simple file maintenance from within ZIP.COM itself.
  297.      The directory function provides an alphabetized file listing for your 
  298. reference, and the free space left on the disk.  You will be prompted for the 
  299. files to list.  If you just hit RETURN, ZIP lists all files (*.*) in the 
  300. default directory.
  301.      The delete function prompts for a filename to delete (as always, a 
  302. directory may be included).  Note that wildcards ("*,?") are NOT allowed.
  303.  
  304.      If the other computer has ZIP running in SERVER MODE, you can also 
  305. request a directory from it, or delete files on it.  Simply type a ">" before 
  306. the filespec for the server.  This can be done alone, or together with a 
  307. request on the active end:
  308.  
  309.               Directory: \WORK\*.BAK                active alone
  310.               Directory: >B:\BACKUP                 server alone
  311.               Directory: \WORK\*.BAK >B:\BACKUP     combined
  312. and similarly,
  313.               Delete: \WORK\THIS.FIL >B:\BACKUP\THAT.FIL
  314.  
  315.      A server directory or delete request will not be completed until server 
  316. mode is detected on the other end.
  317.  
  318.  
  319.                       USAGE EXAMPLES (Command line mode)
  320.  
  321. SENDING FILES:
  322.  
  323. C>zip b:myfile,*.doc              sends files B:MYFILE, B:*.DOC
  324.  
  325. C>zip my.* /2 /p                  sends files C:MY.* over COM2, with
  326.                                 prompts to confirm each file individually
  327.  
  328. C>zip *.* /n                      sends all files which don't already exist
  329.                                 on receiving directory
  330.  
  331. C>zip a:chapter.* /et             sends all files A:CHAPTER.* of which an
  332.                                 older version exists on the receiving end
  333. RECEIVING FILES:
  334.  
  335. C:\WORK>zip /r                    receives files into directory C:\WORK
  336.  
  337. C:\WORK>zip /2 /r[\temp]          receives over COM2 into directory C:\TEMP
  338.  
  339. ENTERING SERVER MODE:
  340.  
  341. C>zip /s                          waits as server to send or receive files
  342.  
  343. C>zip /s[d:\]                     waits as server, with default directory D:\
  344.  
  345. EXCHANGING FILES WITH SERVER:
  346.  
  347. C>zip *.bak /[]                   sends files *.BAK to server's default dir
  348.  
  349. C>zip *.bak /[b:\recs]            sends files *.BAK to directory B:\RECS
  350.  
  351. C>zip b:\recs\my.* /f             fetches files MY.* from directory B:\RECS
  352.  
  353. C>zip b:\recs\my.* /f[\orig]      fetches files MY.* from directory B:\RECS
  354.                                 on server into directory C:\ORIG
  355.  
  356.  
  357.                             BACKING UP A HARD DISK
  358.  
  359.      At times you may need to transfer the entire contents of a sizable disk, 
  360. including several levels of directories.  ZIP is not really designed to do 
  361. this directly: it does not look for files within subdirectories.  However, it 
  362. is easy enough to put the receiver in Server mode, then run a BAT file 
  363. containing a separate command for each desired directory:
  364.               zip \work\*.* /t[\work]
  365.               zip \work\ed\*.* /t[\work\ed]  ...
  366.  
  367.  
  368.                               TECHNICAL DETAILS
  369.  
  370.      Like many communications programs, ZIP does full CRC (Cyclic Redundancy 
  371. Checksum) verification on the data to guarantee accurate transfer, although 
  372. ZIP uses its own transfer protocol.  Be sure to use the SAME version of ZIP on 
  373. both ends: the transfer protocol may have changed.  Do not disturb the cable 
  374. when ZIP is running, as this may cause the program to stall, requiring a 
  375. reboot of your computer(s).
  376.  
  377.      Your SERIAL CABLE should be a "null modem" cable: if you're building or 
  378. shopping for a cable, the transmit and receive data lines (pins 2 and 3 on a 
  379. DB25 -- pins differ on a DB9) should be crossed, the frame and signal ground 
  380. (1 and 7 on a DB25) straight through.  No further connections should be 
  381. needed; ZIP uses no hardware handshaking lines.  Any cable that doesn't work 
  382. by itself, should with a null modem adapter attached.  If possible, use a 
  383. properly shielded cable; high speed transmissions can be especially 
  384. susceptible to RF interference.  I am not an expert on RS232 hardware: find a 
  385. good book if you need further assistance.
  386.  
  387.  
  388.                       Adjusting the Baud Rate and Delay
  389.  
  390.      BAUD RATE: ZIP normally transmits data at 115200 bps.  For some 
  391. specialized applications it may be necessary to set a slower baud rate.  There 
  392. is no run-time option for this; it can only be set with ZIPCFG.
  393.  
  394.      DELAY: Most users also will not need to worry about the "delay factor".  
  395. (In fact, it will be removed from future versions unless users notify me that 
  396. they still need it.)  In theory, due to large differences in raw CPU speed, 
  397. when sending files from a very fast '286 or '386 AT to a very slow PC, the 
  398. receiver might be unable to keep up, and the transfer would be aborted.  
  399. Therefore a delay factor is provided, ranging from 0 (the default) to 9, to 
  400. slow down the sending rate.  You can experiment with delay settings in menu 
  401. mode (select the choice to modify "P"arameters), or make modifications with 
  402. ZIPCFG to the copy of ZIP on the "fast" computer.
  403.      This option can be specified on either computer -- but the setting on the 
  404. SENDING end governs each transfer.  You will see a note in the ZIP signon 
  405. message, "Delay=_", giving the current default.
  406.  
  407.  
  408.                                  USING ZIPCFG
  409.  
  410.      If you don't instruct it otherwise, ZIP will use its built-in "defaults" 
  411. of port COM1, 115200 bps, no delay.  You can, however, configure your copy of 
  412. ZIP.COM to change these defaults as you like, using ZIPCFG.COM: just type
  413.               C>zipcfg FILENAME
  414. (If you omit the filename it defaults to "ZIP.COM".)  You will be given the 
  415. chance to specify any new default values you like.
  416.  
  417.      Please DO NOT distribute modified copies of ZIP.COM; this could confuse 
  418. other users.  They are for your personal use only.  (ZIPCFG includes an option 
  419. to restore the original default values.)
  420.  
  421.  
  422.                                 ERROR MESSAGES
  423.  
  424.     <Argument error>  invalid command line argument(s).
  425.      <Out of memory>  less than 64K free RAM available.
  426.      <No connection>  no files transferred.  (Bad cable? Wrong version?)
  427.          <No server>  function requires server mode on other computer.
  428.     <Too many files>  global filespec (eg *.*) includes over 512 files.
  429. <Conflict with NAME>  name conflicts with a directory or read/only file.
  430.      <Cannot delete>  specified file didn't exist, was read/only, etc.
  431.         <Disk error>  trouble writing to disk.  (Disk full?)
  432.            <Aborted>  you pressed ^C.
  433.              <Error>  error on other end; or, unrecoverable error.
  434.  
  435.  
  436.                               PROBLEMS USING ZIP
  437.  
  438.      ZIP now works well on the vast majority of systems; please let me know if 
  439. you encounter trouble.  Under certain software environments, particularly 
  440. memory resident programs (TSRs) such as disk caches or multitasking, ZIP may 
  441. fail to work; if you experience problems, do not use ZIP with that software.
  442.  
  443.  
  444.                                VERSION HISTORY
  445.  
  446. ZIP 1.0  (4/88) - trial release.
  447.     1.1  (4/88) - improved protocol; batch transfers; receive directory 
  448.                  option; original file time/date preserved.
  449.     1.2  (5/88) - improved error handling; patchable default port also 
  450.                  allows use of COM3,4; small bug fixes.
  451.     1.21 (5/88) - slower speed options; fixed bug in initializing ports.
  452.     1.22 (8/88) - improved protocol; fixed bug in deleting temp file.
  453.     1.23 (1/89) - menu-driven operation; detects disk-full errors.
  454.     1.3  (4/89) - selective copy options /P,N,E,T; server mode, fetch; 
  455.                  file directory; internal improvements.
  456.     1.4  (9/89) - true error correction; delete file function; directory 
  457.                  shows free space; ZIPCFG utility; small improvements.
  458.     1.41 (11/89) - DesqView aware; comma/semicolon file delimiters.
  459.  
  460. (One final note -- this should be obvious but I'll say it anyway: ZIP is not 
  461. related to the new PKZIP series of file compression utilities by Phil Katz.)
  462.  
  463. ====================================[end]=====================================
  464.