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