home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 15 / CD_ASCQ_15_070894.iso / vrac / izmbeta1.zip / IZM.DOC < prev    next >
Text File  |  1994-06-01  |  34KB  |  674 lines

  1.                   IceZmodem File Transfer Protocol Documentation
  2.  
  3.                                   By Alan Caruana
  4.  
  5.                        Copyright (C) 1994 IceSoft Software
  6.                                 All Rights Reserved
  7.  
  8.                          Documentation for Version Beta1
  9.                                    PLEASE NOTE
  10.              Version Beta1 is a beta test copy and may contain bugs
  11.                    Please report ALL bugs to IceSoft Software
  12.  
  13.       Mail:  IceSoft Software       E-Mail:  IceNET..: 3@1 or 3@2
  14.              215 Labelle Ave.                WWIVnet.: 3@7653
  15.              Blasdell, NY 14219              Internet: Icefreezr@delphi.com
  16.  
  17.        Latest version is available at The Great White North (716) 592-5652 
  18.                        E-Mail User #3 for IceSoft Software
  19.  
  20. ----------------------------< Table of Contents >-----------------------------
  21.  
  22.  Introduction...: 1. Shareware Notice/License/Distribution
  23.                   2. Disclaimer
  24.                      Description
  25.                   3. What is included
  26.                      Getting Started
  27.  IceZmodem Usage: 4. The IceZmodem Command Line
  28.                   6. Hardware Requirements
  29.                      The IZMSETUP Program
  30.  You Should Know: 9. TurboTrans
  31.                      Handshaking
  32.                      The 16550 UART
  33.                      Acknowledgements
  34.  Appendixes.....:10. Appendix A: Setting up IceZmodem
  35.                      Appendix B: Freeing Your Memory
  36.                  12. Appendix C: Error Messages
  37.                  13. Appendix D: IceZmodem Command Line Examples
  38.                      Appendix E: Revision History
  39.  
  40. --- PAGE 1 -----------------< Shareware Notice >------------------------------
  41.  
  42.  IceZmodem is distributed as an unregistered shareware product. This means
  43.  that an unregistered copy of IceZmodem may be freely distributed to any
  44.  individuals, businesses or organizations for evaluation purposes to decide
  45.  if the product is worth purchasing. If you like IceZmodem and decide to use
  46.  it, you must register (purchase) it.
  47.  
  48.  Using this shareware system, you will be able to try out the software before
  49.  you make a commitment to purchase it. If you have paid any money for this
  50.  program, it has gone to the distributor of the program and not to IceSoft
  51.  Software.
  52.  
  53.  Registration costs only $25 and will remove all annoying screens and sounds
  54.  and will enable enhanced features. The best part is, $25 will register this
  55.  and ALL future versions of IceZmodem. You will NEVER have to pay for an
  56.  upgrade!
  57.  
  58.  To register, refer to the file REGISTER.FRM or send a check or money order
  59.  of $25 to:
  60.                IceSoft Software
  61.                215 Labelle Ave.
  62.                Blasdell, NY 14219
  63.  
  64. ---------------------------------< License >----------------------------------
  65.  
  66.  IceZmodem, although it is on this computer, is not the property of the owner
  67.  of the computer. It is the property of IceSoft Software. It may be freely
  68.  distributed as long as all files are intact in the original ZIP package.
  69.  This distribution is for evaluation purposes only. Once it is established
  70.  that the operator of the computer is going to use IceZmodem continuously,
  71.  it must be registered. This applies to home, school, business or government
  72.  use.
  73.  
  74.  An UNREGISTERED VERSION (as freely distributed) may be shared freely.
  75.  
  76.  A REGISTERED VERSION of IceZmodem may NOT be distributed. A registered
  77.  version is for use on only ONE computer and may not be shared freely.
  78.  
  79.  If this program is to be used on more than one computer (such as in a
  80.  school or business) then the copies should be purchased in volume or a
  81.  site license should be obtained. See REGISTER.FRM for more information
  82.  on volume discounts and site licenses.
  83.  
  84. -------------------------------< Distribution >-------------------------------
  85.  
  86.  The unregistered version of IceZmodem may be freely distributed unmodified
  87.  in its original ZIP package. You may charge a fee of no more than $5 for
  88.  distribution costs of IceZmodem. IceZmodem may not be bundled with any
  89.  hardware or software unless written permisssion is obtained from IceSoft
  90.  Software. IceZmodem program code and IceZmodem setup program may not be
  91.  edited, modified, disassembled or reverse-engineered by any means
  92.  whatsoever. IceZmodem documentation may not be modified, reproduced, edited
  93.  or translated by any means whatsoever.
  94.  
  95. --- PAGE 2 --------------------< Disclaimer >--------------------------------
  96.  
  97.  IceSoft Software is not responsible for any damages to your computer as a
  98.  result of using (or inability to use) IceZmodem. This includes loss of data,
  99.  files, and disk drives. This also includes loss of profit, savings and other
  100.  various damages aroused by the use of IceZmodem.
  101.  
  102.  IceZmodem is thouroughly tested on a variety of computer platforms before
  103.  beta or inital release to perform as stated in the documentation. However,
  104.  no warranty or guarantee may be stated due to the varying hardware systems
  105.  the software will run on.
  106.  
  107. -------------------------------< Description >--------------------------------
  108.  
  109.  IceZmodem Protocol Engine Description:
  110.  -------------------------------------
  111.  
  112.   IceZmodem is a Zmodem protocol with all of the standard features such as
  113.   variable block size, crash recovery, batch downloads and 100% compatibilty
  114.   with other Zmodem protocols.
  115.  
  116.   IceZmodem offers a few options to speed up transfer performance when it is
  117.   connected to another computer running IceZmodem. These include:
  118.  
  119.    - Block size up to 2048 bytes (compared to Zmodem's 1024 byte block size)
  120.    - TurboTrans (which reduces the overhead encountered with Zmodem)
  121.  
  122.  IceZmodem Protocol Extra Features:
  123.  ---------------------------------
  124.  
  125.   When IceZmodem is connected to a standard Zmodem protocol:
  126.  
  127.    - You get one the most comprehensive status displays ever
  128.    - You can shell out to DOS to run any standard DOS commands or programs
  129.      (Transfer temporarily stops execution when programs are executed)
  130.    - You can activate the screen saver to blank the screen during transfer
  131.    - You can write or edit a text file while the transfer is in progress
  132.    - You can play a digital MOD music file while the transfer is in progress
  133.  
  134.   When IceZmodem is connected to another IceZmodem, you can use all of the
  135.   features listed above, plus:
  136.  
  137.    - You get information about the remote user including their name,
  138.      protocol, version, and their location within the IceZmodem protocol.
  139.    - You can chat with the remote user
  140.    - You can get a page of system information about the local and remote
  141.      computers.
  142.  
  143. --- PAGE 3 ----------------< What is included >------------------------------
  144.  
  145.    IZM.DOC      - The IceZmodem documentation you are reading now
  146.    IZM.EXE      - The actual IceZmodem protocol
  147.    IZMSETUP.EXE - The setup program which reads/writes the configuration to
  148.                   IZM.EXE.
  149.    INSTALL.TXT  - A text file that explains how to set up IceZmodem with
  150.                   many popular BBS systems and terminal programs.
  151.    REGISTER.FRM - A text file that you can print out to simplify registration
  152.                   of IceZmodem.
  153.  
  154. -----------------------------< Getting Started >------------------------------
  155.  
  156.  IceZmodem can easily be configured to work with any BBS or terminal program.
  157.  The command lines that are used to operate IceZmodem are similar to the
  158.  popular DSZ external protocol. Appendix A contains instructions on how to
  159.  set up IceZmodem with many popular BBS and terminal programs. Refer to this
  160.  appendix now if you do not know how to get started with your particular BBS
  161.  or Terminal program.
  162.  
  163. --- PAGE 4 -------------< The IceZmodem Command Line >------------------------
  164.  
  165.               IZM [OPTIONS] <File Transfer Type> <File/Pathname>
  166.  
  167.  OPTIONS    (See Appendix D for examples on using IceZmodem)
  168.  """""""
  169.  
  170.    port - This tells IceZmodem what COM PORT you would like to communicate
  171.           with. It can be any value from 1 to 4.  You do not need to specify
  172.           the port if you have already set up your default port in IZMSETUP
  173.           and the default port is the one you would like to use. Specifying
  174.           this option will override your default port in IZMSETUP, but it
  175.           will NOT override your default address/IRQ nonstandard port in
  176.           IZMSETUP.
  177.  
  178.           * Do not use the PORT option combined with the adrirq option *
  179.   
  180.           Below are the standard addresses and IRQs that IceZmodem recognizes
  181.           when you specify the port command. If your address/IRQ is different
  182.           than these, you need to use the adrirq option or set up your
  183.           default address/IRQ in IZMSETUP.
  184.  
  185.                           PORT 1:  Address 3F8   Irq 4
  186.                           PORT 2:  Address 2F8   Irq 3
  187.                           PORT 3:  Address 3E8   Irq 4
  188.                           PORT 4:  Address 2E8   Irq 3
  189.  
  190.            **** EXAMPLE FOR PORT: IZM port 2
  191.  
  192.  adrirq -  This tells IceZmodem the ADDRESS and the IRQ of your NONSTANDARD
  193.            COM PORT if you have one. If upon examining the chart above, you
  194.            do not find your port address/IRQ, you use this command to specify
  195.            the address/IRQ of your port. It uses the syntax:
  196.  
  197.                               adrirq address,irq
  198.  
  199.            This option will overrride the address/IRQ you specify in IZMSETUP
  200.                    * DO NOT USE ADRIRQ COMBINED WITH THE PORT OPITON *
  201.  
  202.            **** EXAMPLE FOR ADRIRQ: IZM adrirq 3F8,4
  203.  
  204.  speed  - This tells IceZmodem the speed (bits per second) that the COM PORT
  205.           is operating at. If this option is not specified, IceZmodem will
  206.           assume that the COM PORT is already set at the proper speed (which
  207.           it always should be before IceZmodem is executed) and should work
  208.           properly.
  209.  
  210.           **** EXAMPLE FOR SPEED: IZM port 2 speed 2400
  211.  
  212. --- PAGE 5 ------------------------------------------------------------------
  213.  
  214.    flow - After the word flow, you may use SLOW or HARD. Specifying SLOW
  215.           will cause IceZmodem to stop the sender from sending data during
  216.           disk writes. This is good if the receiver is writing the file to
  217.           a floppy disk or a slow hard disk. Specifying HARD will turn the
  218.           hardware handshaking on. This means if the sender is sending data
  219.           too fast and the receiver cant keep up, the receiver will tell the
  220.           sender to stop sending data until the receiver catches up. ALL high
  221.           speed modems MUST use flow hard.  These options override the
  222.           defaults that you specify in IZMSETUP.
  223.  
  224.           To make this plain and simple, if the receiver is writing to a slow
  225.           hard disk or floppy disk, you MUST use flow slow. If you are using
  226.           greater than 2400 bps, you MUST use flow hard.
  227.  
  228.           You may combine both flow slow and flow hard. See below:
  229.  
  230.           **** EXAMPLE FOR FLOW: IZM port 2 speed 2400 flow slow
  231.           **** EXAMPLE FOR FLOW: IZM speed 19200 flow hard
  232.           **** EXAMPLE FOR FLOW: IZM speed 38400 flow slow flow hard
  233.  
  234.    page - Use either PAGE ON or PAGE OFF to allow the remote to page you with
  235.           a loud beep or not. This will override your default selection in
  236.           IZMSETUP.
  237.  
  238.  File Transfer Type
  239.  """"""""""""""""""
  240.  
  241.      RZ - Use this to receive data. If you do not specify anything after the
  242.           RZ, all files received will go into the current directory. After
  243.           the RZ you may specify a pathname and/or a filename. If a pathname
  244.           is specified, all files will go into that directory. If a filename
  245.           is specified, all received files will be renamed to that filename.
  246.           If a pathname AND filename is specified, all files will go into
  247.           that path and be renamed to the filename specified.
  248.  
  249.      SZ - This is the command to send data. This command must always be
  250.           followed by either:
  251.  
  252.           A filename: SZ program.zip
  253.           A pathname: SZ c:\bbs\dloads\sysop\program.zip
  254.           Many Names: SZ program.zip c:\bbs\log.txt a:\program.exe
  255.           Wildcards : SZ *.zip
  256.           File Lists: SZ @file.lst
  257.  
  258.           OR a combination of ANY of the above things. The File List at the
  259.           end is an @ sign followed by a filename. In this file is a list of
  260.           path/filenames to send - one on each line of the file.
  261.  
  262.           For example, if the file LIST.TXT contained the following:
  263.                         \PROGRAMS\QUADL10.ZIP
  264.                         \BBS\DLOADS\SYSOP\MAIL.ZIP
  265.                         IZM110.ZIP
  266.           ...You could send all 3 of those files with the line:
  267.                     IZM port 1 speed 2400 sz @list.txt
  268.  
  269.  Environment Variables
  270.  """""""""""""""""""""
  271.    If you set the environment variable DSZLOG equal to a filename, IceZmodem
  272.    will create a DSZ-compatible log for programs which require it to run.
  273.  
  274. --- PAGE 6 ----------------< Hardware Requirements >-------------------------
  275.  
  276.    Processor: 8086 or better. You will need at least an 80286 to use the
  277.               Digital MOD Music.
  278.  
  279.    Memory...: At least 190k to transfer files. To play music, edit text files
  280.               and shell to dos, you must have from 200k-500k. This amount of
  281.               memory must be present on top of all the other memory taken by
  282.               terminal programs or BBS systems. (See Appendix B for
  283.               information on gaining more memory)
  284.  
  285.    Display..: Any display will work, but a color monitor is highly
  286.               recommended.
  287.  
  288.    Optional.: Sound Blaster, Disney Sound Source, or a parallel port D/A
  289.               converter for best sounding Digital Music.
  290.  
  291. ----------------------------< The IZMSETUP Program >--------------------------
  292.  The IZMSETUP program included with the IceZmodem package lets you set up
  293.  many of the default options in IceZmodem and sets several options which are
  294.  not adjustable anywhere else in the program. I recommend that you run the
  295.  IZMSETUP.EXE program when you first install your IceZmodem and whenever you
  296.  upgrade to a newer version of IceZmodem. The configuration options are
  297.  stored within the IZM.EXE file itself - eliminating the need for more files
  298.  cluttering up your hard disk and causing more headaches. The only problem
  299.  with this is that you will need to run IZMSETUP whenever you receive an
  300.  IZM.EXE upgrade.
  301.  
  302.  When you first execute IZMSETUP, it will want to know where the IZM.EXE
  303.  file is located. If it is in the current directory, simply hit enter
  304.  otherwise tell it where it is. I am not going to document each option in
  305.  IZMSETUP because there is already documentation within the program. I
  306.  suggest that you go through each option and read what each option does and
  307.  choose wisely.
  308.  
  309. --- PAGE 7 -----------------< IceZmodem Functions >--------------------------
  310.  
  311.  Alt-A - Abort File Transfer
  312.  """""""""""""""""""""""""""
  313.     This will abort the file transfer and return an Exit Code of 1.
  314.  
  315.  F1 - Main Screen
  316.  """"""""""""""""
  317.     The main screen is the heart of IceZmodem. Here you will see how the
  318.     transfer is progressing by the numerous indicators and graphs.
  319.  
  320.   Download/Upload Status Window
  321.   """""""""""""""""""""""""""""
  322.     Block Size - This is the number of bytes that are transferred before a
  323.                  checksum takes place. The greater this number, the more
  324.                  efficient the transfer will be. IceZmodem uses 2048 byte
  325.                  blocks when connected to another IceZmodem. Standard Zmodem
  326.                  uses 1024 byte blocks.
  327.            CPS - This stands for characters per second. Use this to determine
  328.                  how efficient your transfer is going. (2400 bps = 240 cps)
  329.     TurboTrans - This tells wether TurboTrans is in use or not. (See page 10)
  330.       Messages - Information about the transfers progress and remote user
  331.                  status appears here.
  332.     Completion - A graph and a percentage that tells how complete the file
  333.                  transfer is.
  334.         Method - Usually CRC-32 or CRC-16. Tells what method of CRC is being
  335.                  used to check each block. The CRC-32 method is the best.
  336.     Efficiency - A percentage that will tell how efficient the transfer is
  337.                  going. 98% is the highest ever obtained with IceZmodem. You
  338.                  can NEVER get 100% efficiency with ANY protocol due to the
  339.                  overhead that it adds.
  340.     Time Total - IceZmodem analyzes the rate of characters comming in to the
  341.                  computer to predict the total time of the transfer, giving
  342.                  IceZmodem the most accurate total time prediction of any
  343.                  protocol.
  344.  
  345.     Batch Status Window - This window contains the same as above with the
  346.                           exception that the Batch is the information on
  347.                           all the files you are transferring if you are
  348.                           transferring multiple files.
  349.  
  350.       User Status Window
  351.       """"""""""""""""""
  352.          User - The name of the person who is operating the IceZmodem
  353.          Regs - Their registration name (if registered)
  354.          Vers - The version of Zmodem or IceZmodem being used
  355.  
  356.  F2 - Chat
  357.  """""""""
  358.      You may chat with the remote user on this screen. If they are not in
  359.      chat, hit F10 to page them. When somebody is paged in IceZmodem, either
  360.      a beeping noise will come out their speaker or (if the page is turned
  361.      off) the border will flash. Once both people are in chat, just type a
  362.      sentence and hit enter. The message will appear in the upper window.
  363.  
  364. --- PAGE 8 ------------------------------------------------------------------
  365.  
  366.  F3 - DOS Shell
  367.  """"""""""""""
  368.      Using DOS Shell, you may execute any DOS commands or small programs
  369.      without greatly disturbing the transfer. Whenever you execute a
  370.      command or program in the DOS Shell, the file transfer temporarily
  371.      stops and then resumes when the prompt reappears. Knowing this,
  372.      you can execute small commands like DIR, RENAME, DEL, COPY, etc. and
  373.      the transfer wouldn't be harmed at all. You can load small utility
  374.      programs as well providing you dont remain in them for too long.
  375.      I wouldn't recommend staying in any executable file for more than
  376.      20-30 seconds. Especially if you are paying for long distance charges.
  377.  
  378.      Be careful when loading programs if a MOD file is playing. Some programs
  379.      may not like the MOD player. The music will continue to play even when
  380.      you are in a program in DOS Shell.
  381.  
  382.  F4 - Screen Saver
  383.  """""""""""""""""
  384.      This will completely blank out the monitor. To exit it, press F1.
  385.  
  386.  F5 - Text Editor
  387.  """"""""""""""""
  388.      This is a simple text editor that I threw in at the last minute to see
  389.      if it could be done. There are some bugs in the text editor and I am
  390.      going to completely re-write the text editor for a future version.
  391.      Select a file to load. If you wish to create a new file, hit T and then
  392.      type in a filename. If you get an error message, refer to Appendix C.
  393.      The text editor can currently only load files 64k or less. The file must
  394.      not contain more than 78 characters per line. When you are done editing
  395.      the file, hit F9 to save it. If you dont want to save it, hit F8 to
  396.      unload the text file. You must either save or unload the text file
  397.      before IceZmodem will exit when the transfer is complete.
  398.  
  399.  F6 - Module Player
  400.  """"""""""""""""""
  401.      The Module Player will play Amiga Digital MOD music files. These should
  402.      be available on one of your local BBSs or any information service. They
  403.      are quite popular on many platforms these days, especially on the PC.
  404.      You may play the files using a PC Speaker, a D/A converter, a Sound
  405.      Blaster, or a Disney Sound Source. The PC Speaker provides very poor
  406.      sound reproduction and some sort of additional hardware is required to
  407.      hear true high fidelity sound. Assuming you have enough memory and you
  408.      have correctly configured your sound device and sampling rate in
  409.      IZMSETUP, you will now be able to select a file to play. If you get an
  410.      error message, refer to Appendix C. You may adjust the MOD volume, turn
  411.      channels 1,2,3,4 on and off and skip forward/backward in the song while
  412.      it is playing. You can go to any of the other functions in IceZmodem
  413.      and the MOD will continue playing (the sound will stop during screen
  414.      changes) including DOS Shell, text editor and Chat. The speed may get
  415.      messed up during screen changes, if so it should correct itself on the
  416.      next track. The MOD Player may not work with LANtastic software or other
  417.      Local Area Network Operating Systems.
  418.  
  419.  F7 - System Information
  420.  """""""""""""""""""""""
  421.      This will present a page of system information about the local and
  422.      remote computers. Find out what kind of computer that guy REALLY is
  423.      using. Great for technical inspections and online support. This
  424.      section will be expanded in the next version of IceZmodem.
  425.  
  426. --- PAGE 9 --------------------< TurboTrans >--------------------------------
  427.  
  428.   TurboTrans is a Zmodem speed booster which will enhance the efficiency of
  429.   your file transfer from 2 to 4 percent over standard Zmodem. It does this
  430.   by eliminating a 'feature' built into the original Zmodem standard. This
  431.   feature will not allow certain characters to flow through to avoid problems
  432.   with packet switching networks. These illegal characters must be sent as
  433.   TWO legal characters. This adds a decent amount of overhead to the file
  434.   transfer. When two IceZmodems are connected together they will usually be
  435.   connected by a direct modem connection, not a packet switching network.
  436.   Knowing this, IceZmodem will allow all but 2 characters to be sent through
  437.   as one character.
  438.  
  439. -------------------------------< Handshaking >--------------------------------
  440.  
  441.   There are thousands of different types of PCs out there, and along with
  442.   that, there are thousands of different speeds of PCs. Speed is dependant
  443.   on not only the processor and computer architecture, but also the software
  444.   that is running. For example, a memory manager slows down the speed of your
  445.   PC by a noticeable factor. Because modems allow us to hook faster PCs up
  446.   to slower ones, we need some way to let the slower PCs tell the faster
  447.   ones that they are sending data too fast for them to handle. That is
  448.   basically what Handshaking is. If the receiver cannot receive data as
  449.   fast as the sender is sending it, it has to tell the receiver to stop.
  450.   Handshaking is needed on ALL modems that run faster than 2400 bps. If
  451.   you use 2400 bps, you don't need to read this (now). If you are using
  452.   9600 bps or faster, you MUST understand handshaking. There are two
  453.   types of handshaking - hardware and software. All modems can use
  454.   software handshaking, but IceZmodem doesn't because it is inefficient
  455.   and adds overhead to the transfer, so lets ignore that for right now.
  456.   Hardware Handshaking. Most high speed modems transmit the CTS/RTS
  457.   (clear to send/request to send) signal on the phone line along with the
  458.   data that is being transmitted/received.  IceZmodem can manipulate this
  459.   signal to tell the sender to stop sending data when the receiver cannot
  460.   keep up. When the receiver catches up, it will resume the data
  461.   transmission. So, if you are using a high speed modem, BE SURE to set
  462.   HARDWARE HANDSHAKING to on - otherwise you will get a lot of errors
  463.   in the data transmission.
  464.  
  465. -----------------------------< The 16550 UART >-------------------------------
  466.  
  467.   If you are going to use over 9600 bps, I recommend you use a 16550 UART
  468.   chip. This will eliminate a lot of errors and problems you may have down
  469.   the road. You will be able to use over 9600 bps without a 16550, but
  470.   in practice, it is not a good idea - especially on slower computers.
  471.  
  472. -----------------------------< Acknowledgements >-----------------------------
  473.  
  474.  IceZmodem as it is today would not have been possible without the code that
  475.  has been written by 1) the person who wrote the Source Code for Pascal
  476.  Zmodem. There was no author listed in the public domain code. 2) Mark J. Cox
  477.  who wrote the module playing routines. 3) Chuck Forsberg who developed the
  478.  original Zmodem protocol which is pretty much the standard protocol for
  479.  file transfers now.
  480.  
  481.  I would like to thank all Beta testers, including Jim Nunn and Mark
  482.  Niedziela. And for support from God, Mom, and all IceZmodem users who
  483.  support this product.
  484.  
  485. --- PAGE 10 ----------< Appendix A: Setting up IceZmodem >-------------------
  486.  
  487.   Setting up IceZmodem with Telemate
  488.   """"""""""""""""""""""""""""""""""
  489.      Hit Alt-O and then hit E for the external protocol menu.  Hit the down 
  490.      arrow until you reach an empty protocol name slot. 
  491.                      
  492.                      Type in IceZmodem for the name. 
  493.                      For key, use the letter I. 
  494.                      For upload batch, enter IZM-U
  495.                      For download batch, enter IZM-D
  496.                      Hit the down arrow twice, 
  497.                      For auto-download sequence, enter *^XB00 and hit ENTER.
  498.  
  499.      Get out of the external protocol menu and hit P to enter the Protocol
  500.      menu. Make sure the Zmodem Auto-Download does not have an X next to it.
  501.      If it does, remove the X. Get out of the Protocol menu and hit G for
  502.      general options. To get the most out of IceZmodem, make sure that
  503.      Maximum DOS Shell and Swap to Disk both have X's next to them. Exit
  504.      that menu and select "Save Options". Now copy IZM.EXE and IZMSETUP.EXE 
  505.      into your Telemate Directory.
  506.       
  507.      Copy the files IZM-U.BAT and IZM-D.BAT into your Telemate Directory.
  508.     Be sure to edit the IZM-D.BAT to specify the proper download directory.
  509.  
  510.  
  511.   Setting up IceZmodem with Qmodem
  512.   """"""""""""""""""""""""""""""""
  513.      Hit Alt-N or load QINSTALL.EXE. Hit P and press the down arrow till you
  514.      reach an empty protocol slot and hit enter.
  515.  
  516.            For Select Character, type in I
  517.            For Protocol, type in IceZmodem
  518.            For Upload Batch, type in IZM-U
  519.            For Download Batch, type in IZM-D
  520.            For Filename Prompt, type in N
  521.  
  522.       Get out of that menu and go to the Toggles option (still in the  
  523.       Protocol menu). Ensure that Zmodem AutoStart is off. Go back up to the 
  524.       menu bar and go to the Options menu. From that menu, select Runtime 
  525.       Parms. Make sure that Optimum Shell and Disk Shell are turned on. Exit 
  526.       Qinstall with the Save Changes option.
  527.  
  528.        Copy the files IZM-U.BAT and IZM-D.BAT into your Qmodem Directory.
  529.     Be sure to edit the IZM-D.BAT to specify the proper download directory.
  530.  
  531. --- PAGE 11 -----------------------------------------------------------------
  532.  
  533.   Setting up IceZmodem with Telix
  534.   """""""""""""""""""""""""""""""
  535.      Hit Alt-O and then P for Protocol Options. Hit A,B,C, or D to pick a
  536.      slot for IceZmodem - whichever is empty.  
  537.      
  538.                          For key, type in I
  539.                          For protocol name, type in IceZmodem
  540.                          For upload filename, type in IZM-U
  541.                          For download filename, type in IZM-D
  542.                          For batch or script, select Batch File
  543.                          Prompt for name on downloads, No.
  544.      
  545.      Exit the Protocol Options menu and go into the Terminal Options menu.
  546.      Hit N to turn Zmodem Auto-Downloads off. Select Write Setup to Disk.
  547.  
  548.        Copy the files IZM-U.BAT and IZM-D.BAT into your Telix Directory.
  549.     Be sure to edit the IZM-D.BAT to specify the proper download directory.
  550.  
  551.   Setting up IceZmodem with a WWIV BBS
  552.   """"""""""""""""""""""""""""""""""""
  553.      In INIT, hit 7 for external protocols. Hit I for insert. Enter a
  554.      number where you want to insert it.
  555.  
  556.        Description.....: IceZmodem
  557.        Xfer Ok.........: 0
  558.        Require MNP/LAPM: N
  559.        Receive Line....: IZM port %2 speed %1 rz %3
  560.        Send Line.......: IZM port %2 speed %1 sz %3
  561.        Receive Batch...: IZM port %2 speed %1 rz
  562.        Send Batch......: IZM port %2 speed %1 sz @%3
  563.  
  564.      To get the most memory out of a WWIV BBS, you must be using v4.24
  565.      or later. This version supports a shrink feature. Load up WWIV.INI
  566.      and search for SPAWNOPT[PROT_SINGLE]  =NONE
  567.  
  568.                          change it to:
  569.  
  570.                 SPAWNOPT[PROT_SINGLE]  =SHRINK, FILES
  571.  
  572.  
  573. -----------------------< Appendix B: Freeing your Memory >--------------------
  574.  
  575.     First of all, if you dont have at least 400k of free memory when you
  576.     start up IceZmodem, your terminal program or BBS program is chewing up
  577.     all your memory. To get around this, set your terminal program or BBS
  578.     program to 'Maximum DOS Shell' or 'Shrink BBS' or 'Swap to Disk/EMS' or 
  579.     something to that effect. If your Terminal Program/BBS doesn't support a 
  580.     shrink feature, tell the author to include one. Most BBS and terminal
  581.     programs have one nowadays anyway.
  582.  
  583. --- PAGE 12 -----------< Appendix C: Error Messages >------------------------
  584.  
  585. Error 45    This error means you are trying to tell IceZmodem to use both a
  586. """"""""    standard and a nonstandard COM port. You are probably using the
  587. PORT option on the command line when you already have an IRQ and ADDRESS set
  588. up in IZMSETUP. To get around this, set up a standard port in IZMSETUP and
  589. use the IRQADDR option on the command line. Another cause of this problem
  590. is trying to use the PORT and IRQADDR options at the same time.
  591.  
  592. Cannot load file. The file size is greater than 64k!
  593. """"""""""""""""""""""""""""""""""""""""""""""""""""
  594. The text editor is currently limited to editing files 64k or less. This will
  595. be corrected in a future version of IceZmodem.
  596.  
  597. Cannot load file. Line length is greater than 78 characters!
  598. """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""
  599. The text editor is currently limited to editing files with a line length of
  600. 78 characters or less. This will be corrected in a future version of
  601. IceZmodem.
  602.  
  603. You have reached the maximum text file size. No more data may be added!
  604. """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
  605. You are attempting to add more than 64k of data to a large text file.
  606.  
  607. Not a valid ASCII text file!
  608. """"""""""""""""""""""""""""
  609. The text file cannot be parsed as a standard text file would. Either it is
  610. too intricate or it is not a text file.
  611.  
  612. Cannot LOAD or CREATE the filename you have specified!
  613. """"""""""""""""""""""""""""""""""""""""""""""""""""""
  614. An invalid filename has been specified. You may have accidentally typed in
  615. a pathname instead of a filename.
  616.  
  617. Not enough memory to load file
  618. """"""""""""""""""""""""""""""
  619. You must free up some memory by closing an open text file or turn off a MOD
  620. file. If nothing is open, then refer to Appendix B - suggestions for gaining
  621. more free memory.
  622.  
  623. Not enough memory to shell out to DOS!
  624. """"""""""""""""""""""""""""""""""""""
  625. You must free up some memory by closing an open text file or turn off a MOD
  626. file. If nothing is open, then refer to Appendix B - suggestions for gaining
  627. more free memory.
  628.  
  629. Not a 31 instrument MOD file!
  630. """""""""""""""""""""""""""""
  631. The MOD file that you are trying to load either 1) doesn't exist, 2) is not
  632. a MOD music file, or more commonly 3) Is an older 15 instrument MOD. If you
  633. run across a 15 instrument MOD, you will need to convert it to a newer 31
  634. channel MOD before it can be played with IceZmodem. This can be done very
  635. easily with the program MODEDIT by Norman Lin. Simply load the MOD into this
  636. program (as if you were going to modify it) and then save it. The resulting
  637. save will be a 31 channel version of your older 15 channel MOD.
  638.  
  639. --- PAGE 13 --------------< Command Line Examples >--------------------------
  640.  
  641.  
  642. IZM RZ  - Will open the COM port specified in IZMSETUP at the baud rate that
  643.           the port is currently at. It will then receive files and put them
  644.           in the current directory.
  645.  
  646. IZM port 1 speed 2400 RZ c:\downloads - Will open COM1 at 2400 baud and
  647.                                         receive files into the directory
  648.                                         C:\DOWNLOADS.
  649.  
  650. IZM port 2 SZ F.TXT F2.EXE C.COM - Opens COM2 at the current baud rate and
  651.                                    sends F.TXT, F2.EXE, and C.COM.
  652.  
  653. IZM SZ @FILE.LST - Opens the COM port specified in IZMSETUP at the current
  654.                    baud rate. It then opens the file called FILE.LST and
  655.                    reads the path/filenames stored within and proceeds to
  656.                    send all files.
  657.  
  658. IZM port 3 speed 9600 SZ *.EXE - Opens COM3 at 9600 baud and transmits all
  659.                                  the files ending with EXE.
  660.  
  661. IZM adrirq 3e8,2 RZ - Opens a nonstandard port located at address 3E8(hex)
  662.                       using IRQ 2. It then receives files into the current
  663.                       directoy.
  664.  
  665. IZM port 2 speed 57600 flow hard SZ C:\UPLOADS\START???.EXE - Opens COM2 at
  666.              57600 baud and turns hardware handshaking on. It will then send
  667.              all EXE files files in the directory C:\UPLOADS that begin with
  668.              START.
  669.  
  670. -----------------------< Appendix E: Revision History >-----------------------
  671.  
  672.  6/1/1994 -- Version Beta1 -- First public Beta Test Release
  673.  
  674.