home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / cpm / modems / modem / mtn22b.lbr / MTN22B.DZC / MTN22B.DOC
Text File  |  1985-02-09  |  9KB  |  192 lines
  1.             MTN22.DOC
  2.             (revised 6/1/81)
  3.  
  4. MicroTELNET  (MTN)  is  a modem program written for  the  Z80  and
  5. designed  to  interface with the facilities of CP/M 1.4  and  2.2.
  6. The  program  consists of two files:  MTNxx.COM  and  MTNMSGS.OVR,
  7. where xx is the version number - currently 22B (2.2B).
  8.  
  9. MTN  provides  up and download capabilities  and  auto-dial  modem
  10. control. It has many dynamically changeable options, such as Modem
  11. (internal  DCHayes  or  PMMI,  or  external),  Dial/Redial/Hangup,
  12. Record  ON/OFF,  Write to disk,  Xmit from disk using wait-for-LF-
  13. echo,  Flow control for input (XON/XOFF or none),  Binary or  Text
  14. mode record or transmission of files,  half or fullduplex, 10 soft
  15. keys  with up to 31 characters per key,  status report of settings
  16. and buffer state,  interactive mode to set each mode,  and "built-
  17. in"  help documentation.   There is also a  startup  customization
  18. sequence  which  will let you predefine these modes and  keys  and
  19. save that version to run later.
  20.  
  21. Running  MTN  will  automatically  drop  you  into  a  customizing
  22. sequence where you can change all of the default settings,  define
  23. keyboard  macros (or program function or soft keys),  indicate you
  24. terminal type,  select your modem card type,  and finally save the
  25. current state to a filename of your own choosing.  It is that file
  26. which you run for subsequent sessions. All of the customizing code
  27. and one-time code is in the area used by the buffer and is why the
  28. actual  size of the program differs from the running  size.   When
  29. the customization is complete,  and you chose to save that version
  30. to  a file,  MTN will exit.  Otherwise,  you will be left in  that
  31. unsaved version to experiment.
  32.  
  33. Once  you have completed the customization sequence,  or  run  the
  34. customized version, you are left online, unless you type a CTRL-^,
  35. which is the default (and customizable) Intercept Character.   The
  36. program  stops  looking  at  the remote (modem)  port  and  awaits
  37. another  character  as  a command.  If you  do  not  type  Command
  38. Character  within  about  five seconds,  a built-in menu  will  be
  39. displayed  (as  if  you had typed the Intercept  Character  and  a
  40. question mark). When the command has completed its action, it will
  41. resume checking the remote port for input.  Any characters sent by
  42. the remote host are ignored during that time.
  43.  
  44. The  customized  version  of the program itself is about  10K  and
  45. currently  resides beginning at 0100H.   The code itself  is  over
  46. 138K of well-commented source in 90 files, and another 32K for the
  47. source  to the documentation in 21 files,  all written in Z80 code
  48. starting in May 1980,  and assembled and linked using  Microsoft's
  49. MACRO-80 and LINK-80, respectively.
  50.  
  51. All  of  the  "built-in"  documentation causes the  screen  to  be
  52. cleared.  Other special messages from the program are displayed in
  53. inverse or dim video, if those sequences are known to the program.
  54. The  text  is actually kept in a separate file  (MTNMSGS.OVR)  and
  55. accessed  by  starting  sector number in a  similar  fashion  that
  56. WordStar uses.
  57.  
  58.  
  59.  
  60. What's New in MTN 2.2B (from MTN  2.2A) - just one bug patched  by
  61. Frank Wancho with the help of Ron Fowler:
  62.  
  63. Exiting MTN and leaving the line active will now not hang up  the
  64. line when MTN is restarted using a DCHayes Modem card.
  65.  
  66.  
  67. What's New in MTN 2.2A (from MTN  2.2) - just one bug patched  by
  68. Frank Wancho:
  69.  
  70. List Buffer/File no longer thinks a 9AH (as inserted by the RECORD
  71. Mode for received 1AH's) is a real CP/M EOF (1AH).
  72.  
  73.  
  74. What's New in MTN 2.2 (from MTN 2.1) - no new features  added, but
  75. following bugs fixed by Ron Fowler:
  76.  
  77. 1.  Add strip of parity bit in console input to command routine.
  78.  
  79. 2.  Added CBIOS call register save in case CBIOS clobbers them.
  80.  
  81. 3.  Reversed order of flag checks so empty filename will not cause
  82.     infinite loop.
  83.  
  84. 4.  Fixed garbage print after file save.
  85.  
  86. 5.  Fixed pointer for dial help display.
  87.  
  88.  
  89. What's New in MTN 2.1 (from MTN 1.3/1.4):
  90.  
  91. 1.  The  Intercept Character is now  installable at  customization
  92. time.  The  current Intercept  Character is displayed as  part  of
  93. the signon.
  94.  
  95. 2.  All  port  values for  Console and Modem are  now  installable
  96. values.
  97.  
  98. 3. List File and  List Buffer now pauses every  22 lines and rings
  99. the bell, waiting for any character to continue.
  100.  
  101. 4.  The  disk  select  for 1.4  was wrong  and  now  fixed.   Also
  102. extraneous disk system resets have been flushed.
  103.  
  104. 5.  A non-empty RECORD buffer is offered for disposal when  RECORD
  105. is turned ON or OFF, and when Quitting.
  106.  
  107. 6.  You  can now execute  a zero-length .COM file to continue  MTN
  108. after Quitting,  provided that you have nothing in the buffer area
  109. extending  into the CCP area that you intend to keep and run  only
  110. CCP built-in commands.  This is particularly helpful when you have
  111. encountered  a  disk error when writing the buffer,  giving you  a
  112. chance  to recover by putting in  another  disk,  restarting,  and
  113. attempting the write to disk again.
  114.  
  115. 7.   You  can  now  upload a file OR the current contents  of  the
  116. buffer using either the wait-for-lf-echo technique, or, if FLOW is
  117. toggled  to  XON/XOFF and your remote  recognizes  that,  use  the
  118. significantly faster XON/XOFF flow control.
  119.  
  120. 8.   All of the built-in switches are now toggles.   It offers you
  121. the  current value and the toggled value to be set upon  confirma-
  122. tion.
  123.  
  124. 9.   All confirmation lists the one-letter choices.  Typically, Y,
  125. SPACE,  or  RETURN  means YES,  and only N  means  NO.  All  other
  126. responses are ignored unless listed and requiring further confirm-
  127. ation.
  128.  
  129. 10.  The  Key Definition Command now accepts input in either ASCII
  130. or  HEX and offers to display the settings of the keys  (which  is
  131. also  available  as a new List subcommand).  Values below 20H  are
  132. displayed in two-character representations (up-arrow and  letter),
  133. while  values  above 7EH are displayed in HEX surrounded by  angle
  134. brackets and in inverse or dim video, if available.
  135.  
  136. 11.  Another  new List subcommand,  courtesy of W8SDZ@MC,  is  the
  137. Directory lister...  the first of the CCP commands to be available
  138. directly inside of MTN.
  139.  
  140. 12.  The RECORD buffer area now can extend into the CCP and thus a
  141. warm  boot jump is now taken when you return to CP/M via the  Quit
  142. Command instead of simply returning to CCP.
  143.  
  144. 13.  The  interdigit  dialing  delay has now been reduced  to  one
  145. second  instead  of  the  previous  two  seconds  needed  at   one
  146. particular  installation,  and 20 pulse-per-second dialing may  be
  147. optionally specified at customization time.
  148.  
  149. 14.  The  Dial Command now checks and offers to redial a  previous
  150. number, leaving the old ReDial Command now available to toggle the
  151. Record  Mode  instead.   The "Type any character to  abort"  while
  152. waiting  for carrier will now really abort rather than abort  that
  153. particular  dial attempt and not try any more of the remaining out
  154. of three.
  155.  
  156. 15. The AUTO Command is new.  It will allow you to download a file
  157. larger than memory into one continuous file,  provided that  there
  158. is  space available on the disk and there is XON/XOFF flow control
  159. available from the remote.  The filename to write the buffer(s) is
  160. solicited up front and there are no bells when the buffer  becomes
  161. nearly full.
  162.  
  163. 16. All writes to disk now write to the requested filename.$$$ and
  164. then rename upon successful closure.
  165.  
  166. 17.  The VERBOSE Mode is now gone,  and in its place is the VERIFY
  167. Mode.   Turn this ON and all output to the console from the remote
  168. or  buffer display or disk file is displayed as two HEX digits and
  169. a SPACE, 20 triplets to a line.
  170.  
  171. 18.  Users  of  the PMMI Modem now get a proper  hangup  with  the
  172. Terminate Command or when carrier is lost.  D.C.Hayes users should
  173. now get "proper" operation when dialing,  i.e., the transmitter is
  174. disabled  until the carrier is detected and disabled when  carrier
  175. is lost.
  176.  
  177. 19.  The  short  list  menu of commands is incorporated  into  the
  178. program to minimize unnecessary disk accesses and is automatically
  179. displayed  if  there is a five second pause  after  the  Intercept
  180. Character is typed.   This text was the single contributing factor
  181. to the increase in the running size of the program.
  182.  
  183. There  are  many  other  changes  in the  way  the  program  works
  184. internally  as well as other cosmetic changes not worth  detailing
  185. here.  The "built-in" documentation available by typing a question
  186. mark  to most of the command prompts should  be  self-explanatory.
  187. If not,  or if there are any bug reports or feature requests, send
  188. mail to BUG-MTN@MIT-MC, or Remote CP/M Royal Oak (313)-759-6569.
  189.  
  190. MicroTELNET (MTN) Copyright (C) 1981 Frank J.  Wancho.  All rights
  191. reserved.
  192.