home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / CPM / IMP / IMP-SP.LBR / IMP.DQC / IMP.DOC
Text File  |  2000-06-30  |  37KB  |  867 lines

  1.  
  2.  
  3.                  IMP
  4.  
  5.             (NOTES ON HOW TO USE)
  6.  
  7.                Copyright 1985
  8.  
  9.  
  10.              Irvin M. Hoff W6FFC
  11.  
  12.                  01 OCT 1985
  13.  
  14.  
  15.  
  16. INTRODUCTION:
  17. ------------
  18.  
  19.          NOTE:  THIS PROGRAM SUPPORTS ANY 1200 OR
  20.             2400 BPS MODEM INTENDED FOR AUTO-
  21.             DIALING WITH THE "AT" PROTOCOL OR
  22.             THE RACAL-VADIC PROTOCOL. IT ALSO
  23.             SUPPORTS THE  PROMETHEUS PROMODEM
  24.             EXTENDED-"AT" 1200 BPS PROTOCOL.
  25.  
  26.  
  27.      NOTE:    IMP v241 adds KMD-type batch protocol in addi-
  28.         tion to the MODEM7 type.  It comes up in KMD
  29.         batch.    Use the command TBM to toggle batch
  30.         mode to MODEM7 type if needed.    RCPM systems
  31.         with KMD/BYE500 support the KMD-type batch mode.
  32.  
  33.  
  34.  
  35.     The IMP modem program enables a computer to communicate with
  36. another computer.  This is normally done by using standard telephone
  37. lines but with special audio tones sending serial data.  Three common
  38. speeds are used, depending on the facilities available -- 300, 1200 or
  39. 2400 bps.  ('bps' stands for bits per second.  One character is 10 bits
  40. per second, normally.  It may be 11 bits if two stop pulses are used.)
  41.  
  42.  
  43. WHAT IS A MODEM?
  44. ---------------
  45.     A "modem" is used which provides these audio tones.  This is an
  46. acronym for "modulator and demodulator".  The one section (modulator)
  47. provides the audio tones for sending over the telephone line and the
  48. other section (demodulator) then converts those audio tones back to dig-
  49. ital pulses the computer uses to receive the incoming data.
  50.  
  51.     The modem itself is a hardware utility, usually costing around
  52. $75 to $200 for a typical 300 Baud device and from $200 to $450 for a
  53. system offering 1200 Baud as well as 300 Baud.    The newest modems add
  54. 2400 bps and currently can be obtained from $435 to "way on up".  (The
  55. so-called "list prices" are rarely paid even with single-unit purchases.)
  56.  
  57.     Some modems are intended for plugging directly into the computer
  58. while a vast majority are external devices that connect to the computer
  59. through a serial I/O connector.  These are often designed to sit under
  60. the phone itself to minimize space required.  An external modem has sev-
  61. eral advantages as most have numerous indicator lamps telling the user
  62. what is happening.  This also makes it far more simple to use the modem
  63. on any of several computers the user may have.
  64.  
  65. AUTO-STEPDOWN, A NEW MODEM FEATURE
  66. --------------------------------
  67.     The newer 300/1200/2400 bps intelligent modems have the ability
  68. to determine the maximum speed (baudrate) at which the system they are
  69. calling can use.  They adjust themselves accordingly, without operator
  70. intervention or knowledge.  They send a "result code" back to the local
  71. computer telling it what speed they now have.  This information can be
  72. used to automatically set the local computer to the same speed.  A mes-
  73. sage is displayed telling the operator what speed he has.
  74.  
  75.     If the operator has a reason for using less than the maximum
  76. speed to which another system might respond, he can initially restrict
  77. the modem from attempting to connect at a faster speed.  Example, Compu-
  78. serve has modems that will answer at either 1200 or 300 bps.  If reading
  79. and answering messages "on line in real time" many callers prefer to use
  80. 300 baud (they cannot type even that fast) rather than 1200 bps which is
  81. nearly twice the cost.
  82.  
  83.     IMP takes advantage of this automatic stepdown feature.  It has
  84. the modem attempt to connect at 2400 bps.  If that is unavailable at the
  85. answering end, the modem tries for 1200 bps.  When connected, IMP shows
  86. the speed currently in use and automatically adjusts the local I/O to
  87. match.    (IMP is the first and currently the only free modem program to
  88. take advantage of this new modem feature.)
  89.  
  90.     The operator can easily select the "SET" command should he wish
  91. to override the automatic "start trying at 2400" and have a specific
  92. speed dialed (such as 300 baud for Compuserve for hand typing messages
  93. at lower cost, etc.)  The automatic feature is reinstated by either
  94. using the "SET" command for 2400, or merely calling up the modem program
  95. from the disk once more.
  96.  
  97.     Note: The US Robotics Courier auto-steps from 2400 to 1200 but
  98. not to 300, as do most of the other new modems with 2400 bps.
  99.  
  100.  
  101. PURPOSE
  102. -------
  103.      The program discussed in this guide allows each computer involved
  104. to directly control its own modem, converting DC pulses into audio tones
  105. which are sent to (or received from) the telephone line.  (The standard
  106. 1200 baud transmissions use "DPSK" (dibit phase shift keying) instead of
  107. "AFSK" (audio frequency shift keying).
  108.  
  109.      For short distances, no modems are required as the computer can
  110. provide the necessary digital voltages.  This discussion is centered
  111. around systems intended for use over distances ranging from several
  112. miles to literally around the world.
  113.  
  114.  
  115. FEATURES:
  116. --------
  117.      A program to communicate with another computer can range from very
  118. simple to very complex.  Although IMP has a number of quite useful fea-
  119. tures (some of which other modem programs do not currently offer) it is
  120. one of the easier programs to learn and use.  A list of some of the
  121. features offered by this particular program include:
  122.  
  123.   1)  Ability to talk with another computer via keyboard at each end.
  124.       (Called the "terminal mode".)
  125.   2)  Ability to operate a remote mainframe computer such as TYM-SHAR,
  126.       or special data bank systems now commonplace.  This includes
  127.       "bulletin board" systems for receiving, sending or just read-
  128.       ing messges or other types of information.
  129.   3)  Ability to upload (send) or download (receive) programs from other
  130.       computers whether TYM-SHAR, data banks, remote hobby systems
  131.       or just another individual in another location.
  132.   4)  Ability to automatically transfer a group of files (called "batch
  133.       mode".  Two popular methods included, KMD batch mode and the
  134.       older MODEM7 batch mode.
  135.   5)  Ability to copy incoming information on a printer.  If the print-
  136.       er is too slow to copy the data directly, the extra characters
  137.       back into a large storage buffer until they can be printed.
  138.   6)  Ability to copy incoming data into memory for automatic transfer
  139.       to a disk file.
  140.   7)  Accomodates any computer clock speed up to 25.5 MHz. in 0.1 Mhz.
  141.       increments for uniform results.  (The clock speed is actually
  142.       of modest interest, it is only used for setting timing loops.)
  143.   8)  Advanced type of error detection (CRC or Cyclic Redundancy Check)
  144.       using automatically generated high-speed lookup tables.
  145.   9)  Ability to send any of 10 different pre-programmed function keys.
  146.       (These keys are very easy to reset, using either of two exter-
  147.       programs provided.)
  148.  10)  Automatic disconnect from the telephone line when using CTL-N, "D"
  149.       or "Z" as an option during file transfer.
  150.  11)  Automatic or manual 1k protocol for increased throughput and effi-
  151.       ciency over the 128 character blocks long associated with such
  152.       programs.
  153.  12)  Supports 1200 or 2400 bps modems using the Racal-Vadic or 'AT'
  154.       protocol developed by Hayes.    These features basically include
  155.       automatic dialing and redialing until the system being called
  156.       finally answers.
  157.  
  158.            a) Automatic selection of a particular phone number from
  159.           a library of names and numbers.  (These phone numbers
  160.           can be very easily changed by using either of two ex-
  161.           ternal programs that are provided.)
  162.            b) Automatic dialing for alternate long-distance systems
  163.           (where auto-dialing touch-tone modems are used).
  164.            c) Entry of a hand-typed number.  Although it might be as
  165.           simple to manually dial the number as hand-type it, it
  166.           can then be automatically redialed indefinitely.
  167.            d) Auto-linking of 1-32 different numbers for continuous
  168.           dialing until one of the group is available.
  169.            e) Choice of beeping continuously when connected to get
  170.           the operator's attention, or beep one time and go to
  171.           terminal mode immediately to catch UNIX or IBM signon
  172.           messages that assume you can copy when connected.
  173.            f) Automatically adjusts the terminal speed to that of
  174.           system answering the phone.
  175.  
  176.  
  177. USING THE PROGRAM THE FIRST TIME:
  178. --------------------------------
  179.      For now, we shall assume the program is ready to use on your equip-
  180. ment.  (Normally the user must make some modest changes to the program
  181. before it can be used.    This includes changing the port numbers and some
  182. other personal options.  These will be covered later in the section that
  183. describes how to adapt it to your equipment.)
  184.  
  185.      When the program is brought up is shows this display (if using the
  186. PMMI modem):
  187.  
  188.  
  189.       IMP v240 modem pgm (type M for Menu)
  190.       Copyright (c) 1985 Irvin M. Hoff
  191.       Version for Datapoint 1560 modem port 28H
  192.       Modem speed is: 2400 bps
  193.  
  194.       B>>COMMAND: x
  195.  
  196.  
  197.     (Your version would have a different line 3 once the ap-
  198.     propriate overlay was added and the baudrate might show
  199.     show 1200 if you do not have 2400 available.)
  200.  
  201.  
  202.        The cursor stops at point "x:" waiting for some sort of command.
  203. Typing a "M" followed immediately by a RETURN, shows the first page of
  204. a 3-page help guide.
  205.  
  206.      Several commands are similar to those already used for CP/M, such
  207. as 'ERA', 'DIR' and the ability to change disk drives and user areas.
  208. This adds tremendous flexibility while remaining in the modem command
  209. mode.  To change disk drives, just say:
  210.  
  211.       B>>COMMAND: A: <cr>
  212.  
  213.      and you are in the same user area on the A: drive.  You can also
  214. say:
  215.       A>>COMMAND: A12: <cr>
  216.  
  217.      to change user areas.  When finished (using this example), say:
  218.  
  219.       A12>>COMMAND: CPM  <cr>
  220.          or
  221.       A12>>COMMAND: BYE  <cr>
  222.  
  223.      and you will go back to CP/M with the original drive and user area.
  224.  
  225. OPTIONS:
  226. -------
  227.      There are 6 primary options and 9 secondary options that may be
  228. typed on the command line.  In addition there are over numerous commands
  229. ranging from single character to three characters that can be used (such
  230. as DIR, ERA, LOG, etc.)  Those are listed on the menu.
  231.  
  232.      Primary Options:     E, L, M, R, S, T
  233.       E = Echo mode (special type of full duplex)
  234.       L = Local modem (no remote echo, half duplex)
  235.       M = Menu display showing features that are available
  236.       R = Receive a file from remote facility
  237.       S = Send a file to a remote facility
  238.       T = Terminal mode (full duplex, echo provived remotely)
  239.  
  240.      Secondary Options:  A, B, D, J, O, Q, R, S, V, X, Z
  241.       B = Batch mode -- allows automatic multiple file transfer
  242.         (This has been normally only used from modem-to-modem
  243.         as few RCP/M systems have had batch capability.  This
  244.         is now changing with the introduction of KMD v04 and
  245.         BYE501.  Batch mode allows the use of wildcards to
  246.         simplify typing numerous file names.)
  247.       D = Disconnect when done, stay in IMP
  248.       K = Manually initiates 1k protocol in send mode
  249.       Q = Quiet mode, special purpose feature rarely used except if
  250.          operating through a "BYE" program.
  251.       R = Receive remote file (8-bit binary)
  252.       S = Send file to remote system (8-bit binary)
  253.       V = Visual inspection of an ASCII file being transferred.  Not
  254.          often used as most ASCII files are now "squeezed" for
  255.          minimum transfer time and disk space.
  256.       X = Inhibits automatic 1k request, transfers 128 char. blocks
  257.       Z = Exit to CP/M  when finished, disconnect from phone line
  258.  
  259.  
  260.      Although you can get the following information from the help guide
  261. in IMP itself, showing it here will allow us to discuss the various fea-
  262. tures in somewhat better detail.
  263.  
  264.  
  265. -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -
  266.  
  267.  
  268. THE HELP GUIDE, PAGE 1:
  269. ----------------------
  270.  
  271.           Single Letter Commands
  272.  
  273.  ?  - Display current settings
  274. ESC - Function key intercept character, then (0-9)
  275.  M  - Display the menu
  276.  E  - Terminal mode with echo
  277.  L  - Terminal mode with local echo
  278.  T  - Terminal mode
  279. ^Z  - Clears screen (command mode only)
  280.  R  - Receive an 8-bit binary CP/M file
  281.  S  - Send an 8-bit binary CP/M file
  282.  
  283.     COMMAND: R (or S) FILENAME.TYP
  284.     R and S can use the following subcommands:
  285.        B  - Batch transfer, can use wildcards (e.g., *.*)
  286.        D  - Disconnect when done, return to command mode
  287.        K  - Manual request for 1k transmissions
  288.        Q  - Quiet mode (no messages to console)
  289.        V  - View ASCII files on CRT during a file transfer
  290.        X  - Inhibits auto 1k request to sender
  291.        Z  - When done, disconnect, go to CP/M
  292.  
  293.     For copying text to disk use T (E or L) FILENAME.TYP
  294. [more]
  295.  
  296.      The single letter commands may also be used on the
  297.      command line when the program is initially executed.
  298.  
  299. -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -
  300.  
  301.  
  302. DISCUSSION OF HELP GUIDE PAGE 1:
  303. -------------------------------
  304.  
  305.      There are basically three types of commands that may be used with
  306. this program:
  307.          1)  Single-letter commands shown on page one.
  308.          2)  Three-letter commands shown on page 2, and
  309.          3)  Control-<char.> commands shown on page 3.
  310.  
  311.      Going down the list:
  312.  
  313.   ? - shows current parameters.  As these are closely tied in with some
  314.       of the other options, we shall show a typical example later
  315.       in this discussion.
  316.  ESC - shows the function key intercept character.  This may be easily
  317.       changed using an external program called I2FUNC.COM.
  318.  
  319.       NOTE:  typing ESC <cr> while in the command mode will display
  320.          all the programmable function key definitions with the
  321.          exception of the log-on string which uses CTL-L.
  322.  
  323.   M - shows the menu a page at a time.    You may abort after any page is
  324.       shown with a CTL-C
  325.   E - terminal mode with echo.    When talking with another terminal also
  326.       also using IMP (or a comparable program), one of you must send
  327.       an 'echo' back so you can both see what the other person is
  328.       typing.  This is needed for full-duplex operation.  Usually
  329.       the person originating the call will type "E" instead of "T".
  330.       However either may do this.  If "both" use the echo mode, the
  331.       program usually starts typing a string of feedback characters
  332.       since both computers are re-sending the same character over
  333.       and over.  You can stop this by just returning to command mode
  334.       (type control-E) and then retyping "T" rather than "E".
  335.   L - terminal mode with local echo.  Shows what you are typing but does
  336.       not send an echo of the other person's typing back to him.
  337.       Can be used at both ends, in place of one person using "E".
  338.       Both "E" and "L" are useful at times for some types of modems
  339.       that do not use full-duplex, or for some main frame units that
  340.       run half-duplex.  The combination of "T", "E" and "L" gives an
  341.       excellent choice to use on various systems.  Normally the "T"
  342.       mode is sufficient except when talking with another person and
  343.       then the "E" mode at one end or "L" mode at both ends will
  344.       provide normal results.  If the remote system does not supply
  345.       a LF after a CR, you can get that from the 'TLF' command.
  346.   T - puts the program directly into "terminal mode", allowing it to
  347.       send from the keyboard to the other computer, and to copy any-
  348.       thing coming from the other computer with the exception of
  349.       file transfers (use "R" to receive those).
  350.   R - used only for receiving files from the other computer.  These are
  351.       usually sent in binary form with either checksum verification
  352.       or more commonly, CRC (Cyclic Redundancy Checking).  If ready
  353.       to receive another file, you have several choices, depending
  354.       on the program used by the other computer.   After notifying
  355.       him you are ready (or will be very shortly), you can type:
  356.  
  357.            B>>COMMAND: R HELLO.DOC <cr>
  358.  
  359.       and when he starts to send, you will receive the program which
  360.       then goes directly to the disk.  You could also have said:
  361.  
  362.            B>>COMMAND: RB <cr>
  363.  
  364.       This is called the "Batch mode" and is an extremely useful way
  365.       to receive programs automatically, from another computer using
  366.       a similar program.  He will use the batch mode for sending the
  367.       programs and that automatically provides the file names at the
  368.       receiving end.  In this manner, large numbers of programs can
  369.       be transferred completely automatically, including full disks.
  370.       (Assuming you care to pay the toll calls for the time it will
  371.       take!)
  372.  
  373.       NOTE:  The ideal way to receive batch mode would be:
  374.  
  375.            B>>COMMAND: RB <cr>    (also just  R <cr> is enough)
  376.  
  377.          since you may not know in advance how many programs he
  378.          will be sending.
  379.  
  380.            NOTE:  While receiving a file, any errors will be shown
  381.               on the console CRT, indicating that portion of the
  382.               program is being repeated.  If the file finishes
  383.               transferring normally, it will have been received
  384.               error-free.  Those error notices are merely to let
  385.               the user know a momentary problem caused a resend.
  386.               The error messages indicate phone line quality.
  387.  
  388.   S - used only to send programs.  Similar to "R" but sends instead of
  389.       receives.  If the other system is ready to receive, you could
  390.       then type:
  391.  
  392.            B>>COMMAND: S HELLO.DOC <cr>
  393.  
  394.       It will tell you how many records are involved and how many
  395.       minutes and seconds it will take to send the program.  If the
  396.       other system is ready to receive, it starts the transfer,
  397.       showing how many records have been sent.  If any errors occur
  398.       during transmission, it shows what they are and counts them.
  399.       It will resend any records not correctly received at the other
  400.       computer.  If too many consecutive errors occur (normally set
  401.       at 10), the transfer is terminated.  The 'batch mode' may also
  402.       be used for sending:
  403.  
  404.            B>>COMMAND: SB HELLO.*         (sending batch mode)
  405.  
  406.       will send all files starting with HELLO, or can send just one
  407.       file, or can send several non-related files in this manner:
  408.  
  409.            B>>COMMAND: SB HELLO.DOC XDIR.COM TERM.*
  410.  
  411.       etc.    Be sure to put a space between the various files.  You
  412.       can include the 'Z' option:
  413.  
  414.            B>>COMMAND: SBZ HELLO.* IMP740.LBR I2LIB.COM
  415.  
  416.       When the file transfer is completed it disconnects from the
  417.       phone line and reverts to CP/M.  This allows you to be absent
  418.       when the file is finished, offering an advantage when sending
  419.       lengthy files.
  420.  
  421. -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -
  422.  
  423.  
  424. THE HELP GUIDE, PAGE 2:
  425. ----------------------
  426.  
  427.         Three Letter Commands
  428.  
  429. BYE - Disconnect, then return to CP/M
  430. CAL - Dial number
  431. CPM - Exit from this program to CP/M
  432. DIR - List directory and space free (may specify drive)
  433. DSC - Disconnect from the phone line
  434. ERA - Erase file (may specify drive)
  435. LOG - Change default drive/user no. (specify drive/user)
  436.       and reset disks.    e.g. LOG A0: or LOG B: (user # unchanged)
  437. SET - Set modem baud rate
  438. SPD - Set file output speed in terminal mode
  439. TBM - Toggle MODEM7/KMD batch mode selection
  440. TCC - Toggle CRC/Checksum mode on receive
  441. TLF - Toggle LF after CR in "L" or "T" mode for a disk file
  442. TRB - Toggle rubout to backspace conversion
  443.  
  444.       The following are terminal text buffer commands:
  445.  
  446. DEL - Delete memory buffer and file
  447. WRT - Write memory buffer to disk file
  448.  
  449. [more]
  450.  
  451. -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -
  452.  
  453.  
  454. DISCUSSION OF HELP GUIDE, PAGE 2:
  455. --------------------------------
  456.  
  457.   BYE - Disconnects the modem from the phone line, closes any file that
  458.       may be open and returns to CP/M.
  459.   CAL - Displays the telephone library.
  460.  
  461.     NOTE:  Use the phone number overlay to easily change the numbers
  462.            that are stored.  This overlay also accesses up to two
  463.            alternate long distance dialing systems for the touch-
  464.            tone auto-dialing modems.  You can also use an external
  465.            program called I2LIB to rapidly change any phone numbers.
  466.  
  467.   CPM - This returns to normal CP/M use, abandoning IMP.
  468.  
  469.       CAUTION: It does not disconnect the modem from the phone line,
  470.            which allows intentional return to CP/M temporarily.
  471.  
  472.   DIR - Enables the user to see the library of any disk without needing
  473.       to return to CP/M first.  Can be adjusted when installing the
  474.       program to show 3, 4, or 5 groups depending on the width of
  475.       your CRT display.  Normally set to 5 for 80-column displays.
  476.       Shows the amount of disk spacing remaining on the logged-in
  477.       default drive.  (You must log in any drive you wish to write
  478.       on, or to see the correct free disk space remaining.)  See the
  479.       LOG feature below.
  480.   DSC - Disconnects the modem from the phone line whenever selected.
  481.   ERA - Enables the user to erase any files from any disk without the
  482.       need to return to CP/M first.  Wild cards (* and ?) accepted.
  483.   LOG - When a new disk is inserted, you can see the directory and read
  484.       files from it but cannot write to it without getting a "BDOS
  485.       ERR".  This command allows you to log in a new disk so you can
  486.       immediately write on it without first returning to CP/M for a
  487.       warm boot.  You can select drive and user number.  (This also
  488.       enables DIR to show the correct free disk space remaining.)
  489.       You can say:
  490.              LOG <cr> for same drive, user area, new disk
  491.              LOG A
  492.              LOG A:
  493.              LOG A14     (user areas are 0-15)
  494.              LOG A11:
  495.  
  496.   SET - Allows the user to change baudrates when desired.  If using a
  497.       2400 bps modem with automatic stepdown, this would rarely be
  498.       used.
  499.   SPD - Sets the delay between characters and/or delay between lines in
  500.       the "T" mode when using ESC F upload a pre-typed file.  Since
  501.       most bulletin boards and TYM-SHAR systems normally use line
  502.       editors that require a delay after they have received a line,
  503.       you can add delay between characters (in increments of 4 ms.)
  504.       and/or enter delay between lines (in increments of 100 ms.)
  505.       This is preset for most systems at 2 and 200 ms.  They can be
  506.       changed at any time.    Current values can be checked by using
  507.       the  " ? " command.
  508.   TBM - Toggle batch mode from KMD (default) to MODEM7.  The primary
  509.       difference is the way the file name is sent.    The older MODEM7
  510.       method sends each character separately, expecting the other
  511.       computer to echo each character.  Checksum is used to verify
  512.       the file name.  The KMD method sends a special 128 byte block
  513.       with the file name and the length of the file.  This is not
  514.       only far better for use with mainframe and networking systems,
  515.       but also informs the operator receiving the file how long it
  516.       will be.  (The KMD method then automatically goes to 1k mode.)
  517.   TCC - Most modem programs originally used simple checksum verification
  518.       of received sectors.    Most now use Cyclic Redundancy Checking
  519.       which finds certain transmission errors the simple checksum
  520.       system might overlook.  This toggle allows the user to select
  521.       checksum for those systems known to not offer CRC.  When set
  522.       normally to CRC, the program automatically switches to check-
  523.       sum after trying several times to use CRC.
  524.   TLF - If sending a file while in terminal mode (via CTL-T option) most
  525.       mainframe computers will not want you to send a line feed.  As
  526.       all editors include the LF after CR, you have the option with
  527.       this toggle of sending or not sending a line feed.  If typing
  528.       manually in the "T" mode, you can get a line feed with CTL-J.
  529.       It is automatically included after CR with "L" or "E" modes.
  530.   TRB - Allows the rubout char. to be changed to backspace if desired.
  531.   DEL - If copying incoming information into memory, and you decide you
  532.       do not want to bother saving it to disk after all, this closes
  533.       (and then deletes) the disk file you had opened.
  534.   WRT - saves what you have been copying to the disk file already opened
  535.       for that purpose.  When returning from the "T" mode to command
  536.       mode, a warning is shown that you may lose what has been saved
  537.       unless you use WRT (write to disk).
  538.  
  539.       NOTE: An open file is automatically written to disk
  540.         should you use BYE or CPM commands to leave the
  541.         program, thus preventing accidental loss of data
  542.         intended to be saved.
  543.  
  544.  
  545. -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -
  546.  
  547.  
  548. THE HELP GUIDE, PAGE 3:
  549. ----------------------
  550.  
  551.   Local Commands while in Terminal Mode
  552.  
  553.   ESC E  - Exit to command mode
  554.   ESC F  - Send file to remote system
  555.   ESC L  - Send log-on message
  556.   ESC N  - Disconnect from the phone line
  557.   ESC P  - Toggle printer on (or off)
  558.   ESC Z  - Clears screen, terminal mode
  559.  
  560.   ESC R  - Stop copy into buffer
  561.   ESC Y  - Start copy into buffer
  562.  
  563.         Start & Stop may be toggled as often as desired.
  564.         A ";" at start of line indicates buffer is copying.
  565.         X-off automatically used to stop input when writing
  566.            full buffer to disk, X-on sent to resume.
  567.  
  568.  
  569.   >>COMMAND:
  570.  
  571. -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -
  572.  
  573.  
  574. DISCUSSION OF HELP GUIDE, PAGE 3:
  575. --------------------------------
  576.  
  577.   ESC E  - Returns to command modem from "T", "L", "E" modes.
  578.   ESC F  - Sends an ASCII file to the remote terminal, X-on and X-off
  579.          automatically used.  Optional delays available.
  580.   ESC L  - Will send the log-on message if one has been included in the
  581.          LOGON area of the overlay.
  582.   ESC N  - Disconnect the modem from the phone line.
  583.          (You can easily change this to whatever you like in the
  584.          overlay you use for your equipment.)
  585.   ESC P  - Toggles the printer on-off.    Very useful feature.  Similar to
  586.          normal control-P but in this case if the modem is running
  587.          faster than normal printer speed, the characters just back
  588.          into a special buffer while the printer tries to catch up.
  589.          Especially beneficial when using 2400 bps as few printers
  590.          can keep up at that speed.  Can be toggled at any time you
  591.          are in the "T", "L" or "E" modes.    Often used to copy items
  592.          from bulletin boards, etc. that are not worth permanently
  593.          saving on disk.
  594.   ESC Z  - Clears the screen in terminal mode.    (CTL-Z normally used but
  595.          that goes on out the terminal to the remote system.)
  596.   ESC Y  - Used only in terminal mode.    If ESC R is used to temporarily
  597.          stop copying incoming text to memory, ESC Y restarts this
  598.          feature.  When copying to memory, a ';' appears in the
  599.          first column of each line.
  600.  
  601.        NOTE:  To open a file use:  COMMAND: T FILENAME.EXT <cr> and
  602.           then ESC R and ESC Y will control what is copied for
  603.           saving to disk.
  604.  
  605.   ESC R  - Stops the copy into memory, shuts off the ";" at start of
  606.          each line.  These two commands (ESC Y to start, and ESC R
  607.          to stop) control what is being saved.  When returning to
  608.          command (via ESC E), you will then be warned to save the
  609.          information to disk via the WRT command or it will likely
  610.          be lost.  (You may never use ESC R or ESC Y and just use
  611.          your editor on that file later to discard unwated magerial.
  612.  
  613.  
  614. -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -
  615.  
  616.  
  617. AUTO-DIALING AND AUTO-REDIALING:
  618. ----------------------------------------------------------------
  619.  
  620.      There are several ways to auto-dial.
  621.  
  622.       1) from the command line
  623.       2) from the phone number library line
  624.  
  625.      In addition you can auto-redial from either of these lines.  Once
  626. the number has auto-dialed and there is no answer, it will ask you if
  627. you want it to continuously auto-redial until it does receive an answer
  628. (or you decide to abort).
  629.  
  630.      To get the phone library, type CAL <ret> on the command line.  You
  631. then normally just type the appropriate character at the start of the
  632. line.  It will show the number being dialed.  You can also do this from
  633. the main command line if you know in advance what character is used for
  634. that particular number:
  635.  
  636.            B>>COMMAND: CAL P <cr>
  637.  
  638.      This calls up the "P" line in the library and dials that number,
  639. then if busy asks if you want it to continue redialing.  You can use:
  640.  
  641.            B>>COMMAND: CAL 313-749-6569 <cr>
  642.  
  643.      and it will dial the number specified.  You can then do either of
  644. these on the library command line, as well.  This gives a tremendous
  645. versatility.
  646.  
  647. NOTE:    To access the alternate long distance dialing systems (up to two
  648.     are offered), use the phone number overlay and fill in the in-
  649.     formation regarding your access number, billing number, etc.  It
  650.     will then show how to enter a special character ahead of each
  651.     phone number where alternate long distance system is desired.
  652.     This only works where touch-tone systems are in use.
  653.  
  654.  
  655. -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -
  656.  
  657. AUTO-LINKING PHONE NUMBERS:
  658. --------------------------
  659.  
  660.      If the number you want to dial is busy, you would like to have it
  661. automatically redialed until it answers.  However, you might like to
  662. call any of a group of numbers and be happy to take whichever one first
  663. becomes available.  Auto-linking allows a group of numbers to be listed
  664. and they are then continuously dialed one after the other, until one is
  665. available.
  666.  
  667.      IMP permits from 1-32 numbers to be linked together in any manner.
  668. There are two options:
  669.  
  670.        B>>COMMAND: CAL A,D,R,3,Z         1)
  671.        B>>COMMAND: CAL F,             2)
  672.  
  673.        B>>COMMAND: CAL A/D/R/3/Z         3)
  674.        B>>COMMAND: CAL F/             4)
  675.  
  676.        B>>COMMAND: CAL A,D,A,R,A,3,A,Z   5)
  677.  
  678.        B>>COMMAND: CAL F             6)
  679.  
  680.  
  681.     1) using a comma (,) will beep continuously when connected to
  682.        the first available number - touching any key stops the beep
  683.        and goes to terminal mode.
  684.  
  685.     2) just the one number is linked to itself and redials until
  686.        connected.  Beeps continuously until stopped with any key.
  687.  
  688.     3) using a slash (/) will beep only once when connected and then
  689.        automatically go directly to terminal mode - this is useful
  690.        where some mainframes such as IBM and UNIX send a logon note
  691.        assuming you are already able to copy as soon as connected.
  692.  
  693.     4) just the one number is linked to itself and redials until
  694.        connected.  Beeps only once and goes to terminal mode.
  695.  
  696.     5) illustrates how one number can be given top priority.
  697.  
  698.     6) system used previously - if connected on first try, beeps one
  699.        time and jumps directly to terminal mode.  If no connection,
  700.        asks the operator if he wants to try again or try continuous-
  701.        ly until a connected is made - at which time it beeps until a
  702.        key is depressed.
  703.  
  704. -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -
  705.  
  706.  
  707. CASCADING COMMANDS:
  708. ------------------
  709.  
  710.      Several commands may be used on the same line.  Ones normally used
  711. are:  B, D, E, K, L, Q, R, S, T, V, X and Z
  712.  
  713.      The commands have been listed previously but will be listed here
  714. again:
  715.  
  716.     B) batch mode  (must be used at both ends if used at all)
  717.         (usually only available modem-to-modem with operators
  718.         present at each end.)
  719.     D) disconnets the phone, returns to CP/M after a file transfer
  720.     E) echo mode for conversing with a system not offering echo.
  721.     K) used to manually request 1k transmissions on systems not
  722.         having automatic 1k transmissions.
  723.     L) local echo shows what you are sending if no remote echo.
  724.     Q) quiet mode, suppresses messages on local console.
  725.     R) receive file transfers (8-bit binary)
  726.     S) send file transfers, also shows transfer time.
  727.     T) terminal mode - operates computer at other end like a remote
  728.           terminal.  Also stands for "text mode".  When in "T" mode
  729.           you can copy incoming to printer or to disk, and send pre-
  730.           typed ASCII text files via CTL-T.
  731.     V) visual -- lets you see incoming ASCII files while being sent
  732.         to the disk system.
  733.     X) inhibits automatic request for 1k transmissions
  734.     Z) disconnects the phone, returns to command mode after a file
  735.         tranfer.
  736.  
  737.     NOTE:  The Baud rate is only used for the PMMI S-100 modem.
  738.            Many of the custom overlays allow use of the SET
  739.            command to change Baud rate with non-PMMI modems.
  740.  
  741. -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -
  742.  
  743.  
  744. TYPICAL PARAMETERS SHOWN BY THE "?" COMMAND:
  745. -------------------------------------------
  746.  
  747. B>>COMMAND: ? <cr>
  748.  
  749. Mode: CRC
  750. KMD batch mode
  751. Rub is backspace
  752. Printer buffer is OFF
  753. Modem speed is: 1200 bps
  754. Terminal mode file buffer is inactive
  755. Unused portion of buffer is 16384 bytes
  756. Use ESC before local command in terminal mode
  757. XOFF testing used in terminal mode file output
  758. LF NOT sent after CR in "L" or "T" for a disk file
  759.  
  760. Char. delay (terminal file mode) is:   2 ms. per character
  761. Line  delay (terminal file mode) is: 200 ms. per character
  762.  
  763. -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -
  764.  
  765.  
  766. DISCUSSION OF TYPICAL PARMETERS SHOWN BY THE "?" COMMAND:
  767. --------------------------------------------------------
  768.  
  769.      By this time, most of these parameters are self-explanatory.  They
  770. primarily show how the options and toggles have been set.  The user can
  771. check on any of the major parameters at any time by:
  772.  
  773.       1) Typing ESC E to return to command mode and
  774.       2) Typing  ?    to see the list of current parameters.
  775.  
  776. -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -
  777.  
  778.  
  779. FUNCTION KEYS:
  780. -------------
  781.  
  782.      There are 10 function keys which may be easily programmed with an
  783. external file called I2FUNC.COM in just a few moments.    It makes the
  784. changes directly to the IMP.COM file.  (There is an additional ESC L
  785. log-on selection that is programmable in your overlay.)
  786.  
  787.      To view the contents of the function keys, type 'M' for menu while
  788. on the command line and it will show the character currently used for
  789. the function key intercept.  (It will be ESC unless you select another.)
  790. You could then type that character (followed by <cr>) on the command
  791. line and it will display the entire contents of the function keys.
  792.  
  793. -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -
  794.  
  795.  
  796. CHANGING THE PHONE NUMBER LIBRARY:
  797. ---------------------------------
  798.  
  799.      The phone numbers in the library may be easily changed using an
  800. external file called I2LIB.COM.  This permits any of the 36 phone num-
  801. bers to be changed in only a few seconds.  It works directly on the
  802. IMP.COM file.  If extensive changes are to be made, you may prefer
  803. to use an overlay file called I2NM-1.ASM.  This permits using your
  804. editor to make quick and selective changes, or to substitute an entire
  805. new library.  (You may need to add or remove things like '1-' for long
  806. distance dialing in your area.)  That file also is used to set the
  807. alternate long-distance dialing routines for SPRINT, MCI, TYMNET, etc.
  808.  
  809. -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -
  810.  
  811. RETRY OPTION:
  812. ------------
  813.  
  814.      The consecutive error limit has been set to 10.  When transferring
  815. files, if this limit is reached, the file transfer will be aborted.
  816.  
  817. -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -
  818.  
  819.  
  820. INSTALLING THE PROGRAM:
  821. ----------------------
  822.  
  823.      Although this is obviously the very first thing that needs to be
  824. done, it was saved until last for several reasons.  The most important
  825. of these was the need to first explain what some of the options will do
  826. when selected.
  827.  
  828.      By this time the user should have a fairly good idea what options
  829. would work best for him.  When looking at the beginning of the program
  830. where the these are selected, it should now be rather easy to pick the
  831. ones that are most useful.
  832.  
  833.      There are various ways to change the program to suit a specific
  834. user.  You are offered several methods.  The "easy way" is to get the
  835. IMP.COM file plus the appropriate overlay for your computer.  You then
  836. edit the overlay (if needed) to suit your local needs, assemble it to
  837. get a .HEX file then use the simple instruction and DDT.COM to combine
  838. the standard IMP.COM file with your overlay.  The front end of each
  839. overlay contains all the information in the front of the IMP program.
  840.  
  841.      Generally no changes need to be made in specific overlays unless
  842. you have some particular requirement different from others using the
  843. same equipment.  (Such as the log-on message, for example.)
  844.  
  845.      You can also use DDT to change specific bytes without editing and
  846. assembling.
  847.  
  848. NOTE:    Although designed with special emphasis on the auto-dialing and
  849.     redialing capability of 1200 or 2400 bps modems using the Racal-
  850.     Vadic or 'AT' protocol developed by Hayes, the program may be
  851.     used with other modems where the operator manually dials the
  852.     number, then changes to terminal mode after connecting his modem.
  853.  
  854.  
  855. OUR THANKS TO:
  856. -------------
  857.  
  858.      A great number of people have been beta-testing this program and
  859. offering suggestions.  In particular I wish to thank Wayne Masters, Roy
  860. Robinson and Tom Brady.
  861.  
  862.      We hope this verstile program will give you hours of enjoyment and
  863. fulfill your modem needs.  It is particularly useful with the 2400 bps
  864. modems that have automatic stepdown.
  865.  
  866.                      - Irv Hoff W6FFC
  867.