home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / sigm / vol168 / mdm727.dqc / MDM727.DOC
Text File  |  1985-02-09  |  39KB  |  886 lines

  1.  
  2.                 MDM727
  3.  
  4.              (NOTES ON HOW TO USE)
  5.  
  6.                 Copyright 1983
  7.  
  8.  
  9.               Irvin M. Hoff W6FFC
  10.  
  11.                   03 Mar 1984
  12.  
  13.  
  14. NOTE:  MDM727 SUPPORTS AUTO-DIALING AND AUTOMATIC CONTINUOUS REDIALING
  15.        FOR THE FOLLOWING MODEMS:
  16.  
  17.             SIGNALMAN ANCHOR MARK XII
  18.             HAYES SMARTMODEM 300 OR 1200 MODEMS
  19.             U. S. ROBOTICS 300/1200 MODEM
  20.             PMMI 103 S-100 PLUG-IN MODEM
  21.  
  22.     IT CAN STILL BE EASILY USED WITH OTHER EXTERNAL MODEMS
  23.     ITH MANUAL DIALING SUCH AS THE BELL 212A, RACAL-VADIC,
  24.     ETC.  IT SUPPORTS UP TO TWO LONG-DISTANCE DIALING SYSTEMS
  25.     (SUCH AS 'MCI', 'SPRINT', 'TYMNET', ETC. FOR TOUCH-TONE
  26.     DIALING SYSTEMS.
  27.  
  28.  
  29. INTRODUCTION:
  30. ------------
  31.  
  32.      MDM727 enables a computer to communicate with another computer.
  33. This is normally done by using standard telephone lines but with special
  34. audio tones sending serial data.  Two common speeds are used, depending
  35. on the facilities available -- 300 Baud or 1200 Baud.  A "modem" is used
  36. which provides these audio tones.  This is an acronym for "modulator and
  37. demodulator".  The one section (modulator) provides the audio tones for
  38. sending over the telephone line and the other section (demodulator) then
  39. converts those audio tones back to digital pulses the computer uses to
  40. receive the incoming data.
  41.  
  42.      The modem itself is a hardware utility, usually costing around $75
  43. to $200 for a typical 300 Baud device and from $250 to $800 for a system
  44. offering 1200 Baud as well as 300 Baud.  Some of these (such as the PMMI
  45. S-100 modem board) plug directly into the computer itself, while others
  46. are totally independent of the computer and use an interconnect cable
  47. (usually a RS-232 type) to control the external modem.    A Bell 212A is
  48. an excellent example of this type modem.  Other examples would include
  49. the Racal-Vadic, Hayes Smartmodem, U. S. Robotics, Signalman Anchor, etc.
  50.  
  51.      The program discussed in this guide allows each computer involved
  52. to directly control its own modem, converting DC pulses into audio tones
  53. which are sent to (or received from) the telephone line.  (The standard
  54. 1200 baud transmissions use "DPSK" (dibit phase shift keying) instead of
  55. "AFSK" (audio frequency shift keying).
  56.  
  57.      For short distances, no modems are required as the computer can
  58. provide the necessary digital voltages.  This discussion is centered
  59. around systems intended for use over distances ranging from several
  60. miles to literally around the world.
  61.  
  62.  
  63.  
  64. FEATURES:
  65. --------
  66.  
  67.      A program to communicate with another computer can range from very
  68. simple to very complex.  MDM727 is one of the more complex such programs
  69. available today.  It started in 1977 as a relatively simple program.  It
  70. was called MODEM at that time.    It was intended to be used primarily as
  71. a means of exchanging programs with other people in other cities.  Since
  72. that time a number of other (very useful) features have been added, in
  73. addition to improved methods of program transfer.  A list of some of the
  74. features offered by this particular program include:
  75.  
  76.   1)  Ability to talk with another computer via keyboard at each end.
  77.       (Called the "terminal mode".)
  78.   2)  Ability to operate a remote mainframe computer such as TYM-SHAR,
  79.       or special data bank systems now commonplace.  This includes
  80.       "bulletin board" systems for receiving, sending or just read-
  81.       ing messges or other types of information.
  82.   3)  Ability to upload (send) or download (receive) programs from other
  83.       computers whether TYM-SHAR, data banks, remote hobby systems
  84.       or just another individual in another location.
  85.   4)  Ability to copy incoming information on a printer.  If the print-
  86.       er is too slow to copy the data directly, the extra characters
  87.       back into a large storage buffer until they can be printed.
  88.   5)  Ability to copy incoming data into memory for automatic transfer
  89.       to a disk file.
  90.   6)  Accomodates any computer clock speed up to 25.5 MHz. in 0.1 Mhz.
  91.       increments for uniform results.  (The clock speed is actually
  92.       of modest interest, it is only used for setting timing loops.)
  93.   7)  Advanced type of error detection (CRC or Cyclic Redundancy Check)
  94.       using automatically generated high-speed lookup tables.
  95.   8)  Ability to send any of 11 different pre-programmed function keys.
  96.       (These keys are very easy to reset, using a special external
  97.       program.)
  98.   9)  Automatic disconnect from the telephone line when using "BYE", "X"
  99.       or CTL-D.  Two other disconnect commands with the PMMI modem.
  100.  10)  This particular program has additional features of special inter-
  101.       est to those using the PMMI 103 S-100 plug-in modem, the U. S.
  102.       Robotics 300/1200, the Anchor Signalman Mark XII, the Hayes
  103.       Smartmodem 300 or 1200 (or other "Hayes-compatible" modems.
  104.       Those features basically include automatic dialing and redial-
  105.       ing (if requested) until the other computer finally answers.
  106.     
  107.            a) Automatic selection of a particular phone number from
  108.           a library of names and numbers.  (These phone numbers
  109.           can be very easily changed by using a special external
  110.           program.)
  111.            b) Automatic dialing for alternate long-distance systems
  112.           (where auto-dialing touch-tone modems are used).
  113.            c) Entry of a hand-typed number.  Although it might be as
  114.           simple to manually dial the number as hand-type it, it
  115.           can then be automatically redialed indefinitely.
  116.  
  117.  
  118. USING THE PROGRAM THE FIRST TIME:
  119. --------------------------------
  120.  
  121.      For now, we shall assume the program is ready to use on your equip-
  122. ment.  (Normally the user must make some modest changes to the program
  123. before it can be used.    This includes changing the port numbers and some
  124. other personal options.  These will be covered later in the section that
  125. describes how to adapt it to your equipment.)
  126.  
  127.      When the program is brought up is shows this display (if using the
  128. PMMI modem):
  129.  
  130.       MDM727 - (type M for Menu)
  131.       Version for PMMI S-100 modem starting at port: C0H
  132.  
  133.       B>>COMMAND: x
  134.  
  135.        The cursor stops at point "x:" waiting for some sort of command.
  136. Typing a "M" followed immediately by a RETURN, shows the first page of
  137. a 4-page help guide.  If you do not have a PMMI modem, you would have
  138. seen this (or a customized heading for your particular equipment):
  139.  
  140.       MDM727 - (type M for Menu)
  141.       Version for Non-Pmmi modem
  142.  
  143.       B>> COMMAND:
  144.  
  145.      In this case only a 3-page help guide is used, since the 4th page
  146. is used to assist those with the PMMI modem.  It tells them a little
  147. about changing from originate to answer mode, how to change Baud rates,
  148. how to disconnect, etc.
  149.  
  150.      Several commands are similar to those already used for CP/M, such
  151. as 'ERA', 'DIR' and the ability to change disk drives and user areas.
  152. This adds tremendous flexibility while remaining in the modem command
  153. mode.  To change disk drives, just say:
  154.  
  155.       B>>COMMAND: A: <RET>
  156.  
  157.      and you are in the same user area on the A: drive.  You can also
  158. say:
  159.       A>>COMMAND: A: 12 <RET>
  160.  
  161.      to change user areas.  When finished (using this example), say:
  162.  
  163.       A12>>COMMAND: CPM  <RET>
  164.  
  165.      and you will go back to CP/M with the original driver and user area.
  166.  
  167. OPTIONS:
  168. -------
  169.  
  170.      There are 6 primary options and 13 secondary options that may be
  171. typed on the command line.  In additon there are over 35 commands ranging
  172. from single character to three characters that can be used (such as DIR,
  173. ERA, LOG, etc.)  Those are listed on the menu.    (The exact number varies
  174. depending on whether you have the PMMI modem, etc.)
  175.  
  176.  
  177.      Primary Options:     E, L, M, R, S, T
  178.       E = Echo mode (special type of full duplex)
  179.       L = Local modem (no remote echo, half duplex)
  180.       M = Menu display showing features that are available
  181.       R = Receive a file from remote facility
  182.       S = Send a file to a remote facility
  183.       T = Terminal mode (full duplex, echo provived remotely)
  184.  
  185.      Secondary Options:  A, B, D, L, O, Q, R, S, V, X, 0, 1
  186.       A = Answer mode (used only by PMMI modems)
  187.       B = Batch mode -- allows automatic multiple file transfer
  188.         (This is normally only used from modem-to-modem as
  189.         no RCP/M system supports batch mode file transfers.)
  190.       D = Disconnect when done, stay in MDM727
  191.       L = Local mode when finished with a file transfer
  192.       O = Originate mode (used only by PMMI modems)
  193.       Q = Quiet mode, special purpose feature rarely used except if
  194.          operating through a "BYE" program.
  195.       R = Receive data shown on CRT during file transfer
  196.       S = Send data shown on CRT during file transfer
  197.       V = Visual inspection of an ASCII file being transferred.  Not
  198.          often used as most ASCII files are now "squeezed" for
  199.          minimum transfer time and disk space.
  200.       X = Exit to CP/M  when finished, disconnect from phone line
  201.       0 = Odd parity (PMMI modem)
  202.       1 = Even parity (PMMI modem)
  203.     
  204.  
  205.      Although you can get the following information from the help guide
  206. in MDM727, showing it here will allow us to discuss the various features
  207. in somewhat better detail.
  208.  
  209.  
  210. NOTE:    THIS PROGRAM HAS SUPPORTED THE PMMI 103 S-100 PLUG-IN MODEM SINCE
  211.     ITS INCEPTION.    IT NOW SUPPORTS THE SIGNALMAN ANCHOR MARK XII,
  212.     THE HAYES SMARTMODEM 300 AND 1200, AND THE US ROBOTICS 300/1200
  213.     MODEMS AS WELL AS OTHER HAYES-COMPATIBLE MODEMS.  IN THE FOLLOW-
  214.     ING COMMENTS, AN ASTERISK (*) BEHIND THE WORD PMMI MEANS ALL THE
  215.     COMMENT IS PERTINENT TO ALL THESE MODEMS.
  216.  
  217.   (*)  INDICATES PMMI, HAYES SMARTMODEM OR US ROBOTICS ALL APPLY.
  218.  
  219. -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -
  220.  
  221.  
  222. THE HELP GUIDE, PAGE 1:
  223. ----------------------
  224.  
  225.          Single Letter Commands
  226.  
  227. ?  - Display current settings
  228. ^  - Function key intercept character, then (0-9)
  229. M  - Display the menu
  230. E  - Terminal mode with echo
  231. L  - Terminal mode with local echo
  232. T  - Terminal mode
  233.     For copying text to disk use T (or E or L) FILENAME.TYP
  234.     Start or Stop toggles described on subsequent screen.
  235. R  - Receive CP/M file using Christensen Protocol
  236. S  - Send CP/M file using Christensen Protocol
  237.     COMMAND: R (or S) FILENAME.TYP
  238.     R and S can use the following subcommands:
  239.        B  - Bulk transfer using wildcards (e.g., *.*)
  240.        D -    Disconnect when done
  241.        Q  - Quiet mode (no messages to console)
  242.        V[R][S]  - View (R) and/or (S) bytes on console
  243.        X  - When done, disconnect, go to CP/M
  244.  
  245.      The single letter commands may also be used on the
  246.      command line when the program is initially executed.
  247.  
  248. Hit any KEY to CONTINUE
  249.  
  250. -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -
  251.  
  252.  
  253. DISCUSSION OF HELP GUIDE PAGE 1:
  254. -------------------------------
  255.  
  256.      There are basically three types of commands that may be used with
  257. this program:
  258.            1)  Single-letter commands shown on page one.
  259.            2)  Three-letter commands shown on page 2, and
  260.            3)  Control-<char.> commands shown on page 3.
  261.  
  262.      Going down the list:
  263.  
  264.   ? - shows current parameters.  As these are closely tied in with some
  265.       of the other options, we shall show a typical example later
  266.       in this discussion.
  267.   ^ - shows the function key intercept character.  This may be easily
  268.       changed using an external program.  (You may prefer 'escape'
  269.       or some seldom used control-character.)
  270.  
  271.       NOTE:  typing this character while in the command mode will
  272.          display all the programmable function key definitions
  273.          with the exception of the log-on string which uses
  274.          CTL-L.
  275.  
  276.   M - shows the menu a page at a time.    You may abort after any page is
  277.       shown with a control-C.
  278.   E - terminal mode with echo.    When talking with another terminal also
  279.       also using MDM727 (or a comparable program), one of you must
  280.       send an "echo-back" so you can both see what the other person
  281.       is typing.  This is needed for full-duplex operation.  Usually
  282.       the person originating the call will type "E" instead of "T".
  283.       However either may do this.  If "both" use the echo mode, the
  284.       program usually starts typing a string of feedback characters
  285.       since both computers are re-sending the same character over
  286.       and over.  You can stop this by just returning to command mode
  287.       (type control-E) and then retyping "T" rather than "E".
  288.   L - terminal mode with local echo.  Shows what you are typing but does
  289.       not send an echo of the other person's typing back to him.  
  290.           Can be used at both ends, in place of one person using "E".
  291.           Both "E" and "L" are useful at times for some types of modems
  292.           that do not use full-duplex, or for some main frame units that
  293.           run half-duplex.  The combination of "T", "E" and "L" gives an
  294.           excellent choice to use on various systems.  Normally the "T"
  295.           mode is sufficient except when talking with another person and
  296.           then the "E" mode at one end or "L" mode at both ends will
  297.           provide normal results.  If the remote system does not supply
  298.       a LF after a CR, you can get that from the 'TLF' command.
  299.   T - if typed as the first (primary) option, puts the program directly
  300.       into "terminal mode", allowing it to send from the keyboard to
  301.       the other computer, and to copy anything coming from the other
  302.       computer with the exception of file transfers (use "R" to re-
  303.       ceive those).
  304.   R - used only for receiving files from the other computer.  These are
  305.       usually sent in binary form with either checksum verification
  306.       or more commonly, CRC (Cyclic Redundancy Checking).  If ready
  307.       to receive another file, you have several choices, depending
  308.       on the program used by the other computer.   After notifying
  309.       him you are ready (or will be very shortly), you can type:
  310.  
  311.            B>>COMMAND: R HELLO.DOC <RET>
  312.  
  313.       and when he starts to send you will receive the program which
  314.       then goes directly to the disk when finished, or every 16K if
  315.       longer than 16K total.  You could also have said:
  316.  
  317.       Another "R" option would be:
  318.  
  319.            B>>COMMAND: RB <RET>
  320.  
  321.       This is called the "Batch mode" and is an extremely useful way
  322.       to receive programs automatically, from another computer using
  323.       a similar program.  He will use the batch mode for sending the
  324.       programs and that automatically provides the file names at the
  325.       receiving end.  In this manner, large numbers of programs can
  326.       be transferred completely automatically, including full disks.
  327.       (Assuming you care to pay the toll calls for the time it will
  328.       take!)
  329.  
  330.       NOTE:  The ideal way to receive batch mode would be:
  331.  
  332.            B>>COMMAND: RB <RET>
  333.  
  334.          since you may not know in advance how many programs he
  335.          will be sending.
  336.  
  337.            NOTE:  While receiving a file, any errors will be shown
  338.               on the console CRT, indicating that portion of the
  339.               program is being repeated.  If the file finishes
  340.               transferring normally, it will have been received
  341.               error-free.  Those error notices are merely to let
  342.               the user know a momentary problem caused a resend.
  343.               The error messages indicate phone line quality.
  344.  
  345.   S - Send programs.  Similar to "R" but sends instead of receives.  If
  346.       the other system is ready to receive, you can type:
  347.  
  348.            B>>COMMAND: S HELLO.DOC <RET>
  349.  
  350.       It will tell you how many records are involved and how many
  351.       minutes and seconds it will take to send the program.  If the
  352.       other system is ready to receive, it starts the transfer,
  353.       showing how many records have been sent.  If any errors occur
  354.       during transmission, it shows what they are and counts them.
  355.       It will resend any records not correctly received at the other
  356.       computer.  If too many consecutive errors occur (normally set
  357.       at 10), the transfer is terminated.  The batch mode may also
  358.       be used for sending:
  359.  
  360.            B>>COMMAND: SB HELLO.*
  361.  
  362.       will send all files starting with HELLO, or can send just one
  363.       file, or can send several non-related files in this manner:
  364.  
  365.            B>>COMMAND: SB HELLO.DOC XDIR.COM TERM.*
  366.  
  367.       etc.    Be sure to put a space between the various files.  You
  368.       can include the 'X' option:
  369.  
  370.            B>>COMMAND: SBX HELLO.* MDM727.LBR MDM727.AQM
  371.  
  372.       When the file transfer is completed it disconnects from the
  373.       phone line and reverts to CP/M.  This allows you to be absent
  374.       when the file is finished, offering an advantage when sending
  375.       lengthy files.
  376.  
  377. -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -
  378.  
  379.  
  380. THE HELP GUIDE, PAGE 2:
  381. ----------------------
  382.  
  383.         Three Letter Commands
  384.  
  385. CPM - Exit from this program to CP/M
  386. DIR - List directory and space free (may specify drive)
  387. ERA - Erase file (may specify drive)
  388. LOG - Change default drive/user no. (specify drive/user)
  389.       and reset disks.    e.g. LOG A0: or LOG B: (user # unchanged)
  390. SPD - Set speed of file output in terminal mode
  391. TIM - Select Baud rate for "time-to-send" message
  392. TCC - Toggle CRC/Checksum mode on receive
  393. TLC - Toggle local command immediate or after CTL-
  394. TLF - Toggle LF after CR in "L" or "T" mode for a disk file
  395. TXO - Toggle XOFF testing in terminal mode file output
  396. NUM - List remote systems
  397. SET - Set modem baud rate
  398. BYE - Disconnect, then return to CP/M
  399. CAL - Dial number
  400. DSC - Disconnect from the phone line
  401.  
  402.       The following are terminal text buffer commands:
  403.  
  404. DEL - Delete memory buffer and file
  405. WRT - Write memory buffer to disk file
  406.  
  407. Hit any KEY to CONTINUE
  408.  
  409. -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -
  410.  
  411.  
  412. DISCUSSION OF HELP GUIDE, PAGE 2:
  413. --------------------------------
  414.  
  415.   CPM - This returns to normal CP/M use, abandoning MDM727.
  416.       CAUTION: It does not disconnect the modem from the phone line.
  417.   DIR - Enables the user to see the library of any disk without needing
  418.       to return to CP/M first.  Can be adjusted when installing the
  419.       program to show 3, 4, or 5 groups depending on the width of
  420.       your CRT display.  Normally set to 5 for 80-column displays.
  421.       Shows the amount of disk spacing remaining on the logged-in
  422.       default drive.  (You must log in any drive you wish to write
  423.       on, or to see the correct free disk space remaining.)  See the
  424.       LOG feature below.
  425.   ERA - Enables the user to erase any files from any disk without the
  426.       need to return to CP/M first.  Wild cards (* and ?) accepted.
  427.   LOG - When a new disk is inserted, you can see the directory and read
  428.       files from it but cannot write to it without getting a "BDOS
  429.       ERR".  This command allows you to log in a new disk so you can
  430.       immediately write on it without first returning to CP/M for a
  431.       warm boot.  You can select drive and user number.  (This also
  432.       enables DIR to show the correct free disk space remaining.)
  433.       You can say:
  434.              LOG <RET> for same drive, user area, new disk
  435.              LOG A
  436.              LOG A:
  437.              LOG A14     (user areas are 0-15)
  438.              LOG A11:
  439.  
  440.   SPD - Sets the delay between characters and/or delay between lines in
  441.       the "T" mode when using control-T to upload a pre-typed file.
  442.       Since most bulletin boards and TYM-SHAR systems normally use
  443.       line editors that require a delay after they have received a
  444.       line, you can add delay between characters (in increments of
  445.       10 ms.) and/or enter delay between lines (in increments of 100
  446.       ms.).  This is preset for most systems at 50 and 500 ms.  They
  447.       can be changed at any time.  Current values can be checked by
  448.       using the  " ? " command.
  449.   TIM - This option lets you set the file transfer time from 110 Baud to
  450.       9600 Baud.  You can preset it (when installing the program) to
  451.       the value normally used, but at times it is nice to be able to
  452.       conveniently change the time shown to a different rate.  Some
  453.       initialization routines (discussed in the install section) can
  454.       make this change automatically.  This command does not show if
  455.       using the PMMI* board as the speed is automatically changed to
  456.       agree with the current Baud rate selection.  It also does not
  457.       show if the custom overlay uses the SET command to choose var-
  458.       ious Baud rates as the transfer time is changed automatically.
  459.   TCC - Most modem programs originally used simple checksum verification
  460.       of received sectors.    Most now use Cyclic Redundancy Checking
  461.       which finds certain transmission errors the simple checksum
  462.       system might overlook.  This toggle allows the user to select
  463.       checksum for those systems known to not offer CRC.  When set
  464.       normally to CRC, the program automatically switches to check-
  465.       sum after trying several times to use CRC.
  466.   TLC - Nearly all computers use "control-characters" to do various
  467.       tasks such as move the cursor around, clear the screen, reboot
  468.       the system, etc.  You might want to send a control-E character
  469.       to the local computer and not have it go to the remote system
  470.       at the same time.  Say a moment later you would like to send a
  471.       control-E only to the remote computer.  You would do this:
  472.  
  473.            control-E          (goes to local computer only)
  474.            control-^ control-E    (goes to the remote computer only)
  475.  
  476.       You can reverse the TLC toggle causing this response:
  477.  
  478.            control-E          (goes to remote computer only)
  479.            control-^ control-E    (goes to the local computer only)
  480.  
  481.       All other control-chars. would operate in a similar manner.
  482.       This gives extra flexibility in using this program for special
  483.       systems like TYM-SHAR, etc.
  484.  
  485.       NOTE:  If using control-^ is awkward, you can pick a different
  486.          character when installing the program initially.
  487.  
  488.   TLF - If sending a file while in terminal mode (via CTL-T option) most
  489.       mainframe computers will not want you to send a line feed.  As
  490.       all editors include the LF after CR, you have the option with
  491.       this toggle of sending or not sending a line feed.  If typing
  492.       manually in the "T" mode, you can get a line feed with CTL-J.
  493.       It is automatically included after CR with "L" or "E" modes.
  494.   TXO - Used when uploading pre-typed text files to other systems such
  495.       as TYM-SHAR or bulletin boards, etc.    Most of those have line
  496.       editors that take a moment to move the line you just finished
  497.       from their edit buffer into memory.  The XOFF character halts
  498.       your system from sending until it is ready for a new line.
  499.       Used only in the terminal mode.
  500.   NUM - Not shown if using PMMI*.  This shows the non-PMMI* people the
  501.       phone library numbers which can be used for manual dialing.
  502.   SET - Not shown if using PMMI, or if SETUPR is set to "NO" (indicating
  503.       no user routine in the overlay for choosing different speeds.)
  504.   BYE - Disconnects the modem from the phone line, closes any file that
  505.       may be open and returns to CP/M.
  506.   CAL - PMMI* command, shows the phone library for auto-dialing.  If not
  507.       using a PMMI*, this will not be shown, instead NUM is shown.
  508.       It displays the telephone library.  (Non-PMMI users will find
  509.       the NUM display beneficial as it can display useful phone num-
  510.       bers for manual dialing.)
  511.  
  512.     NOTE:  Use the phone number overlay to easily change the numbers
  513.            that are stored.  This overlay also accesses up to two
  514.            alternate long distance dialing systems for the touch-
  515.            tone auto-dialing modems.
  516.  
  517.   DSC - Disconnects the modem from the phone line whenever selected.
  518.   DEL - If copying incoming information into memory, and you decide you
  519.       do not want to bother saving it to disk after all, this closes
  520.       (and then deletes) the disk file you had opened.
  521.   WRT - saves what you have been copying to the disk file already opened
  522.       for that purpose.  When returning from the "T" mode to command
  523.       mode, a warning is shown that you may lose what has been saved
  524.       unless you use WRT (write to disk).
  525.  
  526. -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -
  527.  
  528.  
  529. THE HELP GUIDE, PAGE 3:
  530. ----------------------
  531.  
  532.   Local Commands while in Terminal Mode
  533.  
  534.   CTL-@  - Send a break tone for 300 ms.
  535.   CTL-B  - Change Baud rate
  536.   CTL-E  - Exit to command mode
  537.   CTL-L  - Send log-on message
  538.   CTL-N  - Disconnect from the phone line
  539.   CTL-P  - Toggle printer
  540.   CTL-Y  - Start copy into buffer
  541.   CTL-R  - Stop copy into buffer
  542.  
  543.         Start & Stop may be toggled as often as desired.
  544.         A ":" at start of line indicates buffer is copying.
  545.         XOFF automatically used to stop input when writing
  546.            full buffer to disk, XON sent to resume.
  547.  
  548.   CTL-T  - Transfer ASCII file to remote
  549.  
  550.   CTL-^  - Send local control character to remote
  551.  
  552. -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -
  553.  
  554.  
  555. DISCUSSION OF HELP GUIDE, PAGE 3:
  556. --------------------------------
  557.         
  558.   CTL-@  - Sends a break character to the other computer.  Used in some
  559.          TYM-SHAR systems, etc.  (Used only in PMMI mode)
  560.   CTL-B  - PMMI command, changes the Baud rate from 110-710, in addition
  561.          changes the file transfer time accordingly.
  562.   CTL-E  - Returns to command modem from "T", "L", "E" modes.
  563.   CTL-L  - Will send the log-on message if TRANLOGON is set YES and a
  564.          message has been included in the LOGON area.  Can use this
  565.          feature to sign on various bulletin board systems, although
  566.          that would require an identical password on each.
  567.   CTL-N  - Disconnect the modem from the phone line.  (CTL-D had been
  568.          used for this command, but it was too easy to accidently
  569.          type CTL-D when expecting to hit CTL-S or CTL-E or CTL-X.
  570.          You can easily change this to whatever you like in the
  571.          overlay you use for your equipment.)
  572.   CTL-P  - Toggles the printer on-off.    Very useful feature.  Similar to
  573.          normal control-P but in this case if the modem is running
  574.          faster than normal printer speed, the characters just back
  575.          into a special buffer while the printer tries to catch up.
  576.          Most dot matrix printers are considerably faster than most
  577.          telephone modems, however.  Can be toggled at any time you
  578.          are in the "T", "L" or "E" modes.    Often used to copy items
  579.          from bulletin boards, etc. that are not worth permanently
  580.          saving on disk.
  581.   CTL-Y  - Used only in terminal mode.    If a file was opened prior to
  582.          going to "T" (terminal) mode, nothing will be saved until
  583.          control-Y is typed.  This places a ";" (semicolon) at the
  584.          start of each new line, indicating the memory is "hot" and
  585.          is now copying for saving to a file.  You can toggle this
  586.          off by using control-R.
  587.  
  588.        NOTE:  To open a file use:  COMMAND: T FILENAME.EXT <cr> and
  589.           then CTL-Y and CTL-R will control what is copied to
  590.           be placed in that file.
  591.  
  592.   CTL-R  - Stops the copy into memory, shuts off the ";" at start of
  593.          each line.  These two commands (CTL-Y to start, and CTL-R
  594.          to stop) control what is being saved.  When returning to
  595.          command (via CTL-E), you will then be warned to save the
  596.          information to disk via the WRT command or it will likely
  597.          be lost.  (You may never use CTL-R although CTL-Y is re-
  598.          quired to commence saving to memory for the disk file you
  599.          previously opened.)
  600.  
  601.             (These commands -- CTL-P, CTL-Y and CTL-R give
  602.             MDM727 tremendous versatility.  You can copy
  603.             incoming data either to disk or to printer (or
  604.             both).  My own printer is a 300 Baud Teletype
  605.             Corporation Model 43, yet it works great when I
  606.             am using the Bell 212A at 1200 Baud.  The printer
  607.             falls behind, but misses nothing as it eventually
  608.             catches up with the contents of the large buffer.)
  609.  
  610. -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -
  611.  
  612.  
  613. THE HELP GUIDE, SPECIAL PMMI PAGE:
  614. ---------------------------------
  615.  
  616.       Additional Subcommands for PMMI Modems
  617.  
  618. Modem control:
  619.   A - Answer tone for send or receive
  620.   O - Originate tone for send or receive
  621.  
  622. Parity options:
  623.   1 - Set and check for odd parity
  624.   0 - Set and check for even parity
  625.      Both ends must be capable of these options
  626.      which are available only in R and S modes.    
  627.      The parity checking will be part of the
  628.      file transfer protocol.
  629.  
  630. Speed Options:
  631.       After entering your primary and secondary options,
  632.       you can set the modem speed by placing a "." after
  633.       the options followed by the speed e.g., 300, 1200.
  634.  
  635.       EXAMPLE:    SBOT.600 will set the modem for 600 baud
  636.  
  637.  
  638. Hit any KEY to CONTINUE
  639.  
  640. -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -
  641.  
  642.  
  643. DISCUSSION OF HELP GUIDE, SPECIAL PMMI PAGE:
  644. -------------------------------------------
  645.  
  646.      When using MDM727 with the PMMI board, you will either dial out or
  647. (far less likely) answer some incoming call.  Since the unit will be in
  648. "originate mode" about 98% of the time, it is set to automatically come
  649. up in the originate mode at default speed (300 Baud) whenever a call has
  650. been completed.  If you want to use answer mode, you need to use the "A"
  651. command.  If a speed is not included, it will stay at the default speed.
  652.  
  653.      Until a connection has been made, there are no tones applied to the
  654. line.  Originate tones at 300 Baud are automatically added at that time.
  655.  
  656.      In addition to telling the PMMI modem if it should use originate or
  657. answer tones, you can tell it what Baud rate to use.  A typical command
  658. (once connection is made to another modem) would be:
  659.  
  660.            B>>COMMAND: TO.600 <RET>
  661.  
  662.      This puts the tones on the phone line for originate and at the
  663. same time sets the PMMI board for 600 Baud.   Another typical response
  664. might be:
  665.  
  666.            B>>COMMAND: RABT.450 <RET>
  667.  
  668.      This places the answer tones on the phone line, sets the program
  669. for receiving batch mode at 450 Baud and returns to terminal mode when
  670. the transfer is completed.
  671.  
  672.      Other optional PMMI commands seem self-explanatory, such as dis-
  673. connect, etc.
  674.  
  675. -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -
  676.  
  677.  
  678. PMMI, HAYES AND ROBOTICS AUTO-DIALING AND AUTO-REDIALING:
  679. --------------------------------------------------------
  680.  
  681.      There are several very useful and versatile features offered for
  682. the PMMI, Hayes Smartmodem and Robotics users.    These include alternate
  683. long distance dialing systems.
  684.  
  685.      There are several ways to auto-dial.
  686.  
  687.       1) from the command line
  688.       2) from the phone number library line
  689.  
  690.      In addition you can auto-redial from either of these lines.  Once
  691. the number has auto-dialed and there is no answer, it will ask you if
  692. you want it to continuously auto-redial until it does receive an answer
  693. (or you decide to abort).
  694.  
  695.      To get the phone library, type CAL <ret> on the command line.  You
  696. then normally just type the alphabetic character at the start of the ap-
  697. propriate line.  It will show the number being dialed.    You can also do
  698. this from the main command line if you know in advance what alphabetic
  699. character is associated with that particular number:
  700.  
  701.            B>>COMMAND: CAL P <RET>
  702.  
  703.      This calls up the "P" line in the library and dials that number,
  704. then if busy asks if you want it to continue redialing.  You can use:
  705.  
  706.            B>>COMMAND: CAL 313-749-6569 <RET>
  707.  
  708.      and it will dial the number specified.  You can then do either of
  709. these on the library command line, as well.  This gives a tremendous
  710. versatility.
  711.  
  712. NOTE:    To access the alternate long distance dialing systems (up to two
  713.     are offered), use the phone number overlay and fill in the infor-
  714.     mation regarding your access number, billing number, etc.  It
  715.     will then show how to enter a special character ahead of each
  716.     phone number where alternate long distance system is desired.
  717.     This only works where touch-tone systems are in use.
  718.  
  719. -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -
  720.  
  721.  
  722. CASCADING COMMANDS:
  723. ------------------
  724.  
  725.      Several commands may be used on the same line.  Ones normally used
  726. are:  A, B, D, E, L, O, Q, R, S, T, V, X (and Baud rate if PMMI).
  727.  
  728.      A typical PMMI selection might be: RABQ.300
  729.  
  730.      The commands have been listed previously but will be listed here
  731. again:
  732.  
  733.     A) answer tones for PMMI S-100 modem, puts tones online.
  734.     B) batch mode  (must be used at both ends if used at all)
  735.         (usually only available modem-to-modem with operators
  736.         present at each end.)
  737.     E) echo mode for conversing with a system not offering echo.
  738.     L) local echo shows what you are sending if no remote echo.
  739.     O) originate tones for PMMI S-100 modem, puts tones online.
  740.     Q) quiet mode, suppresses messages on local console.
  741.     R) receive file transfers with CRC or checksum protocol.
  742.     S) send file transfers, also shows transfer time.
  743.     T) terminal mode - operates computer at other end like a remote
  744.           terminal.  Also stands for "text mode".  When in "T" mode
  745.           you can copy incoming to printer or to disk, and send pre-
  746.           typed ASCII text files via CTL-T.
  747.     V) visual -- lets you see incoming ASCII files while being sent
  748.           to the disk system.
  749.  
  750.     NOTE:  The Baud rate is only used for the PMMI S-100 modem.
  751.            Many of the custom overlays allow use of the SET
  752.            command to change Baud rate with non-PMMI modems.
  753.  
  754. -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -
  755.  
  756.  
  757. TYPICAL PARAMETERS SHOWN BY THE "?" COMMAND:
  758. -------------------------------------------
  759.  
  760. B>>COMMAND: ? <RET>
  761.  
  762. Mode: CRC
  763. Printer is OFF
  764. Backspace is backspace
  765. Modem speed is 300 baud
  766. Terminal mode file buffer is inactive
  767. Unused portion of buffer is 16384 bytes
  768. Use CTL-^ to send local command to remote
  769. LF NOT sent after CR in "L" or "T" for a disk file
  770. XOFF testing NOT used in terminal mode file output
  771. XON NOT automatically tested after CR in terminal mode file output
  772.  
  773. Char. delay (terminal file mode) is:  50 ms. per character
  774. Line  delay (terminal file mode) is: 500 ms. per character
  775.  
  776. -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -
  777.  
  778.  
  779. DISCUSSION OF TYPICAL PARMETERS SHOWN BY THE "?" COMMAND:
  780. --------------------------------------------------------
  781.  
  782.      By this time, most of these parameters are self-explanatory.  They
  783. primarily show how the options and toggles have been set.  The user can
  784. check on any of the major parameters at any time by:
  785.  
  786.       1) Typing control-E to return to command mode and
  787.       2) Typing  ?    to see the list of current parameters.
  788.  
  789. -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -
  790.  
  791.  
  792. FUNCTION KEYS:
  793. -------------
  794.  
  795.      There are 10 function keys which may be easily programmed with an
  796. external file called M7FNK1.COM in just a few moments.    It makes the
  797. changes directly to the MDM727.COM file.  (There is an additional CTL-L
  798. log-on selection that is programmable in your overlay.)
  799.  
  800.      To view the contents of the function keys, type 'M' for menu while
  801. on the command line and it will show the character currently used for
  802. the function key intercept.  (It will be '^' unless you select another.)
  803. You could then type that character (followed by <CR>) on the command
  804. line and it will display the entire contents of the function keys.
  805.  
  806. -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -
  807.  
  808.  
  809. CHANGING THE PHONE NUMBER LIBRARY:
  810. ---------------------------------
  811.  
  812.      The phone numbers in the library may be easily changed using an
  813. external file called M7LIB.COM.  This permits any of the 36 phone num-
  814. bers to be changed in only a few seconds.  It works directly on the
  815. MDM727.COM file.  If extensive changes are to be made, you may prefer
  816. to use an overlay file called M7NM-6.ASM.  This permits using your
  817. editor to make quick and selective changes, or to substitute an entire
  818. new library.  (You may need to add or remove things like '1-' for long
  819. distance dialing in your area.)  That file also is used to set the
  820. alternate long-distance dialing routines for SPRINT, MCI, TYMNET, etc.
  821.  
  822. -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -
  823.  
  824.  
  825. INSTALLING THE PROGRAM:
  826. ----------------------
  827.  
  828.      Although this is obviously the very first thing that needs to be
  829. done, it was saved until last for several reasons.  The most important
  830. of these was the need to first explain what some of the options will do
  831. when selected.
  832.  
  833.      By this time the user should have a fairly good idea what options
  834. would work best for him.  When looking at the beginning of the program
  835. where the these are selected, it should now be rather easy to pick the
  836. ones that are most useful.
  837.  
  838.      There are various ways to change the program to suit a specific
  839. user.  These are discussed to a modest extent in the information file
  840. called MDM727.INF.  You are offered several methods.  The "easy way" is
  841. to get MDM727.COM plus the appropriate overlay for your computer.  You
  842. then edit the overlay (if needed) to suit your local needs, assemble it
  843. to get a .HEX file then use the simple instruction and DDT.COM to com-
  844. bine the standard MDM727.COM file with your overlay.  The front end of
  845. each overlay contains all the information in the front of the MDM727
  846. source code itself.  (Read the special message that gives the latest
  847. information and tells how many sectors to SAVE, the illustration says
  848. 66 sectors, but the program has grown since that time.)
  849.  
  850.      Generally no changes need to be made in specific overlays unless
  851. you have some particular requirement different from others using the
  852. same equipment.  (Such as the log-on message, for example.)  You may
  853. also wish to say "YES" to the SMARTMODEM question, which might be
  854. currently set "NO".
  855.  
  856.      The "hard way" would be to get the MDM727.ASM source code and then
  857. edit it to suit.  This is likely to be quite unsatisfactory for most
  858. users as it will not contain the information peculiar to your computer
  859. (which is in the individual overlay you select otherwise.)
  860.  
  861.      Thus various methods are available, one of which should provide the
  862. easiest method for your system. 
  863.  
  864. NOTE:    Although designed with special emphasis on the auto-dialing and
  865.     redialing capability of the PMMI, Hayes Smartmodem or Robotics,
  866.     it works quite well on non-PMMI modems.    In the author's system
  867.     a stock Bell 212A Dataphone is used together with a normal ser-
  868.     ial I/O that can be programmed to easily switch from 300 to 1200
  869.     Baud.  A great variety of other computers and modems can use this
  870.     same program quite easily.  This is one of the the most versatile
  871.     phone modem programs currently available for CP/M users.
  872.  
  873. OUR THANKS TO:
  874. -------------
  875.  
  876.      A great number of people have contributed to the growth of this
  877. program since 1977.  Two people have been particularly helpful to me in
  878. developing the MDM700 series modem programs:  Keith Petersen (W8SDZ)
  879. and Frank Gaude' (ex-K6IBE).  Their help and interest have been greatly
  880. appreciated.
  881.  
  882.      We hope this verstile program will give you hours of enjoyment and
  883. fulfill your modem needs.
  884.  
  885.                      - Irv Hoff W6FFC
  886.