home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / sigm / vol175 / modem9xx.doc < prev    next >
Encoding:
Text File  |  1985-02-10  |  40.3 KB  |  1,067 lines
  1. Thσ followinτ documentatioε i≤ fo≥ thσ CP/M-8░ versioε oµ MODEM9« ì
  2.  
  3. Thσ CP/M-8╢ versioε i≤ almos⌠ identical¼ bu⌠ thσ sizσ oµ thσ tex⌠ ì
  4. capturσá buffe≥á i≤ fixeΣ a⌠ 16╦ (yo⌡ caε makσ i⌠ large≥á iµá yo⌡ ì
  5. wan⌠ to⌐ rathe≥ thaε beinτ selµ sizinτ t∩ thσ basσ oµ thσ CP/M-8░ ì
  6. BDOS«
  7.  
  8. Fo≥á additiona∞á informatioε abou⌠ thσ CP/M-8╢á versioεá seσá thσ ì
  9. (hopefully⌐ accompanyinτ filσ MODEM-86.DOC. Bill Bolton
  10.  
  11. Credit where credit is due department. . .
  12. *******************************************************************
  13. ***                                ***
  14. ***  MODEM9XX.DOC  Documentation for CP/M User's Group Program. ***
  15. ***                                ***
  16. ***           This expands on the info in MODEM7.DOC.    ***
  17. ***           January 11, 1983. Tom McCormick, Houston TX  ***
  18. ***                                ***
  19. ***           Updated for use with MODEM797 enhancements.    ***
  20. ***           February 14, 1983. Paul Sittler, Coll Sta TX ***
  21. ***                                ***
  22. ***           Updated for use with MODEM9xx enhancements.    ***
  23. ***           March 20, 1983. P. L. Kelley, Lexington, MA  ***
  24. ***                                ***
  25. *******************************************************************
  26.  
  27. NOTE: The xx in MODEM9xx stands for the last two digits in the ver-
  28. sion number.
  29.  
  30.                  CREDITS:
  31.  
  32. Original MODEM program and documentation by Ward Christensen.
  33.  
  34. Revisions by a cast of thousands.
  35.  
  36. MODEM7.DOC by Mark Zeiger/James Mills  11/04/80.
  37.  
  38. MODEM797.HLP by Paul Sittler/Tom McCormick 3/1/83.
  39.  
  40.                   SUMMARY:
  41.                   --------
  42.      MODEM9xx  is a public domain CP/M program which works on  many 
  43. different brands of computers.    It is used to send information from 
  44. one  computer  to another,  using either wires or  telephones.     If 
  45. telephones  are  used,    each computer must use    a  hardware  device 
  46. called a "modem",  hence the name for this program.  It may also be 
  47. used with two computers in the same room cabled directly together.
  48.  
  49.      Unlike most CP/M programs,  MODEM9xx must be modified for each 
  50. different  brand  of computer on which it is  installed.   This  is 
  51. because  MODEM9xx does not use CP/M in a normal way,  but  communi-
  52. cates directly with the modem port of your computer (bypassing CP/M 
  53. for some functions). 
  54.  
  55.      You  should  locate a copy of MODEM9xx which has already  been 
  56. èset up for your model of computer. If you can't find a copy already 
  57. configured for your computer,  you should seek assistance in confi-
  58. guring MODEM9xx to some new or non-standard equipment.    This can be 
  59. done through your computer dealer,  or a user's group in your area.  
  60. It  would  also  be  helpful to have someone show you  how  to    use 
  61. MODEM9xx the first time.
  62.  
  63.      MODEM9xx uses  the  file transfer routines  written  by   Ward
  64. Christensen  in his CP/M file transfer program (V2.0 as of  8/6/79)  
  65. and  is  compatable with his program in single file transfer  mode. 
  66.  
  67.      Multi-file  transfers  are possible with two  systems  running  
  68. the program described below.  This is provided by the batch feature  
  69. while  <S>ending  or <R>eceiving files with the <B>ulk    subcommand.  
  70. It  is accomplished with a single line command,  thus  freeing    the 
  71. operator from having to enter a command for each file.
  72.  
  73. The MODEM9xx program has two principal functions:
  74.  
  75.      1.  Communication with a timesharing or another CP/M computer.
  76.      2.  Program transfer with error-checking checksum control.
  77.  
  78.         NOTE: A special version of the MODEM program exists for
  79.           the DC Hayes Smartmodem (an external, RS-232 modem).
  80.           This can be found under filenames beginning with
  81.           SMODEM, SMODM, SMDM, or SMOD.
  82.  
  83.                How to Use MODEM9xx
  84.  
  85.      In the discussion and examples that follow,  where examples of 
  86. user/computer interaction are used, that which is typed by the user 
  87. is  underlined    with the hyphen (-) symbol on the line beneath    it.  
  88. Those  items that are supplied by the computer are simply typed  as 
  89. they would appear on the screen.   As another convention,  the sym-
  90. bols <CR> denote the entry of a carriage return, and CTRL-S is used 
  91. to mean "hold the control key down while hitting an S."
  92.  
  93.      MODEM9xx  is  a CP/M command file,  and will  ordinarily  look 
  94. something  like MODEM9xx.COM in a directory.   In order to use    it, 
  95. the  system  should have CP/M running and display the  CP/M  system 
  96. command  prompt  (  A> ) being displayed.   We    are  assuming  that 
  97. MODEM9xx.COM is on drive A:.  MODEM9xx signs on very politely, with 
  98. a  short sign-on message,  and the reminder that to get  Help,    you 
  99. need only to type "H."
  100.  
  101. A>MODEM9xx<CR>
  102.   ------------
  103. MODEM 9.xx - 03/20/83
  104. Version for: Heath H89  
  105.  
  106. Drive A
  107. COMMAND (H for Help): 
  108.  
  109. Drive A
  110. COMMAND (H for Help): H<CR>
  111. è              -----
  112.  
  113. "H" option -- <H>elp Screens
  114.  
  115.      If  the <H>elp option is entered at the  command  prompt,    the 
  116.      <H>elp Screens are displayed.  These three screens of informa-
  117.      tion  outline the options available to the user,  and  provide 
  118.      brief explanations of each.   The <H>elp screens have a prompt 
  119.      that indicates that the user should press any key to continue.  
  120.      These  are  not  "Menus"  and commands must be  given  at    the 
  121.      COMMAND (H for Help): prompt.
  122.  
  123.            Single Letter Commands
  124.  
  125.  H  - Display this information
  126.  ?  - Display current settings
  127.  T  - Terminal mode
  128.  E  - Terminal mode with echo
  129.  L  - Terminal mode with local echo
  130.      For capturing text use T(or E or L) FILENAME.TYP and
  131.      Start & Stop toggles described on subsequent screen.
  132.  R  - Receive file using Christensen Protocol
  133.  S  - Send file using Christensen Protocol
  134.      Command is: R(or S) FILENAME.TYP
  135.      R and S can use the following subcommands:
  136.       B  - Bulk transfer using wildcards (e.g. *.*)
  137.       Q  - Quiet mode (no messages to console)
  138.       T  - Return to terminal mode after transfer
  139.       V  - View bytes transferred on console
  140. The single letter commands may also be used on the
  141. command line when the program is initially executed.
  142.  
  143. HIT any KEY to CONTINUE<CR>
  144.                ----
  145.  
  146.            Three Letter Commands
  147.  
  148. CPM - Exit from this program to CP/M
  149. DIR - List directory and space free (may specify drive)
  150. ERA - Erase file (may specify drive)
  151. LOG - Change default drive/user (specify drive/user)
  152.       and reset disks.    e.g. LOG A0, LOG B (user unchanged)
  153. FOP - Display commands for setting terminal mode file
  154.       output parameters
  155. DSC - Disconnect the modem from the telephone line
  156. TCC - Toggle Checksum/CRC mode on receive
  157. TBR - Toggle backspace to rub conversion
  158. TLC - Toggle  1) local command immediate
  159.           2) local command after ctrl-^
  160. TLF - Toggle send linefeed after carriage return
  161. NUM - List remote systems
  162. SET - Set communication ports
  163.  
  164.     The following are terminal text buffer commands:
  165. DEL - Delete memory buffer and file
  166. èNOL - Return to terminal mode - no loss of data in buffer
  167. WRT - Write memory buffer to disk file
  168.  
  169. HIT any KEY to CONTINUE<CR>
  170.                ----
  171.  
  172.      Local Commands while in Terminal Mode
  173.  
  174. ctrl-E    - Exit to command mode
  175. ctrl-O  - Transmit string',CR,LF
  176.      Must be followed by number of string (0-9)
  177.      or L to display list of strings
  178. ctrl-P    - Toggle printer
  179. ctrl-Y    - Start copy into buffer
  180. ctrl-R    - Stop copy into buffer
  181.      Start & Stop may be toggled as often as desired.
  182.      A ":" at start of line indicates buffer is open.
  183.      XOFF automatically used to stop input when writing
  184.      full buffer to disk, XON sent to resume.
  185. ctrl-T    - Transfer ASCII file to remote
  186. ctrl-^    - Send local control character to remote
  187.  
  188. Drive A
  189. COMMAND (H for Help):
  190.  
  191.      At  this  point MODEM9xx has completed its  hopefully  helpful 
  192. three-screen display and is awaiting your command. The SET  command
  193. will  not be displayed if a setup routine has not been  written for
  194. your UART/MODEM, an alternate command will be dispalyed, TIM, which
  195. allows  you to enter your modem speed so that the program can  give
  196. proper file transfer timing information. The control codes display-
  197. ed  may differ from  those give above  since the user can  redefine
  198. them. We will now enter the second option on the first help screen,
  199. the "?" option.
  200.  
  201. Drive A
  202. COMMAND (H for Help): ?<CR>
  203.               -----
  204.  
  205.           Current Settings
  206.  
  207. CRC mode set
  208. Printer is off
  209. Carrier not present
  210. Modem speed is 300 baud
  211. Backspace is backspace
  212. Linefeed NOT sent after <CR>
  213. Use ctrl-^ to send local command to remote
  214. Terminal mode file buffer is inactive
  215. Unused portion of buffer is 36608 bytes
  216. Word length is eight, number of stop bits is one, parity is none
  217. Linefeed NOT sent after <CR> in terminal mode file output
  218. End-of-file character NOT sent in terminal mode file output
  219. XOFF testing NOT used in terminal mode file output
  220. XON NOT automatically tested after <CR> in terminal mode file output
  221. èWaiting for character echo NOT used in terminal mode file output
  222. Terminal mode file output delay is 0.00 seconds per character
  223. Additional delay after <CR> is 0.00 seconds
  224.  
  225.  
  226. Drive A
  227. COMMAND (H for Help): 
  228.  
  229.      The  screen is now displaying options as currently  set up  in
  230. the  program as well as other information on the the current  state
  231. of  the program. The options may be changed as the user desires  by 
  232. use  of some of the  three letter  commands  displayed in  the help 
  233. screen earlier. There is a special help screen for setting terminal
  234. mode file output parameters. We will now display this screen.
  235.  
  236. Drive A
  237. COMMAND (H for Help): FOP<CR>
  238.               -------
  239.  
  240.      Commands for Setting Terminal Mode File Output Parameters
  241.  
  242. SPD - Set speed of file output
  243. TEF - Toggle transmission of end-of-file character
  244. TSL - Toggle stripping linefeeds
  245. TWE - Toggle wait for character echo
  246. TXF - Toggle XOFF testing
  247. TXN - Toggle XON waiting after <CR>
  248.  
  249. Drive A
  250. COMMAND (H for Help): 
  251.  
  252.  
  253. Drive A
  254. COMMAND (H for Help): T<CR>
  255.               -----
  256.      In  MODEM9xx there are three different terminal  modes.   They 
  257. are  all used to communicate with other computers.   They  are    all 
  258. slightly  different to allow the user a great degree of flexibility 
  259. in  picking the proper one for the job at hand.   All three may  be 
  260. opened    with an optional file name for capturing text (ASCII)  data 
  261. and saving it as a disk file.  
  262.  
  263. Terminal Mode - <T>erminal Option
  264. ---------------------------------
  265.  
  266.       This    is the "normal" terminal mode wherein the  computer 
  267.      is used essentially to emulate a time sharing  terminal.    You 
  268.      will  be  able  to use your computer as if it  were  a  normal 
  269.      terminal  in full duplex mode.   The characters that you  type 
  270.      will  not be printed to the screen as you enter them,  but the 
  271.      screen  will display whatever is sent to it by  the  computer.  
  272.      This  is  the  way  to use your computer  with  most  bulletin 
  273.      boards, RCP/M's, and mainframes.
  274.  
  275. Terminal Mode - <E>cho Option
  276. è-----------------------------
  277.  
  278.       This    terminal  mode automatically echos  characters    re-
  279.      ceived  from another computer.   This is useful if you wish to 
  280.      communicate with somebody running the terminal portion of    the 
  281.      program.  Only one computer should be in this mode at a time.
  282.  
  283.       This    <E>cho    terminal mode is used at one end while    the 
  284.      <T>erminal  mode is used at the other end in cases where  key-
  285.      board-to-keyboard communications are desired.  Both ends  will 
  286.      see  anything entered at either end.   This is a useful  setup 
  287.      for  verifying that the connections are right before beginning 
  288.      file transfers.
  289.  
  290.     REMEMBER. . .    One computer in <E>cho mode, while. . .
  291.             the other must be in <T>erminal mode.
  292.  
  293.       Otherwise,  you  will  either not see your own keyed    en-
  294.      tries,  or you will see an eternal ping pong match while  both 
  295.      ends echo some character.     If this situation occurs,  enter a 
  296.      ConTRoL-E and use the <T>erminal option.
  297.  
  298. Terminal Mode -- <L>ocal Echo Option
  299. ------------------------------------
  300.  
  301.       The  <L>ocal    Echo  Terminal option is the  same  as    the 
  302.      <T>erminal  option,  except that the characters entered on the 
  303.      keyboard are echoed back to the screen.   This is useful  when 
  304.      communicating  with the WYLBUR front end processor for the HAL 
  305.      TSO option, or some other computer that does not echo back the 
  306.      characters that it receives.   The local Echo option is essen-
  307.      tially  the same as the <T>erminal option with a  change  from 
  308.      full to half duplex on the modem.
  309.  
  310. Terminal Mode  --  <T>erminal, <E>cho, or <L>ocal Options
  311. ---------------------------------------------------------
  312.  
  313.     Any of the three terminal options, <T>erminal, <E>cho, or
  314.     <L>ocal echo  may be used  either with or without an optional
  315.     filename specified after the command.
  316.  
  317.       If a file name is NOT specified after the  <T>,  <E>,  or 
  318.      <L>  terminal mode command,  then you will be in the so-called 
  319.      "dumb" terminal mode,  and cannot save any of the tranmissions 
  320.      from or to your computer.
  321.  
  322.       If a file name IS specified, it should be for a new file. 
  323.      The  information  received by the modem may then be  saved  in 
  324.      memory  and later written on disk.   The save text  in  memory 
  325.      feature is turned ON by ConTRoL-Y, and then OFF by ConTRoL-R.
  326.  
  327.      The sequence of commands to save a file is:
  328.  
  329. COMMAND (H for Help):T MESSAGE.TXT make up your own filename,  be 
  330.              ------------- sure  you have enough free space 
  331. è                   on diskette.
  332.  
  333. NOTE:  You could alternatively have used the <E>cho or <L>ocal echo 
  334. terminal options in place of the <T> terminal option.  The one that 
  335. you select will depend on whom you are communicating with.
  336.  
  337.            ConTRoL-Y       begin holding in memory at  this 
  338.            ---------       point;  (you could choose not to 
  339.                    save  your logging-in  transmis-
  340.                    sions).   A colon will appear on 
  341.                    your  CRT  in column 1 of  every 
  342.                    line  to indicate that the  save 
  343.                    feature  is active.     The  colon 
  344.                    will NOT be saved in your  file, 
  345.                    it  is  just there  to  indicate 
  346.                    that  the  save text  in  memory 
  347.                    feature is on.
  348.  
  349.            ConTRoL-R       turn  off the saving feature  to 
  350.            ---------       bypass something.   Nothing will 
  351.                    be saved until another ConTRoL-Y 
  352.                    is  entered.   No colon will ap-
  353.                    pear  at  the the left  edge  of 
  354.                    your CRT at this point.
  355.  
  356.            ConTRoL-E       Exits  <T>erminal (or any)  mode 
  357.            ---------       and    returns  to  the   MODEM9xx 
  358.                    command prompt.
  359.  
  360. COMMAND (H for Help): WRT       You MUST enter WRT at this point 
  361.               ---       to  move the data from memory on 
  362.                    to  a diskette.   If you  forget 
  363.                    this, you can forget about find-
  364.                    ing    anything in your "file"  on 
  365.                    diskette.
  366.  
  367. Additional notes about the <T>, <E>, or <L> Terminal options:
  368.  
  369.      1.  ConTRoL-Y causes the transmission to be held in a "buffer" 
  370.      in  memory.   Only  the WRT command (after you return  to    the 
  371.      menu) will move it into your file on diskette.
  372.  
  373.      2.  After    viewing  the transmission,  and placing it  into  a 
  374.      buffer in memory,    you may decide that you DO NOT want to save 
  375.      it.   Simply eliminate entering the WRT command,  and go on to 
  376.      something else.
  377.  
  378.      3. Be sure you have enough free diskette space to hold the new 
  379.      file  you    are creating with the WRT command.   You must  make 
  380.      sure ahead of time.
  381.  
  382.      4.  If  the  memory buffer fills up while you are receiving  a 
  383.      lengthy transmission,  MODEM9xx will automatically stop recei-
  384.      ving.   It will ask the other computer to wait,  by sending an 
  385.      X-OFF  or    ConTRoL-S.   It will then write the information  to 
  386. è     your disk file,  and ask the other computer to begin transmit-
  387.      ting more information by sending an X-ON or  ConTRoL-Q.   Your 
  388.      computer  will then resume receiving  the    transmission.    You 
  389.      will  not lose anything if the other computer understands X-ON 
  390.      and X-OFF.
  391.  
  392.      5.   The memory buffer is from the top of the modem program to 
  393.      the bottom of BDOS.  In a 64k machine,  this is usually enough 
  394.      to  hold 20 minutes of steady transmission at 300 baud,  or  5 
  395.      minutes at 1200 baud.   The computer with which you are commu-
  396.      nicating  must  accept the X-ON and X-OFF (ConTRoL-Q and  Con-
  397.      TRoL-S)  protocol convention or data will be lost    while  your 
  398.      buffer is written to your disk file.   You can verify that the 
  399.      other  computer  will wait by entering a ConTRoL-S  from  your 
  400.      keyboard  and seeing if the transmission stops until you enter 
  401.      ConTRoL-Q.
  402.  
  403.      6.   If  the transmission or file you are receiving is smaller 
  404.      than your memory buffer (approx.  your memory size,  less 27k) 
  405.      then you do not have to worry because you will not have to try 
  406.      to pause the remote system while you write.   If it is  larger 
  407.      than your buffer,    AND the remote system does not recognize X-
  408.      ON  and  X-OFF,  you may have to break the  transmission  into 
  409.      smaller pieces.
  410.  
  411.      7.   Receiving a program source file such as .ASM or .BAS    can 
  412.      be  done  in any of the terminal modes from  another  computer 
  413.      which is NOT using MODEM9xx.   However, be aware that you have 
  414.      no error    checking in the <T>,  <E>,  or <L> terminal  modes.
  415.      These  should  only be used for program  transfers  where    the 
  416.      other  computer does not have the MODEM9xx program.   You    may 
  417.      want  to transmit two copies of a file,  then use CRCK or COM-
  418.      PARE  to see if identical copies were received.   This is    NOT 
  419.      needed if both ends have MODEM9xx and the <S>end and <R>eceive 
  420.      modes were used for the file transfer.
  421.  
  422.      8.  If a filename is  NOT    specified after the <T>, <E>, or <L>
  423.      terminal command, then transmissions can not be saved.
  424.  
  425.      9.   When communications are done,  use ConTRoL-E to exit from
  426.      the <T>,  <E>, or <L> terminal mode and see the command prompt 
  427.      again.
  428.  
  429.      10.  If you chose any terminal mode with a filename,  the file 
  430.      to  which you  are writing  must then be closed by  using    the  
  431.      "WRT"  command.  If this is not done, all data will be lost.
  432.  
  433.      11.  The  original author of MODEM (Ward Christensen)  decided 
  434.      not   to  close   the file automatically since there  will  be  
  435.      times  when you leave the terminal mode and then decide to re-
  436.      enter.   This may be done while at the Command prompt by using 
  437.      the  "NOL" command.   You may put data into the same  file  as 
  438.      many  times  as  you wish as long as you have not    closed    the 
  439.      fil1 with    the "WRT" command.
  440.  
  441. è
  442. TO SEND A FILE FROM TERMINAL MODE:
  443. ----------------------------------
  444.  
  445.       While in <T>, <E>, or <L> terminal mode, a ConTRoL-T will 
  446.      put  you in File Transfer mode.   This will allow you to  send 
  447.      the  contents of an ASCII file over the modem.   This  routine 
  448.      does  no error checking and  there are no protocols  specified 
  449.      between  this program and the  receiving computer    other  than 
  450.      that  it should be ready  to receive data via the modem.    The 
  451.      use of ConTRoL-X will cancel the transfer.
  452.  
  453.       You  could use this mode to send MBOOT.ASM or other  pro-
  454.      grams to another computer which is not using MODEM8xx.  If the 
  455.      other computer is not using one of the MODEM programs,  do not 
  456.      bother to try to use the <S>end or <R>eceive options explained 
  457.      below.   They require coordinated error checking by one of the 
  458.      MODEM programs at both ends.
  459.  
  460.  
  461. FILE TRANSFER - <S>end and <R>eceive Options
  462. -------------
  463.  
  464.       <S>end  and <R>eceive are the same as in the    CP/M  Modem  
  465.      program  written by Ward Christensen except that upon  comple-
  466.      tion  of the transfer,  control returns to the Command  prompt 
  467.      unless  the  secondary "T" option has been selected.   In    the 
  468.      latter case, control returns to <T>erminal mode.
  469.  
  470.       Remember  that if you are operating a remote CP/M  (RCPM) 
  471.      computer  using a timesharing program (such as Ward  Christen-
  472.      sen's "BYE"),  the remote system's XMODEM program will send or 
  473.      receive  single files (except .COM).   This is done using com-
  474.      mands of the same general format as outlined below for MODEM9xx.
  475.  
  476.       Examples of commands for  <S>ending  and  <R>eceiving are
  477.      listed below.
  478.  
  479. Multi-file transfers  (not available with XMODEM programs on RCPM's)
  480. --------------------
  481.  
  482.       Using the  <B>ulk  batch secondary option,  more than one
  483.      file may be transferred.    Ambiguous  filenames are  accepted.
  484.      This is one of the major  enhancements  of  MODEM7  and  later
  485.      versions of the MODEM program.
  486.  
  487.       To <S>end a <B>ulk batch of files,  enter  SB followed by
  488.      one or more filenames.  For example:
  489.  
  490.       COMMAND (H for Help): SB B:ST*.BAS C:SWEEP.DOC D:*.*
  491.  
  492.       The individual filenames should be separated by a  space, 
  493.      and  should  include  the correct    drive  identifier  (B:     C:  
  494.      etc.).   If  no drive identifier is specified,  the  currently 
  495.      logged drive will be assumed to contain the file(s).
  496. è
  497.       The filenames may contain wildcards ( * or ?, where  the
  498.      asterisk may match any string of characters,  and the question 
  499.      mark may represent any one character)
  500.  
  501.       As of 1/1/83, there was a 64 filename maximum; be careful 
  502.      using those wildcards.
  503.  
  504.       Ensure  that    the  receiving computer's  disk  drive    has 
  505.      enough free space to hold the  file(s) that you are  <S>ending
  506.      to it.
  507.  
  508.       To  <R>eceive a <B>ulk batch of files,  enter RB followed
  509.      only by the disk drive specifier (B: C: etc.)  For example,
  510.  
  511.             COMMAND (H for Help): RB B:<CR>  
  512.                       ---------
  513.      You  DO NOT enter filenames at the receiving end during  batch 
  514.      transfers.  They are sent with the files.
  515.  
  516.       If you merely enter RB and omit the drive specifier,    the 
  517.      default  or currently logged-in drive will be used to  receive 
  518.      the file.    For example:
  519.  
  520.             Drive A
  521.             COMMAND (H for Help): RB <CR>
  522.                       -------
  523.       the command shown here is telling the computer to <R>eceive a
  524.       <B>ulk batch of files, placing them on the currently logged or
  525.       default drive.  The Default drive in this case is A:, as shown
  526.       on the line above the COMMAND (H for Help): prompt line.
  527. Using the <V>iew secondary option:
  528. ------------------------------------
  529.  
  530.      If  you are receiving a file you know to be  readable  (ASCII) 
  531. such  as a .DOC documentation file,  you can view it as it is being 
  532. <R>eceived.   This  can be a real timesaver if it is used to <V>iew 
  533. documentation files being <R>eceived while trying to decide whether
  534. or not to transfer software from a remote machine.   Simply add the 
  535. letter "V" following the letter "R" in your <R>eceive command.    For
  536. example:
  537.             Drive A
  538.             COMMAND (H for Help): RV MODEM9xx.DOC<CR>
  539.                       -------------------
  540.  
  541.  
  542. MODEM9xx Command Examples:
  543. --------------------------
  544.  
  545. Note:    All of these examples assume you are at the "COMMAND (H for 
  546. Help):" prompt of MODEM9xx.   If you are still in one of the termi-
  547. nal modes, enter a ConTRoL-E to get to this prompt.
  548.  
  549.  
  550.      SINGLE FILE TRANSFERS:
  551. è     ----------------------
  552.  
  553.     S MODEM.DOC        <S>ends MODEM.DOC from logged-in drive
  554.  
  555.     R B:MODEM.DOC        <R>eceives MODEM.DOC on drive B: disk
  556.  
  557.  
  558.     S B:MODEM.DOC        <S>ends from drive B:
  559.  
  560.     R A:MODEM.DOC        <R>eceives on drive A:
  561.  
  562.  
  563.      MULTIPLE FILE TRANSFERS:
  564.      ------------------------
  565.  
  566.     SB B:MODEM*.*        <S>ends from B: all files beginning
  567.                 with the letters MODEM
  568.  
  569.     RB B:            <R>eceives files on B:
  570.  
  571.  
  572.     SB B:F1.BAS C:F2.COM    <S>ends two files
  573.  
  574.     RB            <R>eceives files on logged-in disk
  575.  
  576.  
  577.     SB B:MODEM*.* B:F1.BAS C:F2.COM   combines two examples above.
  578.  
  579.     RB B:            <R>eceives files on B:
  580.  
  581.      MULTIPLE FILE TRANSFERS (cont'd)
  582.      --------------------------------
  583.  
  584.                               Note:
  585.                               -----
  586.  
  587.      Multi-file  transfers  may  only be started from  the  command 
  588. prompt.   They may not be specified when the MODEM program is  cal-
  589. led.  In other words,
  590.  
  591.             A>MODEM9xx SB  *.COM
  592.  
  593. will result in an INVALID OPTION error message.  You must be at the
  594.  
  595.             Drive A
  596.             COMMAND (H for Help):
  597.  
  598. prompt to do multiple file transfers.  The proper usage is
  599.  
  600.             Drive A
  601.             COMMAND (H for Help): SB *.COM
  602.                       --------
  603.  
  604.      THREE LETTER COMMANDS DEFINED
  605.      -----------------------------
  606. è
  607.            Three Letter Commands
  608.  
  609. DIR - List directory and space free (may specify drive)
  610. CPM - Exit from this program to CP/M
  611. ERA - Erase file (may specify drive)
  612. LOG - Change default drive/user (specify drive/user)
  613.       and reset disks.    e.g. LOG A0, LOG B (user unchanged)
  614. FOP - Display commands for setting terminal mode file
  615.       output parameters
  616. DSC - Disconnect the modem from the telephone line
  617. TCC - Toggle Checksum/CRC mode on receive
  618. TBR - Toggle backspace to rub conversion
  619. TLC - Toggle  1) local command immediate
  620.           2) local command after ctrl-^
  621. TLF - Toggle send linefeed after carriage return
  622. NUM - List remote systems
  623. SET - Set communication ports
  624.  
  625.      The following are terminal text buffer commands:
  626. DEL - Delete memory buffer and file
  627. NOL - Return to terminal mode - no loss of data in buffer
  628. WRT - Write memory buffer to disk file 
  629.  
  630.   DIR - The  "DIR" command lists the directory of a CP/M disk.     It
  631.     also  shows the amount of space free on the disk  expressed 
  632.     in Kilobytes.  A drive may be specified (ie. DIR B:) or the 
  633.     default drive will be listed.  Wildcards (*'s and ?'s)    may 
  634.     be  used  the  same as when DIR is run from the  A>  prompt 
  635.     under CP/M.  For example, 
  636.  
  637.           Drive A
  638.           COMMAND (H for Help): DIR B:*.BAS<CR>
  639.                      --------------
  640.     would  display a directory listing of all files on Drive B: 
  641.     with any FILENAME that have a file type of .BAS.
  642.  
  643.   CPM - The "CPM" command ends the MODEM program and returns to CP/M.
  644.  
  645.     >>>>---->  THIS IS HOW YOU EXIT THE MODEM9xx PROGRAM.  <----<<<<
  646.            COMMAND (H for Help): CPM<CR>
  647.                      -------
  648.            A>
  649.      The  computer    will respond with the  CP/M  system  command 
  650.     prompt.
  651.  
  652.   LOG - The  "LOG"  command  allows you to  change  your  currently 
  653.     logged    in  (default) disk drive and user level.   It  also 
  654.     allows    you to change disks in the drive.   This  comes  in 
  655.     handy  when you wish to bring in a large file and your    DIR 
  656.     shows that you don't have enough disk space to hold it.
  657.  
  658.   FOP - This command  displays a  submenu of three letter  commands
  659.     which effect terminal mode file output.
  660.  
  661. è  DSC - This  command will disconnect the modem from the  telephone
  662.     if  your system has that capabiltiy.  If disconnect is  not
  663.     possible then this command can be eliminated from the  menu
  664.     at assembly time.
  665.  
  666.   TCC - This  allows  you  to select the default  method  of  error 
  667.     checking protocol for transferring data.
  668.  
  669.   TBR - The "TBR" command lets you change the "backspace" character 
  670.     to  a "rubout" character when communicating with  terminals 
  671.     or computers that need it.
  672.  
  673.   TLC - This  changes the local command mode from an immediate type 
  674.     to  one that sends a control character to a remote  machine 
  675.     only after a ConTRoL-^.
  676.  
  677.   TLF - This  allows  you to either send or not send  a  "linefeed" 
  678.     character  after  every "carraige return" sent out  in    the 
  679.     terminal  mode.
  680.  
  681.   NUM - This command displays on the screen a listing of frequently 
  682.     called    telephone numbers,  such as those for  computerized 
  683.     Bulletin Board systems, Remote CP/M's, etc.
  684.  
  685.   SET - The  "SET"  command  allows you to set    the  communications 
  686.     ports for the PMMI modem,  and for certain other  machines.  
  687.     You  may  be able to change things like  baud  rates,  word 
  688.     length, number of stop bits, and so on.  This is not imple-
  689.     mented    for  most machines,  as the assumption is that    you 
  690.     will be able to set these things on your machine through  a 
  691.     manufacture-supplied  utility called CONFIG.COM,  CONFIGUR-
  692.     .COM, SETUP.COM, or the like.
  693.  
  694.  TIM -  If the SET command is not implimented then this command  is
  695.     used to set the baud rate so that the program can  properly
  696.     display the time to transfer a file.
  697.  
  698.  DEL -  The  "DEL"  command  erases the most recent file   accessed  
  699.     in  Terminal mode.   This is used when you decide  after  a 
  700.     communication  session that you don't want to save on  disk 
  701.     the information just gathered.
  702.  
  703.   NOL - Use the "NOL" command to RE-ENTER any of the three terminal 
  704.     modes with NO Loss of data after going to the command  mode 
  705.     with a CTRL-E.     If this is done, you will still be able to 
  706.     save the information in the memory buffer if you were doing 
  707.     so before you quit the terminal mode.    Note that this will 
  708.     return you to whichever terminal mode (<T>erminal,  <E>cho, 
  709.     or  <L>ocal  Echo)  you were using before you went  to    the 
  710.     command mode.
  711.  
  712.   WRT - The  "WRT"  command  must be used  after  leaving  Terminal  
  713.     mode.  This writes the last buffer to disk and closes    the 
  714.     file.    Failure to use the "WRT" command results in loss of 
  715.     all data and a file of length zero.
  716. è
  717.  
  718.      Commands for Setting Terminal Mode File Output Parameters
  719.  
  720. SPD - Set speed of file output
  721. TEF - Toggle transmission of end-of-file character
  722. TSL - Toggle stripping linefeeds
  723. TWE - Toggle wait for character echo
  724. TXF - Toggle XOFF testing
  725. TXN - Toggle XON waiting after <CR>
  726.  
  727.   SPD - The  "SPD" command allows you to add delay time after  each 
  728.     character  sent  or each carraige  return  sent.   This  is 
  729.     useful    if you are communicating with a hard copy  terminal 
  730.     or  even a mainframe that cannot capture the characters  as 
  731.     fast as you can send them.
  732.  
  733.   TEF - When transferring a text file to another CP/M system it  is
  734.     sometimes useful to send an end-of-file (EOF) marker.  This
  735.     toggle will turn on/off sending an EOF.
  736.  
  737.   TSL - When  sending text to a mainframe it  is usually  desirable
  738.     not to transmit linefeeds. On the other hand, when  sending 
  739.     text files  to another CP/M system it is usually  desirable
  740.     to  send linefeeds.  This  toggle will  turn on/off sending
  741.     linefeeds.
  742.  
  743.   TWE - If  the remote echoes, one of the most reliable methods  of 
  744.     sending text is to wait for the transmitted character to be
  745.     echoed. This toggle will turn this option on/off.
  746.  
  747.   TXF - Some mainframes (and micros) send XOFF when they want  your
  748.     micro to stop transmitting and send XON when they are ready
  749.     to resume accepting text. This toggle will turn XOFF  test-
  750.     on/off.
  751.  
  752.   TXN - Certain systems, such as the ASCII interfaces for IBM 370s,
  753.     always send an XOFF on receipt of a <CR> and send XON  when
  754.     the system is prepared to receive another line. This toggle
  755.     turns on/off waiting for an XON after a <CR>.
  756.  
  757. NOTE: Only one of the TWE, TXF and TXN toggles can be on.
  758.  
  759.  
  760. LOCAL COMMANDS THAT MAY BE USED WHILE IN THE TERMINAL MODE
  761. ----------------------------------------------------------
  762.  
  763.      Local Commands while in Terminal Mode
  764.  
  765. ctrl-E    - Exit to command mode
  766. ctrl-O  - Transmit string
  767.      Must be followed by number of string (0-9)
  768.      or L to display list of strings
  769. ctrl-P    - Toggle printer
  770. ctrl-Y    - Start copy into buffer
  771. èctrl-R    - Stop copy into buffer
  772.      Start & Stop may be toggled as often as desired.
  773.      A ":" at start of line indicates buffer is open.
  774.      XOFF automatically used to stop input when writing
  775.      full buffer to disk, XON sent to resume.
  776. ctrl-T    - Transfer ASCII file to remote
  777. ctrl-^    - Send local control character to remote
  778.  
  779. CTRL-E    This command is the way to leave any mode and return to the
  780.     COMMAND (H for Help): prompt.  You may then use your choice
  781.     of the three-letter commands.
  782.  
  783. CTRL-O    This allows you to transmit pre-defined strings of characters
  784.     characters if they have been put into your program.
  785.  
  786. CTRL-P    This will  cause  the  characters  sent to the screen to be
  787.     simultaneously    sent to the printer,  or LST:  device.     It
  788.     works the same way as the printer toggle in the CP/M opera-
  789.     ting  system.    The  first use turns it on,  the second use
  790.     turns it off, etc.
  791.  
  792. CTRL-Y    This is used with the CTRL-R command to control the process
  793.     of putting text into the memory buffer.   The CTRL-Y begins
  794.     putting text into the buffer, while the CTRL-R suspends the
  795.     process.
  796.  
  797. CTRL-T    This initiates the  transmission  of  a  text (ASCII) file
  798.     without any error checking protocol.   This should be used
  799.     to send text files to machines that are not running any of
  800.     the MODEM programs.
  801.  
  802.  
  803. NOTE:   The control codes displayed  by the program  may differ from
  804. those give above since they can be redefined at assembly time.
  805.  
  806.  
  807.               A Typical Session With MODEM9xx
  808.  
  809.      The computer is on and the CP/M operating system is 'booted' so
  810. that  the screen displays the A> command prompt from CP/M.   We have
  811. inserted the disk with MODEM9xx.COM into disk drive A:    We will wish
  812. to write on disk A: so we 'warm-boot' with a ConTRoL-C.
  813.  
  814. A>^C
  815.   --
  816.  
  817. A>MODEM9xx<CR>
  818.   ------------
  819. MODEM 9.xx - 03/20/83
  820. Version for: Heath H89  
  821.  
  822. Drive A
  823. COMMAND (H for Help): H<CR>
  824.               -----
  825.  
  826. è         Single Letter Commands
  827.  
  828.  H  - Display this information
  829.  ?  - Display current  settings
  830.  T  - Terminal mode
  831.  E  - Terminal mode with echo
  832.  L  - Terminal mode with local echo
  833.      For capturing text use T(or E or L) FILENAME.TYP and
  834.      Start & Stop toggles described on subsequent screen.
  835.  R  - Receive file using Christensen Protocol
  836.  S  - Send file using Christensen Protocol
  837.      Command is: R(or S) FILENAME.TYP
  838.      R and S can use the following sbcommands:
  839.       B  - Bulk transfer using wildcards (e.g. *.*)
  840.       Q  - Quiet mode (no messages to console)
  841.       T  - Return to terminal mode after transfer
  842.       V  - View bytes transferred on console
  843. The single letter commands may also be used on the
  844. command line when the program is initially executed.
  845.  
  846. HIT any KEY to CONTINUE<CR>
  847.                ----
  848.  
  849.  
  850.           Three Letter Commands
  851.  
  852. DIR - List directory and space free (may specify drive)
  853. CPM - Exit from this program to CP/M
  854. ERA - Erase file (may specify drive)
  855. LOG - Change default drive/user (specify drive/user)
  856.       and reset disks.    e.g. LOG A0, LOG B (user unchanged)
  857. FOP - Display commands for setting terminal mode file
  858.       output parameters
  859. DSC - Disconnect the modem from the telephone line
  860. TCC - Toggle Checksum/CRC mode on receive
  861. TBR - Toggle backspace to rub conversion
  862. TLC - Toggle  1) local command immediate
  863.           2) local command after ctrl-^
  864. TLF - Toggle send linefeed after carriage return
  865. NUM - List remote systems
  866. SET - Set communication ports
  867.     The following are terminal text buffer commands:
  868. DEL - Delete memory buffer and file
  869. NOL - Return to terminal mode - no loss of data in buffer
  870. WRT - Write memory buffer to disk file
  871.  
  872. HIT any KEY to CONTINUE<CR>
  873.                ----
  874.  
  875.     Local Commands while in Terminal Mode
  876.  
  877. ctrl-E    - Exit to command mode
  878. ctrl-O  - Transmit string
  879.      Must be followed by number of string (0-9)
  880.      or L to display list of strings
  881. èctrl-P    - Toggle printer
  882. ctrl-Y    - Start copy into buffer
  883. ctrl-R    - Stop copy into buffer
  884.      Start & Stop may be toggled as often as desired.
  885.      A ":" at start of line indicates buffer is open.
  886.      XOFF automatically used to stop input when writing
  887.      full buffer to disk, XON sent to resume.
  888. ctrl-T    - Transfer ASCII file to remote
  889. ctrl-^    - Send local control character to remote
  890.  
  891. Drive A
  892. COMMAND (H for Help): ?<CR>
  893.               -----
  894.  
  895.          Current Settings
  896.  
  897. CRC mode set
  898. Printer is off
  899. Carrier present
  900. Modem speed is 300 baud
  901. Backspace is backspace
  902. Linefeed NOT sent after <CR>
  903. Use ctrl-^ to send local command to remote
  904. Terminal mode file buffer is inactive
  905. Unused portion of buffer is 36608 bytes
  906. Word length is eight, number of stop bits is one, parity is none
  907. Linefeed NOT sent after <CR> in terminal mode file output
  908. End-of-file character NOT sent in terminal mode file output
  909. XOFF testing NOT used in terminal mode file output
  910. XON NOT automatically tested after <CR> in terminal mode file output
  911. Waiting for character echo NOT used in terminal mode file output
  912. Terminal mode file output delay is 0.00 seconds per character
  913. Additional delay after <CR> is 0.00 seconds
  914.  
  915. Drive A
  916. COMMAND (H for Help): 
  917.  
  918. Drive A
  919. COMMAND (H for Help): T BBS.DIR<CR>
  920.               -------------
  921. File exists -- Type 'Y' to erase: Y
  922.                   -
  923. CTRL-Y
  924. ------
  925. ** Memory buffer open **
  926.  
  927.  :  then  the  little red modem received many characters that were 
  928.  :simply stuffed into the memory buffer in the computer.  You 
  929.  :should remember that this colon is simply a symbol to remind
  930.  :you that you are capturing the stuff coming in into your 
  931.  :buffer.  It will not be written to disk until a "WRT" command. .
  932. CTRL-R
  933. ------
  934. ** Memory buffer closed **
  935.  
  936. èCTRL-E
  937. ------
  938.  
  939. ** There may be text in the memory buffer **
  940. ** It will be lost unless NOL or WRT commands are used **
  941.  
  942. Drive A
  943. COMMAND (H for Help): WRT<CR>
  944.               -------
  945. Drive A
  946. COMMAND (H for Help): ?<CR>
  947.               -----
  948.  
  949.         Current Settings
  950.  
  951. CRC mode set
  952. Printer is off
  953. Carrier present
  954. Modem speed is 300 baud
  955. Backspace is backspace
  956. Linefeed NOT sent after <CR>
  957. Use ctrl-^ to send local command to remote
  958. Terminal mode file buffer is inactive
  959. Unused portion of buffer is 36608 bytes
  960. Word length is eight, number of stop bits is one, parity is none
  961. Linefeed NOT sent after <CR> in terminal mode file output
  962. End-of-file character NOT sent in terminal mode file output
  963. XOFF testing NOT used in terminal mode file output
  964. XON NOT automatically tested after <CR> in terminal mode file output
  965. Waiting for character echo NOT used in terminal mode file output
  966. Terminal mode file output delay is 0.00 seconds per character
  967. Additional delay after <CR> is 0.00 seconds
  968.  
  969.  
  970. Drive A
  971. COMMAND (H for Help): 
  972.  
  973. Drive A
  974. COMMAND (H for Help): TXO<CR>
  975.               -------
  976.  
  977. Use XOFF testing? (Y/N): Y<CR>
  978.              -----
  979. XOFF testing used in terminal mode file output
  980. Therefore -
  981. XON NOT automatically tested after <CR> in terminal mode file output
  982. Waiting for character echo NOT used in terminal mode file output
  983.  
  984. Drive A
  985. COMMAND (H for Help): TBR<CR>
  986.               -------
  987. Backspace is rub
  988.  
  989. Drive A
  990. COMMAND (H for Help): SPD<CR>
  991. è              -------
  992.  
  993. Enter character output delay [0(none) - 9(longest delay)]: 5<CR>
  994.                                -----
  995. Terminal mode file output delay is 0.10 seconds per character
  996.  
  997.  
  998. Enter additional delay after <CR> [0-9]: 5<CR>
  999.                      -----
  1000. Additional delay after <CR> is 0.40 seconds
  1001.  
  1002.  
  1003. Drive A
  1004. COMMAND (H for Help): DIR C:<CR>
  1005.               ----------
  1006. NO FILE
  1007. Drive A has 274K bytes free
  1008.  
  1009. Drive A
  1010. COMMAND (H for Help): DIR C<CR>
  1011.               ---------
  1012. NO FILE
  1013. Drive A has 274K bytes free
  1014.  
  1015. Drive A
  1016. COMMAND (H for Help): DIR C:<CR>
  1017.               ----------
  1018. MBOOT-89.ASM | BYE80   .ASM | DUUP    .COM | DUUP    .DOC 
  1019. MODEM7    .COM | OSBMAST .CAT | P/DCAT  .DIR | RENAME  .COM 
  1020. RENAME    .DOC | SD4-41  .ASM | SYSGEN  .COM | WYLZEATH.MAC 
  1021. Drive C has 78K bytes free
  1022.  
  1023. Drive A
  1024. COMMAND (H for Help): LOG C5<CR>
  1025.               ----------
  1026. Insert disk for drive C
  1027. Hit return when ready <CR>
  1028.               ----
  1029. Drive C, User 5
  1030. COMMAND (H for Help): ?<CR>
  1031.               -----
  1032.  
  1033.          Current Settings
  1034.  
  1035. Checksum mode set
  1036. Printer is off
  1037. Carrier present
  1038. Modem speed is 300 baud
  1039. Backspace is rub
  1040. Linefeed NOT sent after <CR>
  1041. Use ctrl-^ to send local command to remote
  1042. Terminal mode file buffer is inactive
  1043. Unused portion of buffer is 36608 bytes
  1044. Word length is eight, number of stop bits is one, parity is none
  1045. Linefeed NOT sent after <CR> in terminal mode file output
  1046. èEnd-of-file character NOT sent in terminal mode file output
  1047. XOFF testing used in terminal mode file output
  1048. XON NOT automatically tested after <CR> in terminal mode file output
  1049. Waiting for character echo NOT used in terminal mode file output
  1050. Terminal mode file output delay is 0.10 seconds per character
  1051. Additional delay after <CR> is 0.40 seconds
  1052.  
  1053. Drive A
  1054. COMMAND (H for Help): TLF<CR>
  1055.               -------
  1056. Linefeed sent after <CR>
  1057.  
  1058. Drive A
  1059. COMMAND (H for Help): ?<CR>
  1060.               -----
  1061.  
  1062.            Current Settings
  1063.  
  1064. Checksum mode set
  1065. Printer is off
  1066. Carrier present
  1067. Modem speed is 300 baud
  1068. Backspace is rub
  1069. Linefeed sent after <CR>
  1070. Use ctrl-^ to send local command to remote
  1071. Terminal mode file buffer is inactive
  1072. Unused portion of buffer is 36608 bytes
  1073. Word length is eight, number of stop bits is one, parity is none
  1074. Linefeed NOT sent after <CR> in terminal mode file output
  1075. End-of-file character NOT sent in terminal mode file output
  1076. XOFF testing used in terminal mode file output
  1077. XON NOT automatically tested after <CR> in terminal mode file output
  1078. Waiting for character echo NOT used in terminal mode file output
  1079. Terminal mode file output delay is 0.10 seconds per character
  1080. Additional delay after <CR> is 0.40 seconds
  1081.  
  1082. Drive A
  1083. COMMAND (H for Help): CPM<CR>
  1084. A>              -------
  1085.  
  1086.