home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / comm / simtm20c.zip / SIMTERM.DOC < prev    next >
Text File  |  1990-10-08  |  58KB  |  1,321 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.                                   S I M T E R M
  23.  
  24.                                 Operations Manual
  25.  
  26.                              Copyright (c) 1989,1990
  27.                                 by Jason R. Alward
  28.  
  29.                                All Rights Reserved
  30.  
  31.  
  32.                           For product support, contact:
  33.  
  34.                                  Jason R. Alward
  35.                             129 Concession St. E. #22
  36.                                Tillsonburg, Ontario
  37.                                   Canada  N4G4N4
  38.                                   (519)-842-9175
  39.  
  40.                                  By modem, call:
  41.  
  42.                              RHPN BBS (519)-688-0008
  43.                                  300 to 2400 baud
  44.                                   24 hours a day
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.                                                                    Page   1
  70.  
  71.  
  72.  
  73.                                 TABLE OF CONTENTS
  74.                                 -----------------
  75.  
  76.  
  77.  
  78.  
  79.         1. INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . .   2
  80.              Overview . . . . . . . . . . . . . . . . . . . . . . . . .   2
  81.              Features . . . . . . . . . . . . . . . . . . . . . . . . .   2
  82.              Licensing and Distribution . . . . . . . . . . . . . . . .   3
  83.  
  84.         2. GETTING STARTED  . . . . . . . . . . . . . . . . . . . . . .   4
  85.              System Requirements  . . . . . . . . . . . . . . . . . . .   4
  86.              Installation . . . . . . . . . . . . . . . . . . . . . . .   4
  87.              Starting Simterm . . . . . . . . . . . . . . . . . . . . .   5
  88.              Configuring Simterm  . . . . . . . . . . . . . . . . . . .   5
  89.  
  90.         3. USING SIMTERM  . . . . . . . . . . . . . . . . . . . . . . .   9
  91.              Using the Menus  . . . . . . . . . . . . . . . . . . . . .   9
  92.              The Input Editor . . . . . . . . . . . . . . . . . . . . .   9
  93.              The Help Menu  . . . . . . . . . . . . . . . . . . . . . .  10
  94.              The Status Line  . . . . . . . . . . . . . . . . . . . . .  10
  95.              Simterm's Functions  . . . . . . . . . . . . . . . . . . .  11
  96.                 Files . . . . . . . . . . . . . . . . . . . . . . . . .  11
  97.                 Path  . . . . . . . . . . . . . . . . . . . . . . . . .  11
  98.                 Shell . . . . . . . . . . . . . . . . . . . . . . . . .  11
  99.                 Exit  . . . . . . . . . . . . . . . . . . . . . . . . .  12
  100.                 Dial  . . . . . . . . . . . . . . . . . . . . . . . . .  12
  101.                 Buffer  . . . . . . . . . . . . . . . . . . . . . . . .  13
  102.                 Hangup  . . . . . . . . . . . . . . . . . . . . . . . .  14
  103.                 Download & Upload . . . . . . . . . . . . . . . . . . .  14
  104.                 Echo & Linefeeds  . . . . . . . . . . . . . . . . . . .  15
  105.                 Initialize  . . . . . . . . . . . . . . . . . . . . . .  15
  106.                 Clear . . . . . . . . . . . . . . . . . . . . . . . . .  15
  107.                 Options . . . . . . . . . . . . . . . . . . . . . . . .  15
  108.              Send BREAK Signal (Ctrl-@) . . . . . . . . . . . . . . . .  15
  109.  
  110.         4. FILE TRANSFERS & PROTOCOLS . . . . . . . . . . . . . . . . .  16
  111.              What is a File Transfer  . . . . . . . . . . . . . . . . .  16
  112.              Supported Protocols  . . . . . . . . . . . . . . . . . . .  16
  113.                 Ascii . . . . . . . . . . . . . . . . . . . . . . . . .  16
  114.                 Xmodem  . . . . . . . . . . . . . . . . . . . . . . . .  17
  115.                 1k-Xmodem . . . . . . . . . . . . . . . . . . . . . . .  17
  116.                 Ymodem (batch)  . . . . . . . . . . . . . . . . . . . .  17
  117.                 Zmodem  . . . . . . . . . . . . . . . . . . . . . . . .  18
  118.              Special Zmodem Features  . . . . . . . . . . . . . . . . .  18
  119.  
  120.         REGISTERING SIMTERM . . . . . . . . . . . . . . . . . . . . . .  19
  121.         WARRANTY  . . . . . . . . . . . . . . . . . . . . . . . . . . .  19
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.               Simterm 2.0 Copyright (c) 1989,1990 - Jason R. Alward
  131.  
  132.  
  133.  
  134.  
  135.                                                                    Page   2
  136.  
  137.                                    INTRODUCTION
  138.                                     Chapter 1
  139.  
  140.  
  141.  
  142.  
  143.  
  144.         OVERVIEW
  145.  
  146.  
  147.         Have you ever wished you could find a communications program that
  148.         wasn't a 150-300k program requiring a hard disk to run efficiently?
  149.         One small enough to run in a DOS shell from a large application
  150.         without being totally stripped of essential features?
  151.  
  152.         Simterm was written to fill this need.  Requiring about 40k of disk
  153.         space, it easily fits on a bootable floppy leaving room to download
  154.         files even 200k in size.  Read the list of features below and
  155.         you'll see, Simterm is far from a "gutted" terminal.
  156.  
  157.  
  158.  
  159.         FEATURES
  160.  
  161.  
  162.             ~ Menu driven and very easy to use.
  163.             ~ Alt-key shortcuts to major functions for quicker access.
  164.             ~ Only requires about 66k of free memory to run.
  165.             ~ Uses no overlay files.
  166.             ~ Dialing directory loaded into RAM for faster access.
  167.             ~ Support for ANSI display codes built in.
  168.             ~ Handles speeds up to 19200 baud.
  169.             ~ Supports COM1 through COM4.
  170.             ~ Dialing directory holds 45 entries and supports auto redial,
  171.               tagging, auto dial of tagged entries, and auto untagging of
  172.               entries connected to.
  173.             ~ COM settings and default transfer protocol for each system
  174.               you call stored in dialing directory.
  175.             ~ Variable dial time and pause between dial attempts.
  176.             ~ Capture file buffering with ANSI codes stripped.
  177.             ~ Wide directory listing with automatic page pausing.
  178.             ~ Can issue a DOS command or drop to a DOS shell.
  179.             ~ Five transfer protocols supported for uploads/downloads:
  180.               Ascii, Xmodem, 1k-Xmodem, Ymodem (batch), and Zmodem.
  181.             ~ Zmodem resume aborted or crashed transfers and auto Zmodem
  182.               downloads supported.
  183.             ~ Local Echo and Add Linefeeds supported.
  184.             ~ All display colours can be customized to your liking.
  185.             ~ Status line displays buffer, echo, and linefeed status as
  186.               well as current COM settings, connection status and time
  187.               elapsed since connection.
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.               Simterm 2.0 Copyright (c) 1989,1990 - Jason R. Alward
  197.  
  198.  
  199.  
  200.  
  201.                                                                    Page   3
  202.  
  203.         LICENSING AND DISTRIBUTION
  204.  
  205.         Simterm is not, nor has it ever been, free software.  It is
  206.         copyright and is distributed as SHAREWARE.  You are granted a
  207.         limited license to use Simterm for an evaluation period, not to
  208.         exceed 30 days.  Use of Simterm beyond the evaluation period
  209.         requires registration.
  210.  
  211.         Upon registering Simterm, you will receive a disk containing the
  212.         latest version and you will be entitled to product support.  See
  213.         the chapter on Registering Simterm at the end of this manual for
  214.         complete details on how to register your copy of Simterm.
  215.  
  216.         You may give copies of Simterm to others for their evaluation so
  217.         long as no fee is charged for the copy.  Simterm may also be posted
  218.         on electronic bulletin board systems (BBS's) as long as no fee is
  219.         charged to access Simterm beyond subscription or online time fees
  220.         normally charged for access to the BBS.
  221.  
  222.         Those copying, sharing, and/or electronically transmitting Simterm
  223.         may not delete, add, or in any way modify any of the files in the
  224.         Simterm package.  Simterm must be distributed in it's entirety,
  225.         complete with documentation.  Anyone not adhering to these
  226.         conditions is in direct violation of copyright law.
  227.  
  228.         Distributors of shareware and/or public domain software must obtain
  229.         written authorization before distributing copies of Simterm.  No
  230.         one may use Simterm in a promotion for any commercial venture or as
  231.         an enticement for the user to pay for any program, product, or
  232.         service without having received the express written permission of
  233.         the program's author.
  234.  
  235.         In order to distribute Simterm, a shareware vendor must comply with
  236.         the following conditions:
  237.  
  238.             1.  Vendors must obtain written permission from Jason R. Alward
  239.                 before distributing Simterm.  If no reply is received,
  240.                 write again.  You may not distribute copies "pending"
  241.                 receipt of permission.
  242.  
  243.             2.  Vendors may not modify or delete any of the files in the
  244.                 Simterm package.  A reasonable number of small text or
  245.                 batch files may be added if designed to provide a service
  246.                 to the user, but they must be easily identifiable and the
  247.                 user must be allowed to delete these added files.
  248.  
  249.             3.  Vendors must make a reasonable effort to distribute only
  250.                 the most recent version of Simterm.  If you have received
  251.                 written permission to distribute Simterm, you will be
  252.                 notified of updates when they are released.
  253.  
  254.             4.  A maximum disk fee, set in the vendor contract, must not
  255.                 be exceeded.  Simterm may not be included in any package
  256.                 sold for more than this maximum.
  257.  
  258.  
  259.  
  260.  
  261.  
  262.               Simterm 2.0 Copyright (c) 1989,1990 - Jason R. Alward
  263.  
  264.  
  265.  
  266.  
  267.                                                                    Page   4
  268.  
  269.                                  GETTING STARTED
  270.                                     Chapter 2
  271.  
  272.  
  273.         SYSTEM REQUIREMENTS
  274.  
  275.         IBM PC/XT/AT or true compatible computer running DOS v2.0 or above.
  276.         One floppy disk drive, a Hayes compatible modem, and 256k of RAM.
  277.  
  278.         NOTE: Simterm actually requires about 66k of free RAM to run.  If
  279.         you have less than 256k in your system, try running Simterm anyway,
  280.         it just might fit.  Of course you can't use the Shell command when
  281.         memory is that restricted.
  282.  
  283.  
  284.         INSTALLATION
  285.  
  286.         Installing Simterm requires two steps.  First, you simply copy the
  287.         file SIMTERM.EXE to the disk or directory where you will be using
  288.         it.  Simterm uses no overlay files and creates the data files it
  289.         needs when you first run it, so you only need the one file.
  290.  
  291.         The next step is to make sure Simterm can find those data files
  292.         each time you use it.  If you're using Simterm on a floppy based
  293.         system, this is not a problem since you will have to insert the
  294.         disk containing Simterm and it's files in order to run it.  You can
  295.         remove the Simterm disk after it starts up but you must reinsert
  296.         the disk when you make changes in the dialing directory or save
  297.         changes from the configuration menu.  The dialing directory is a
  298.         special case as it only updates the file when you leave the
  299.         directory menu.  This occurs when you press ESC or when you connect
  300.         to an online service after dialing, so the Simterm disk must be in
  301.         the drive at these times IF you have edited any entries.
  302.  
  303.         If you're using Simterm on a hard drive you'll need to know more
  304.         about how Simterm finds it's data files.  The first step Simterm
  305.         takes is to check the DOS version number.  If it finds version 3.x
  306.         then it will get a complete pathname from DOS, you don't have to do
  307.         a thing.  If it finds DOS version 2.x it will search the
  308.         environment for a variable named SIMTERM.  In this case you should
  309.         add a line to your AUTOEXEC.BAT file as follows:
  310.  
  311.         SET SIMTERM=C:\SIMTERM\
  312.  
  313.         You should of course place your own drive:\path\ specification
  314.         after the "SIMTERM=" but it must end with the "\" backslash.
  315.  
  316.         If Simterm doesn't find the SIMTERM variable it will use the
  317.         current directory to build a path to it's files.  This is the least
  318.         desirable method since Simterm will create new files all over your
  319.         hard drive if you don't change to it's directory every time you use
  320.         it.  Another minus is that these new files will contain default
  321.         information and the dialing directory will be blank.
  322.  
  323.         As you can see, if you're using DOS version 2.x it is desirable to
  324.         set the SIMTERM variable.  Doing this in your AUTOEXEC.BAT means
  325.         you need only do it once and don't have to bother with it again.
  326.  
  327.  
  328.               Simterm 2.0 Copyright (c) 1989,1990 - Jason R. Alward
  329.  
  330.  
  331.  
  332.  
  333.                                                                    Page   5
  334.  
  335.         STARTING SIMTERM
  336.  
  337.         To start Simterm simply change to the disk/directory where you put
  338.         the program and type:
  339.  
  340.         SIMTERM
  341.  
  342.         followed by pressing the ENTER key.
  343.  
  344.         The first time you run Simterm it will create a configuration file
  345.         called SIMTERM.CFG and a dialing directory file called SIMTERM.PHN.
  346.         These will be filled with default information.  Simterm will then
  347.         place you in the Configuration Options menu and place a message at
  348.         the top of the screen prompting you to configure Simterm for your
  349.         system and press "S" to save.  You may need to change some of
  350.         Simterm's defaults for it to work with your system (See the
  351.         Configuring Simterm section below).  When you've got Simterm
  352.         properly configured, press the "S" key to save your changes, and
  353.         you're ready to go.  The next time you run Simterm, it will get
  354.         it's settings from the configuration file so you won't have to go
  355.         through this again.
  356.  
  357.  
  358.         CONFIGURING SIMTERM
  359.  
  360.         The first step in configuring Simterm is to make sure your modem is
  361.         configured so Simterm can work with it.  Simterm expects the modem
  362.         to treat status signals as their true state and not force them on
  363.         or off.  The most important of these are the Carrier Detect (CD)
  364.         and Data Terminal Ready (DTR) lines.  Many modems default to a
  365.         forced carrier and ignore DTR so you must configure your modem to
  366.         use the actual state of these signals.  Some modems use DIP
  367.         switches to control these settings and some use commands (such as
  368.         AT &C1 for true carrier and AT &D2 for hangup on DTR low). You will
  369.         have to consult your modem's manual for the exact method used to
  370.         make your settings but the results you want are:
  371.  
  372.         The Carrier Detect (CD) should reflect the actual state of the
  373.         carrier signal.
  374.         The modem should go on-hook on an On-to-Off transition of the DTR.
  375.         (When Simterm drops the DTR signal you want the modem to hangup)
  376.  
  377.         Next you will need to configure Simterm to work with the rest of
  378.         your system.  Simterm's configuration is completely menu driven and
  379.         you can exit the Options menu by either pressing the "S" key to
  380.         make your changes the new start up defaults, or by pressing the ESC
  381.         key to keep your changes for the current session without changing
  382.         the defaults stored on disk.  When you issue the Alt-O (Options)
  383.         command, or when running Simterm for the first time, you will see a
  384.         menu that looks something like the following:
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.               Simterm 2.0 Copyright (c) 1989,1990 - Jason R. Alward
  395.  
  396.  
  397.  
  398.  
  399.                                                                    Page   6
  400.  
  401.               +->Current Configuration<---------------------------+
  402.               : Com Port: COM1                                    :
  403.               : Baud: 2400                                        :
  404.               : Data Bits: 8                                      :
  405.               : Parity: NONE                                      :
  406.               : Stop Bits: 1                                      :
  407.               : Modem Initialization: AT S0=0 S7=30 E1 V1 Q0 X1^M :
  408.               : Dialing Prefix: AT DT                             :
  409.               : Dial Cancel: ^M                                   :
  410.               : Dial Wait Time: 30                                :
  411.               : Pause Between Dials: 5                            :
  412.               : Local Echo: OFF                                   :
  413.               : Add Linefeeds: OFF                                :
  414.               : Snow Checks: OFF                                  :
  415.               : File & Colour Options                             :
  416.               +---------------------------------------------------+
  417.  
  418.         Use the arrow keys to move the menu select bar to the item you wish
  419.         to change and press the ENTER key.  You will then be able to enter
  420.         the new setting either by selecting it from a menu or typing the
  421.         new value.  A description of each setting, and the range of
  422.         possible settings, where applicable, follows.
  423.  
  424.         The Com Port setting tells Simterm which serial port your modem is
  425.         connected to.  Simterm supports serial ports COM1 through COM4.
  426.  
  427.         NOTE: If you have an internal modem, the serial port is built into
  428.         the modem itself.  You'll have to check the modem's manual to see
  429.         which port it's configured for.
  430.  
  431.         The Baud setting should be set to the maximum speed your modem is
  432.         capable of, in order to send the initialization string out as
  433.         quickly as possible.  Supported speeds are: 300, 1200, 2400, 4800,
  434.         9600, and 19200 baud.
  435.  
  436.         The Data Bits, Parity, and Stop Bits settings should be configured
  437.         for the settings you most commonly use.  Most IBM compatible based
  438.         BBS's use 8 Data bits, No Parity, and 1 Stop bit, which is what
  439.         Simterm defaults to, so this would be a good choice for start up.
  440.         The supported settings for these are:
  441.  
  442.         Data Bits: 7 or 8
  443.         Parity: NONE, ODD, EVEN, MARK and SPACE
  444.         Stop Bits: 1 or 2
  445.  
  446.         The Modem Initialization setting is simply a string of modem
  447.         commands that you want Simterm to send to your modem at start up.
  448.         This just guarantees that the modem will be configured the same way
  449.         every time you start Simterm.  The default string is:
  450.  
  451.         AT S0=0 S7=30 E1 V1 Q0 X1^M
  452.  
  453.         These are commands from the Hayes modem command set.  You should
  454.         consult your modem's manual for the complete set of commands it
  455.         recognizes and the function of each.  From this you can decide what
  456.         is needed in your initialization string.
  457.  
  458.  
  459.  
  460.               Simterm 2.0 Copyright (c) 1989,1990 - Jason R. Alward
  461.  
  462.  
  463.  
  464.  
  465.                                                                    Page   7
  466.  
  467.         NOTE: The ending "^M" is not a modem command but Simterm control
  468.         code notation.  You can insert control codes into your string by
  469.         preceding the control character you want with a caret (^)
  470.         character.  For example, a backspace is control-H so you would type
  471.         a caret immediately followed by an H like this: ^H.  This is what
  472.         you must do to end your initialization string with a carriage
  473.         return, which is control-M or ^M, as Simterm does not append a
  474.         carriage return to this string.  You can only use this control code
  475.         notation in certain items, which will display a message at the
  476.         bottom of the menu to inform you.  See the section on The Input
  477.         Editor for further details.
  478.  
  479.         The Dialing Prefix setting is a short string that is sent to the
  480.         modem just before the number to be dialed is sent.  It's function
  481.         is to tell the modem to dial the following number and wait for a
  482.         connection.  Simterm defaults to "AT DT" for the prefix which tells
  483.         the modem to use touch tone dialing.  If you have pulse dialing in
  484.         your area you would need to change the prefix to use this dialing
  485.         method.  The appropriate Hayes command would be "AT DP".
  486.  
  487.         The Dial Cancel setting is a string that is sent to the modem when
  488.         you tell Simterm to interrupt a dialing operation.  It defaults to
  489.         "^M", a carriage return, which is all that is needed for most
  490.         modems.
  491.  
  492.         Again, consult your modem's manual for the exact commands it uses
  493.         for these operations.
  494.  
  495.         The Dial Wait Time setting specifies the number of seconds Simterm
  496.         will wait for some response from the modem after sending the
  497.         command to dial.  If this time elapses without Simterm receiving
  498.         any response, Simterm will terminate the dialing operation with the
  499.         Dial Cancel string.
  500.  
  501.         The Pause Between Dials setting specifies the number of seconds
  502.         Simterm will wait before making another dial attempt when no
  503.         connection was established on the last attempt.  For further
  504.         details on dialing operations, see the section on the Dial function
  505.         later in this manual.
  506.  
  507.         The Local Echo setting tells Simterm to send characters typed in
  508.         terminal mode to the screen as well as the com port.  This is
  509.         useful if you connect to a lot of systems that don't echo your
  510.         input back to you although most BBS's do.
  511.  
  512.         This setting can be either ON or OFF and is just toggled when you
  513.         press ENTER.
  514.  
  515.         The Add Linefeeds setting tells Simterm to send a linefeed to the
  516.         screen after every carriage return it sends to the screen.  This is
  517.         used if you connect to a lot of systems that send carriage returns
  518.         only, at the end of each line.  Adding linefeeds will prevent each
  519.         successive line from overwriting the previous line.  You will
  520.         probably need to use this option if you're using Local Echo.
  521.  
  522.         Again, this setting, and the Snow Checks setting that follows, can
  523.         be either ON or OFF and is just toggled when you press ENTER.
  524.  
  525.  
  526.               Simterm 2.0 Copyright (c) 1989,1990 - Jason R. Alward
  527.  
  528.  
  529.  
  530.  
  531.                                                                    Page   8
  532.  
  533.         The Snow Checks setting tells Simterm whether or not to monitor the
  534.         horizontal retrace signal from the video card before writing to the
  535.         screen.  Simterm uses direct video memory writes for all screen
  536.         output and on some CGA cards this causes interference on the screen
  537.         referred to as "snow".  If this item is ON, Simterm will only write
  538.         to the screen when the video card is retracing for the next line.
  539.         This means the video card is not accessing the video memory so it
  540.         is safe for Simterm to write to this memory without interfering
  541.         with the video card.  Unfortunately, during a horizontal retrace
  542.         there is only enough time to write one character to the display, so
  543.         snow checking slows down the screen output a bit, but it gives you
  544.         a clear display.
  545.  
  546.         NOTE: This option should be set ONLY if you have a CGA card in your
  547.         system.  Do NOT set this option on monochrome cards.
  548.  
  549.         The File & Colour Options isn't a setting like the other items in
  550.         the menu.  Pressing ENTER on this item takes you to another menu
  551.         where you tell Simterm the default drive:\path\ specifications to
  552.         use in file transfers, and you can customize the colour scheme used
  553.         throughout Simterm.
  554.  
  555.         Customizing the colours Simterm uses is easy.  Just select the item
  556.         you wish to change and press ENTER.  You will be presented with a
  557.         menu of diamond characters, displayed in all the 128 possible
  558.         colour combinations with a box marking the current setting.  Simply
  559.         move the box using the arrow keys, to mark the desired colour
  560.         setting and press ENTER.  Simterm will refresh the display using
  561.         the new colour settings.
  562.  
  563.         You should set the Upload and Download file paths to directories
  564.         where you wish to put files for transfer and receive transferred
  565.         files to respectively.  If you leave these items blank Simterm will
  566.         use the current directory, which may not be desirable.
  567.  
  568.         NOTE: Be sure to end both file path specifications with the
  569.         backslash "\" character.  Simterm just appends the name of the file
  570.         being transferred to the end of these strings, so you'll get
  571.         constant "Invalid Path" errors if the backslash isn't there.
  572.  
  573.         When your finished editing the items in the File & Colour Options
  574.         menu, press the ESC key to return to the Options menu.
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.               Simterm 2.0 Copyright (c) 1989,1990 - Jason R. Alward
  593.  
  594.  
  595.  
  596.  
  597.                                                                    Page   9
  598.  
  599.                                   USING SIMTERM
  600.                                     Chapter 3
  601.  
  602.  
  603.         USING THE MENUS
  604.  
  605.         Using the menus in Simterm is easy.  The arrow keys move the select
  606.         bar and ENTER selects the highlighted item.  In almost all cases,
  607.         the ESC key will get you out of a menu without selecting or
  608.         changing anything.
  609.  
  610.         Most of Simterm's menus are arranged vertically, but some are
  611.         horizontal.  To simplify the way Simterm deals with this, the arrow
  612.         keys have been paired together.  Both the UP and LEFT arrow keys
  613.         perform the same function, as do the RIGHT and DOWN arrow keys.  So
  614.         if you're in a vertical menu, pressing the LEFT arrow would move
  615.         the select bar up just as the UP arrow would.  And if you were in a
  616.         horizontal menu, the UP arrow would move the select bar left just
  617.         as the LEFT arrow would.  The RIGHT and DOWN arrow key interaction
  618.         would be similar.
  619.  
  620.         Simterm's menus also support wrap around.  This means that if the
  621.         select bar were at the bottom of a menu and you pressed the DOWN
  622.         arrow key, the select bar would jump to the top.  This also means
  623.         that when you're in a menu with only two options, any arrow key
  624.         will toggle the select bar between the two.
  625.  
  626.  
  627.         THE INPUT EDITOR
  628.  
  629.         Whenever Simterm needs you to enter or edit a string of text, such
  630.         as the modem initialization string, it uses a built in line editor.
  631.         Within this editor certain keys perform special functions to make
  632.         editing easier.  These keys are as follows:
  633.  
  634.         The LEFT & RIGHT ARROW keys move the cursor within the existing
  635.         string without effecting the text.  This lets you position the
  636.         cursor to the character where you need to start editing.
  637.  
  638.         The HOME key will move the cursor to the beginning of the existing
  639.         string.  Likewise, the END key will move the cursor to the end of
  640.         the string.
  641.  
  642.         The BACKSPACE key will delete the character preceding the cursor
  643.         position and move the cursor back to that position, pulling any
  644.         trailing text back one space with it.
  645.  
  646.         The DELETE key will delete the character at the cursor position and
  647.         pull any trailing text back one space to fill the gap.  The cursor
  648.         position remains the same.
  649.  
  650.         The INSERT key will toggle between insert and overwrite mode.  The
  651.         cursor becomes larger to show when insert mode is on.
  652.  
  653.         Finally, if you press CONTROL-HOME it will erase any existing text
  654.         and let you build your string from scratch.  This is useful when no
  655.         part of the current string can be used to build your new string.
  656.         In a few special cases, Simterm will accept control code notation
  657.  
  658.               Simterm 2.0 Copyright (c) 1989,1990 - Jason R. Alward
  659.  
  660.  
  661.  
  662.  
  663.                                                                    Page  10
  664.  
  665.         within an input string.  An example of this notation is "^M"
  666.         (without the quotes) which will be interpreted as control-M which
  667.         is a carriage return.  Simterm only interprets this notation in
  668.         special cases, for which you will receive a help prompt explaining
  669.         how to use it.  If you try to use them anywhere else, they will be
  670.         treated as a literal string with no interpretation.
  671.  
  672.  
  673.         THE HELP MENU
  674.  
  675.         All Simterm's functions are available via Alt-key shortcuts and the
  676.         Help Menu lists all available functions, their shortcut key, and a
  677.         brief description of their purpose.  You can execute a function
  678.         from this menu by moving the select bar to the desired function and
  679.         pressing ENTER, or you can just press the corresponding shortcut
  680.         key.  There is no need to hold down the Alt key when in the help
  681.         menu as Simterm assumes any key pressed is intended to execute a
  682.         function.  For example, pressing "D" would take you to the Dialing
  683.         Directory but if you were not in the help menu you would need to
  684.         press "D" while holding down the Alt key.  All the functions work
  685.         like this except the file transfers, Upload & Download, which are
  686.         executed by pressing either PG UP or PG DN respectively.
  687.  
  688.  
  689.         THE STATUS LINE
  690.  
  691.         Simterm uses the top line of the screen to display the current
  692.         status of it's capture buffer, echo and linefeeds state, com
  693.         settings, and carrier detect.
  694.  
  695.         The capture buffer status is indicated by "Buffer:" followed by
  696.         it's current status, either ON, OFF, or PAUSE.
  697.  
  698.         The echo and linefeeds status are indicated by "Echo:" and
  699.         "Linefeeds:" respectively and they're followed by either an ON or
  700.         OFF status.
  701.  
  702.         The com settings status simply reflects the current Baud rate, Data
  703.         bits, Parity, and Stop bits that Simterm is currently configured to
  704.         use.  These are displayed as the corresponding numbers except for
  705.         Parity, which is shown as the first letter of the corresponding
  706.         Parity type.
  707.  
  708.         The carrier detect status is indicated by either the word "Offline"
  709.         or "Online".  "Offline" is displayed when no carrier signal is
  710.         detected from the serial port.  "Online" is displayed while a
  711.         carrier signal is present on the serial port and is followed by a
  712.         time indicator which reflects the time elapsed since the carrier
  713.         changed from an off to on status.  The "Online" time is displayed
  714.         as hours:minutes.
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.               Simterm 2.0 Copyright (c) 1989,1990 - Jason R. Alward
  725.  
  726.  
  727.  
  728.  
  729.                                                                    Page  11
  730.  
  731.         SIMTERM'S FUNCTIONS
  732.  
  733.         This section will give a detailed explanation of each of Simterm's
  734.         functions, in the same order they appear in the Help Menu.  This
  735.         section should make a good reference whenever Simterm's prompts and
  736.         help prove inadequate.
  737.  
  738.  
  739.         Files (Alt-F)
  740.  
  741.         The Files function first prompts you to enter the desired path and
  742.         filespec for which you wish to list the files.  It will provide you
  743.         with a string containing the current directory and *.* filespec so
  744.         pressing ENTER will list all files in the current directory.
  745.         Simply edit this string as needed.
  746.  
  747.         Once you have entered the desired filespec and pressed ENTER, the
  748.         Files function will read the directory and display all matching
  749.         files in three columns.  If there are too many files to display in
  750.         one window it will stop and provide you with a "More Y/N" prompt.
  751.         Pressing "Y" at this prompt will clear the window and resume
  752.         displaying files.  if you press "N" at the more prompt (or when
  753.         there are no more matching files) the Files function will display
  754.         the amount of free space on the selected drive and prompt you to
  755.         press any key, which will return you to terminal mode.
  756.  
  757.  
  758.         Path (Alt-P)
  759.  
  760.         The Path function displays the current directory and allows you to
  761.         edit the string.  Pressing ESC leaves things as they were but
  762.         pressing ENTER will cause the Path function to change the current
  763.         directory to the new one you specified.  If the new directory is
  764.         invalid, a message will inform you of this and the current
  765.         directory will remain unchanged.
  766.  
  767.  
  768.         Shell (Alt-S)
  769.  
  770.         The Shell function allows you to execute a DOS command or program
  771.         or drop to a DOS shell.  It first displays a window with a DOS
  772.         prompt to allow you to enter the command or program you wish to
  773.         execute.  When you've entered your command line, pressing ENTER
  774.         causes the Shell function to call COMMAND.COM to execute the
  775.         command or program.  Upon the command or program's completion, you
  776.         will be prompted to press any key, which will return you to
  777.         Simterm.
  778.  
  779.         If you press ENTER alone in the DOS prompt window without typing
  780.         any commands, the Shell function executes COMMAND.COM to drop to a
  781.         DOS shell.  You will see a message informing you that you must use
  782.         the DOS EXIT command to exit the shell and return to Simterm.
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.               Simterm 2.0 Copyright (c) 1989,1990 - Jason R. Alward
  791.  
  792.  
  793.  
  794.  
  795.                                                                    Page  12
  796.  
  797.         Exit (Alt-X)
  798.  
  799.         The Exit function simply prompts you to verify that you want to
  800.         exit Simterm.  Pressing ENTER will exit Simterm and pressing ESC
  801.         aborts the function and returns you to terminal mode.  You could
  802.         also use the arrow keys to select "No" and press Enter to exit.
  803.  
  804.  
  805.         Dial (Alt-D)
  806.  
  807.         The Dial function takes you to the Dialing Directory which is used
  808.         to store and call the BBS's you use.  This directory stores the
  809.         information for 45 BBS's and is displayed in three pages.  The TAB
  810.         key is used to change pages and in the upper right corner of the
  811.         menu is "Page #" where "#" is the number of the page currently
  812.         displayed.
  813.  
  814.         You access the numbers in the directory just like a menu, pressing
  815.         the UP or DOWN arrow keys to move the highlight bar to the desired
  816.         number.  Pressing "E" will open another menu to allow you to edit
  817.         the highlighted number.  The menu will look something like this:
  818.  
  819.                           +---------------------------+
  820.                           : Name:                     :
  821.                           : Phone: 000-0000           :
  822.                           : Baud: 2400                :
  823.                           : Data Bits: 8              :
  824.                           : Parity: NONE              :
  825.                           : Stop Bits: 1              :
  826.                           : Local Echo: Off           :
  827.                           : Add Linefeeds: Off        :
  828.                           : Transfer Protocol: Xmodem :
  829.                           +---------------------------+
  830.  
  831.         Simply select the item you wish to change and press ENTER to change
  832.         the information.  You will get either a cursor to edit a string,
  833.         like the Name or Phone, or a menu from which to select the new
  834.         setting.  When finished editing the information, pressing ESC will
  835.         return you to the Dialing Directory.
  836.  
  837.         Pressing the space bar in the directory will "tag" the highlighted
  838.         number (or "untag" if it has already been "tagged").  Tagging
  839.         allows you to build a list of BBS's that you want Simterm to call
  840.         at one sitting.
  841.  
  842.         Pressing ENTER initiates a dial sequence.  This consists of
  843.         changing the com settings to those in the selected number, sending
  844.         the Dial Prefix string to the modem, sending the Phone string to
  845.         the modem, sending a carriage return to the modem to execute the
  846.         dial operation, and waiting for the number of seconds specified by
  847.         the Dial Wait Time.  At the bottom of the directory window you will
  848.         see, the Name and Phone of the number being dialed, and the
  849.         message: "Waiting for Connection" followed by the remaining seconds
  850.         before the dial is aborted.
  851.  
  852.         While Simterm is waiting, it watches for a carrier signal or a
  853.         string coming in from the modem (eg. BUSY).  If Simterm gets a
  854.         carrier signal, it sets the Echo and Linefeeds settings to those
  855.  
  856.               Simterm 2.0 Copyright (c) 1989,1990 - Jason R. Alward
  857.  
  858.  
  859.  
  860.  
  861.                                                                    Page  13
  862.  
  863.         stored in the selected number, and sets the Transfer Protocol Menu
  864.         to default to the desired setting.  Then it sounds a short alarm
  865.         and exits the Dialing Directory back to terminal mode.
  866.  
  867.         If a string is received, Simterm echoes it after the "Last Status"
  868.         prompt and goes into the pause between dials.  If the time runs out
  869.         Simterm displays "Time Elapsed" as the status and then goes into
  870.         the pause.  The pause simply displays "Pausing" followed by the
  871.         number of seconds remaining before another dial attempt is made.
  872.  
  873.         Simterm will continue to retry the dial until it gets a carrier and
  874.         connects, or you press ESC to abort the operation.
  875.  
  876.         The number that gets dialed when you press ENTER depends on whether
  877.         there are any "tagged" entries or not.  If there are no entries
  878.         tagged, Simterm dials the highlighted number.  If you have tagged
  879.         some numbers, Simterm will start dialing the first tagged entry in
  880.         the directory and continue through each successive tagged entry in
  881.         the list for each dial retry.  In other words, Simterm will dial
  882.         the first tagged entry, and if it doesn't connect, it will try the
  883.         next tagged entry and so on to the last tagged entry upon which it
  884.         will loop back to the first and try the whole list again.
  885.  
  886.         If Simterm connects when dialing a tagged list, it will "untag" the
  887.         entry before leaving the directory.  This means that when you
  888.         disconnect from this BBS, you can go to the directory and dial the
  889.         remaining tagged entries.  The number that was connected to will no
  890.         longer be in the tagged list.
  891.  
  892.         Pressing the space bar when dialing will cause Simterm to cancel
  893.         the dial operation and skip to the pause stage, or if you press
  894.         space while Simterm is pausing, it would skip the pause and dial
  895.         again.  This is useful when dialing tagged entries and you wish to
  896.         skip over one entry for the current pass through the list.
  897.  
  898.         Finally, pressing ESC when Simterm is not dialing simply returns
  899.         you to terminal mode.
  900.  
  901.  
  902.         Buffer (Alt-B)
  903.  
  904.         The Buffer function controls the status of a "capture" file.  When
  905.         the buffer is on, all characters displayed on the terminal screen
  906.         are also written to a file in Simterm's home directory called
  907.         SIMTERM.CAP.
  908.  
  909.         The menu you get when you select the Buffer function is dependent
  910.         on the buffer's current status.  If the buffer is off, you will be
  911.         asked if you want to open the capture file.  If the buffer is on,
  912.         you will be asked if you want to close the capture file or just
  913.         "pause" buffering.  If the buffer is "paused" you will be asked if
  914.         you want to close it or "unpause" it.
  915.  
  916.         When Simterm opens the capture file it will not erase an existing
  917.         capture file, but rather add on or "append" to the end of the file.
  918.         If the file doesn't exist it will be created, of course.
  919.  
  920.  
  921.  
  922.               Simterm 2.0 Copyright (c) 1989,1990 - Jason R. Alward
  923.  
  924.  
  925.  
  926.  
  927.                                                                    Page  14
  928.  
  929.         When you "pause" buffering, you are telling Simterm to stop writing
  930.         to the capture file, but not to close it because you are just
  931.         skipping something.
  932.  
  933.         Simterm uses a 10k buffer for the capture file so your activities
  934.         won't be continuously interrupted by excessive disk writes.
  935.  
  936.  
  937.         Hangup (Alt-H)
  938.  
  939.         The Hangup function simply sets the DTR signal low, waits for about
  940.         a half second, then sets it high again.  If your modem is
  941.         configured correctly, this will tell it to hangup the phone.  As a
  942.         precaution, Simterm checks for the carrier signal after the hangup
  943.         and if it still exists, Simterm informs you that the hangup failed.
  944.  
  945.  
  946.         Download (PG DN) & Upload (PG UP)
  947.  
  948.         The Download and Upload functions are used to transfer files to or
  949.         from the BBS system that you connected to.  Downloading means you
  950.         are receiving a file and uploading means you are sending a file.
  951.  
  952.         When you wish to transfer a file, either upload or download, the
  953.         first thing you must do is get the BBS system ready for a transfer.
  954.         Different systems use different commands and menu structures so
  955.         you'll have to see the BBS's help or instructions for exact
  956.         details, but generally you'll need to: Change to the BBS's file
  957.         section, issue the command to transfer a file (usually U or D for
  958.         upload & download respectively), enter the name of the file to
  959.         transfer, and finally issue the command to select the desired
  960.         transfer protocol.  At this point the BBS should inform you that
  961.         it's ready to do the transfer.
  962.  
  963.         Now that the BBS is ready, you need to tell Simterm that you wish
  964.         to transfer a file.  Press the PG UP or PG DN key, depending on the
  965.         direction of your transfer, and you will receive a menu of
  966.         protocols that looks like this:
  967.  
  968.                                 +----------------+
  969.                                 : Ascii          :
  970.                                 : Xmodem         :
  971.                                 : 1k-Xmodem      :
  972.                                 : Ymodem (batch) :
  973.                                 : Zmodem         :
  974.                                 +----------------+
  975.  
  976.         Select the same protocol from this menu as you told the BBS to use
  977.         and press ENTER.  You will be asked for a filename if you are
  978.         uploading or you are downloading using Ascii, Xmodem, or 1k-Xmodem.
  979.         Ymodem and Zmodem are batch protocols and will get the filename
  980.         from the BBS when downloading.  Now a window will appear on the
  981.         screen displaying data about the transfer like elapsed time,
  982.         approximate characters per second, bytes sent/received, and so
  983.         forth.  Now just sit back as the two systems transmit data.
  984.         Simterm will sound a short alarm to inform you when the transfer is
  985.         complete.
  986.  
  987.  
  988.               Simterm 2.0 Copyright (c) 1989,1990 - Jason R. Alward
  989.  
  990.  
  991.  
  992.  
  993.                                                                    Page  15
  994.  
  995.         A special note should be made about the two batch protocols.
  996.  
  997.         First, when downloading using Zmodem, you don't need to press the
  998.         PG DN key to tell Simterm to start transferring.  Simterm will
  999.         recognize the initialize packet for Zmodem and will automatically
  1000.         start the download when it sees this.
  1001.  
  1002.         Second, when uploading using either batch protocol, you may send
  1003.         more than one file at a time, if the BBS system supports multiple
  1004.         file uploads.  When Simterm asks you for the name of the file to
  1005.         upload, you may enter any legal DOS wildcard specification such as:
  1006.         \FILES\*.ZIP or A:*.*
  1007.  
  1008.         The batch protocols would then send every file matching these
  1009.         specs.  Of course, as with any transfer that requests a filename,
  1010.         if you don't specify a drive or directory, Simterm will use the
  1011.         file path you set in the configuration Options menu.
  1012.  
  1013.  
  1014.         Echo (Alt-E) & Linefeeds (Alt-L)
  1015.  
  1016.         The Echo and Linefeeds functions simply toggle the local echo or
  1017.         add linefeeds settings respectively.  The indicators on the status
  1018.         line are also updated to reflect the new setting.
  1019.  
  1020.  
  1021.         Initialize (Alt-I)
  1022.  
  1023.         The Initialize function simply sends the modem initialization
  1024.         string out to the modem.  This is useful for resetting the modem if
  1025.         it's settings have been changed by another program that you may
  1026.         have executed with the Shell function, for example.
  1027.  
  1028.  
  1029.         Clear (Alt-C)
  1030.  
  1031.         The Clear function simply clears the terminal screen using default
  1032.         colours you set in your configuration.
  1033.  
  1034.  
  1035.         Options (Alt-O)
  1036.  
  1037.         The Options function calls up the configuration menu so you can
  1038.         change Simterm's current settings.  This is useful for changing the
  1039.         com parameters, local echo, add linefeeds, colours, or whatever, as
  1040.         described in the Configuring Simterm section.  Pressing "S" in this
  1041.         menu will save the settings to the SIMTERM.CFG file, making them
  1042.         the start up defaults.  Changes made in the configuration menu are
  1043.         effective immediately so pressing ESC allows you to make changes
  1044.         for the current session without changing the start up defaults.
  1045.  
  1046.  
  1047.         Send BREAK Signal (Ctrl-@)
  1048.  
  1049.         This function is not listed in the help menu as it is only used in
  1050.         special cases, such as baud detect for some UNIX systems.  It's
  1051.         purpose is to transmit a special signal, called a "break", to the
  1052.         remote system which would trigger some special action.
  1053.  
  1054.               Simterm 2.0 Copyright (c) 1989,1990 - Jason R. Alward
  1055.  
  1056.  
  1057.  
  1058.  
  1059.                                                                    Page  16
  1060.  
  1061.                             FILE TRANSFERS & PROTOCOLS
  1062.                                     Chapter 4
  1063.  
  1064.  
  1065.         WHAT IS A FILE TRANSFER
  1066.  
  1067.         File transfers allow you to exchange programs, text, or any other
  1068.         type of file with any BBS system that supports a file section.  In
  1069.         order to transfer files over phone lines, the receiving system must
  1070.         have some way to tell if the data it received is the same as what
  1071.         was originally sent.  Phone lines are seldom perfectly clear of
  1072.         static or noise, and this noise can alter the data as it travels
  1073.         from one system to the other.  This is the purpose of transfer
  1074.         "protocols".
  1075.  
  1076.         Transfer protocols generally break a file into small chunks called
  1077.         "packets" or "blocks", then perform some calculation on the data
  1078.         and send the "packet", followed by the result of the calculation,
  1079.         to the receiver.  The receiver performs the same calculation on the
  1080.         data as it comes in and then compares it's result with the
  1081.         following sender's result.  If the two match, the receiver writes
  1082.         this data to it's copy of the file and sends some acknowledgement
  1083.         signal to alert the sender to send the next packet.  If the two
  1084.         calculation results don't match then the data was corrupted in
  1085.         transit and the receiver sends a negative acknowledgement signal to
  1086.         alert the sender to resend the same packet.
  1087.  
  1088.         Different protocols use different methods for calculating the error
  1089.         check value, signaling the start of a packet, and acknowledging
  1090.         good and bad packets.  Therefore it is important to use the same
  1091.         protocol as the system you're connected to.
  1092.  
  1093.         In Simterm I have attempted to support a "survival kit" of transfer
  1094.         protocols.  I couldn't support a long list of protocols since that
  1095.         would have made Simterm too large a program (Simterm's main feature
  1096.         is that it's very small without being "gutted" of features).  I
  1097.         also didn't want to support so few protocols that you would have to
  1098.         turn to another terminal program for file transfers.  So I've
  1099.         picked the minimum complement of protocols that I felt were
  1100.         essential to any terminal program.
  1101.  
  1102.  
  1103.         SUPPORTED PROTOCOLS
  1104.  
  1105.         There are five protocols supported by Simterm and they are as
  1106.         follows: Ascii, Xmodem, 1k-Xmodem, Ymodem (batch), and Zmodem.
  1107.  
  1108.         Now I'll give a brief description of each protocol.
  1109.  
  1110.  
  1111.         Ascii
  1112.  
  1113.         Ascii isn't really a protocol since it has no method for error
  1114.         checking built in and as such is only useful for text files.  It
  1115.         does however provide one very useful function, you can upload a
  1116.         message that was entered offline.
  1117.  
  1118.  
  1119.  
  1120.               Simterm 2.0 Copyright (c) 1989,1990 - Jason R. Alward
  1121.  
  1122.  
  1123.  
  1124.  
  1125.                                                                    Page  17
  1126.  
  1127.         Since Ascii just reads a file and sends out the characters as if
  1128.         you were typing them at the keyboard, it allows you to use a text
  1129.         editor or word processor to create a message that you want to
  1130.         "post" on a BBS.  This is done when you're not connected and not
  1131.         paying for online charges.  You save your message as a pure ASCII
  1132.         text file and then use Simterm to connect to the BBS.  Do whatever
  1133.         is required to enter a message and when the BBS is waiting for you
  1134.         to type in your message, upload your text file with the Ascii
  1135.         protocol.  You will see the text appearing on your screen as the
  1136.         BBS echoes it back, just as if you were typing it.
  1137.  
  1138.  
  1139.         Xmodem
  1140.  
  1141.         Xmodem is not particularly efficient nor 100% reliable, but it is
  1142.         supported by almost every online service there is.  No matter how
  1143.         limited a BBS's list of supported protocols is, it will probably
  1144.         support Xmodem.  This is why it was essential to support Xmodem.
  1145.  
  1146.         Some BBS's may offer you two varieties of Xmodem reflecting the two
  1147.         types of error checking that Xmodem can use.  These are Checksum
  1148.         and CRC.  Simterm supports both methods and detects which one the
  1149.         BBS is using so it will work with either one.  Whenever you have
  1150.         the option, CRC is the preferred method as it is a great deal more
  1151.         reliable than the Checksum method.
  1152.  
  1153.  
  1154.         1k-Xmodem
  1155.  
  1156.         1k-Xmodem is basically the same as Xmodem except for the size of
  1157.         it's packets.  Xmodem uses 128 byte packets and 1k-Xmodem uses 1024
  1158.         byte packets, which is where the "1k" prefix came from.  This makes
  1159.         it a bit faster than Xmodem since it's packet overhead is reduced
  1160.         by a factor of 8.
  1161.  
  1162.         You should be warned that not all BBS's refer to this protocol as
  1163.         1k-Xmodem.  On some systems it's called "Old Ymodem" and others
  1164.         just call it "Ymodem".  This can lead to confusion since this is
  1165.         not that same as the "Ymodem (batch)" that Simterm supports.  So if
  1166.         you're trying to use Ymodem and it just won't work, the BBS is
  1167.         probably using a misnamed 1k-Xmodem, so tell Simterm to use
  1168.         1k-Xmodem even though the BBS calls it Ymodem.
  1169.  
  1170.  
  1171.         Ymodem (batch)
  1172.  
  1173.         Ymodem (batch) uses the same type of packets as Xmodem but can use
  1174.         both 128 and 1024 byte packets dynamically.  The most important
  1175.         feature, however, is that it starts the transfer with a special
  1176.         header packet that contains complete filename, size, date, and time
  1177.         information about the file.  The transfer is ended with a blank
  1178.         header packet (all 0's).  These header packets allow more than one
  1179.         file to be transmitted in a single session, thus it is called a
  1180.         "batch" protocol.  On some BBS's this is called "True Ymodem" or
  1181.         just "Ymodem" so it can be confusing to tell whether you have to
  1182.         use Ymodem or 1k-Xmodem.
  1183.  
  1184.  
  1185.  
  1186.               Simterm 2.0 Copyright (c) 1989,1990 - Jason R. Alward
  1187.  
  1188.  
  1189.  
  1190.  
  1191.                                                                    Page  18
  1192.  
  1193.         Zmodem
  1194.  
  1195.         Zmodem is the most powerful of the protocols supported by Simterm
  1196.         and should be used whenever possible.  It is very efficient because
  1197.         of a low overhead on each data packet and, like Ymodem, it is a
  1198.         batch protocol and can send more than one file per session.  It
  1199.         also supports advanced features like crash recovery, automatic
  1200.         start on downloads, and 32 bit CRC error checking (making it
  1201.         extremely reliable).  These features are described in the following
  1202.         section.
  1203.  
  1204.  
  1205.         SPECIAL ZMODEM FEATURES
  1206.  
  1207.  
  1208.         Zmodem Crash Recovery
  1209.  
  1210.         Crash recovery means that you can resume an interrupted download at
  1211.         a later time without the sender having to retransmit data that you
  1212.         have already received.  For instance, you're downloading a file and
  1213.         you loose carrier due to line noise, or the power goes out.  Now
  1214.         you're stuck with an incomplete file and with any of the other
  1215.         protocols, you'd have to download the whole thing again.  But when
  1216.         you reconnect to the BBS and download the file again using Zmodem,
  1217.         it will see that the file already exists but is incomplete.  So it
  1218.         will tell the sender how much of the file you already have, and the
  1219.         sender will adjust it's start position accordingly, thus completing
  1220.         the file.
  1221.  
  1222.  
  1223.         Zmodem Auto-Start
  1224.  
  1225.         Automatic start means that you don't have to tell Simterm that
  1226.         you're starting a Zmodem download.  Just tell the BBS to send the
  1227.         file using Zmodem and sit back.  Simterm will recognize the Zmodem
  1228.         initialize packet and start a Zmodem download for you.
  1229.  
  1230.  
  1231.         Zmodem 32 bit CRC
  1232.  
  1233.         The other protocols use a 16 bit CRC for their error checking an
  1234.         this is reasonably reliable.  Zmodem can also use a 16 bit CRC, if
  1235.         the BBS version of Zmodem doesn't support a 32 bit CRC, but Simterm
  1236.         prefers a 32 bit CRC for the increased reliability and will inform
  1237.         the BBS that it wants to use them.
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.               Simterm 2.0 Copyright (c) 1989,1990 - Jason R. Alward
  1253.  
  1254.  
  1255.  
  1256.  
  1257.                                                                    Page  19
  1258.  
  1259.                                REGISTERING SIMTERM
  1260.  
  1261.  
  1262.         To register Simterm, simply print the file REGISTER.DOC on your
  1263.         printer, fill in the requested information and mail the form along
  1264.         with your check or money order to:
  1265.  
  1266.                                  Jason R. Alward
  1267.                           129 Concession St. E. Unit #22
  1268.                                Tillsonburg, Ontario
  1269.                                   Canada N4G4N4
  1270.  
  1271.         In order to print the form you can type the following at your DOS
  1272.         command prompt:
  1273.  
  1274.         copy register.doc prn
  1275.  
  1276.         If you don't have a printer you can just send a letter containing
  1277.         the information requested in the registration form.  Be sure to
  1278.         specify the version of Simterm that you are registering when not
  1279.         using the supplied form.
  1280.  
  1281.         When Simterm is going to be installed on more than one machine, you
  1282.         must register a copy for each machine.  Quantity purchase discounts
  1283.         are as follows:
  1284.  
  1285.                            1 to  10 copies   no discount
  1286.                           11 to  25 copies   5% discount
  1287.                           26 to  50 copies  10% discount
  1288.                           51 to 100 copies  15% discount
  1289.                          101 to 200 copies  20% discount
  1290.                          201+       copies  25% discount
  1291.  
  1292.         Orders over 50 copies are site licenses.  You will receive a master
  1293.         copy and written authorization to make the number of copies
  1294.         requested.
  1295.  
  1296.         ALL PRICES AND DISCOUNTS ARE SUBJECT TO CHANGE WITHOUT NOTICE.
  1297.         Discounts are not cumulative.  They apply to single orders of like
  1298.         products only.
  1299.  
  1300.  
  1301.                                      WARRANTY
  1302.  
  1303.  
  1304.         Simterm is sold "as is" without warranty of any kind, express or
  1305.         implied, including but not limited to, any warranties of
  1306.         merchantability and/or fitness for a particular purpose.  Jason
  1307.         Alward shall not be liable for any damages, whether direct,
  1308.         indirect, special or consequential arising from a failure of
  1309.         Simterm to operate in the manner desired by the user.
  1310.  
  1311.         IN NO EVENT WILL JASON ALWARD BE LIABLE FOR ANY DAMAGES TO DATA OR
  1312.         PROPERTY WHICH MAY BE CAUSED DIRECTLY OR INDIRECTLY BY THE USE OF
  1313.         SIMTERM.  JASON ALWARD SHALL NOT BE LIABLE TO YOU FOR ANY DAMAGES,
  1314.         INCLUDING ANY LOST PROFITS, LOST SAVINGS, OR OTHER INCIDENTAL OR
  1315.         CONSEQUENTIAL DAMAGES ARISING OUT OF YOUR USE OR INABILITY TO USE
  1316.         SIMTERM, OR FOR ANY CLAIM BY ANY OTHER PARTY.
  1317.  
  1318.               Simterm 2.0 Copyright (c) 1989,1990 - Jason R. Alward
  1319.  
  1320.  
  1321.