home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / comm / mdt100.lzh / mdt.doc < prev    next >
Text File  |  1991-07-22  |  7KB  |  159 lines
  1. My Dumb Terminal - Official Documentation by Ken Schenke
  2. ========================================================
  3.  
  4.  
  5.  
  6.  
  7. Legal Speak
  8. -----------
  9.  
  10. My Dumb Terminal is copyrighted in 1991 by ParaLogic Software International,
  11. Inc.  Permission is granted to freely distribute the contents of this
  12. archive so long as all files are left intact without modification.
  13. Permission to re-distribute this software in a public domain collection,
  14. be it a disk or a telecommunications service, is granted so long as no 
  15. additional charge is imposed over normal rates for other such software nor
  16. are any of the files in this archive modified or removed.
  17.  
  18. The req.library is copyrighted in 1989 by Colin Fox and Bruce Dawson.
  19.  
  20.  
  21.  
  22. What Does a Dumb Terminal Eat Anyway?
  23. -------------------------------------
  24.  
  25. Well, besides Tender Loving Care My Dumb Terminal needs a few things in order
  26. to operate to full potential.
  27.  
  28. MDT needs the req.library for requesters.  I use the file requester (don't
  29. you wish everyone did?) and other misc requesters as well.  The library is
  30. included in this archive for convenience.  The req.library file should go in
  31. your libs: directory.
  32.  
  33. For each protocol you plan on using you will need the appropriate
  34. xpr*.library file.  A description of these files can be found below.
  35.  
  36. Any configuration information MDT needs is obtained from the system
  37. preferences.  These include baud rate, word length, number of stop bits, and
  38. parity type.  To keep the whole blasted program simple as can be only baud
  39. rate may be changed from within the program.  You may change any of the
  40. preferences settings while MDT is in operation with the exception of baud
  41. rate.  You must do this from the pull down menu option.  This to prevent you
  42. from accidentally changing the baud rate back to the original setting if
  43. changed previously.
  44.  
  45.  
  46.  
  47. Your Guide to Having Fun with My Dumb Terminal - A Layman's Handbook
  48. --------------------------------------------------------------------
  49.  
  50. I originally wrote My Dumb Terminal (MDT) as a programming exercise.  Since,
  51. I have begun to use it for quick calls to the BBS or for null modem
  52. connections.  Because it doesn't attempt to do any kind of filtering or
  53. formatting of incoming text, it is rather fast.  In fact, to my knowledge,
  54. MDT is the FASTEST terminal program on the Amiga.
  55.  
  56. Later, I added full XPR support.  Every feature is implemented with the
  57. exception of wildcard support and the two functions for monitoring data
  58. added with V2 of the XPR standard.  These being XProtocolHostMon() and
  59. XProtocolUserMon().  These are most useful for automatic downloads in
  60. ZModem.  Because they do not have such a place in a small terminal and
  61. because I believe these function implementations are not complete I chose not
  62. to include them.
  63.  
  64. The terminal program accomplishes file transfers using protocols written to
  65. the XPR standard developed by W.G.J. Langeveld at the Stanford Linear
  66. Accelerator Center under sponsorship of the U.S. Government.  Please see
  67. xprotocol.doc for more information.  This file can be found in the archive
  68. describing the XPR standard (typically named xprlib2.lzh).  The protocols
  69. are in the form of a standard Amiga resident library.  The libraries named
  70. xpr<protocol>.library, where <protocol> is the name of the protocol are
  71. found in the libs: directory.  Your favorite BBS should have a few of these
  72. laying around.  As per the XPR standard, configurations for these protocols
  73. are stored in environment variables named XPR<PROTOCOL> where protocol is the
  74. name of the protocol.  At the time of the transfer MDT will read the contents
  75. of the appropriate variable and send this to the protocol.  If said variable
  76. cannot be located then you play twenty questions every time you do a
  77. transfer.  The protocol (via MDT via req.library) will ask you several
  78. questions concerning the transfer.  These settings are different for each
  79. protocol and are described in the protocol's respective documentation.
  80.  
  81.  
  82.  
  83. So You Want to Do a File Transfer
  84. ---------------------------------
  85.  
  86. When Upload or Download is selected from the pull down menu you will first
  87. need to select a protocol.  A list of available protocols will be presented.
  88. Simply double click on your choice or select the protocol and click on OK!.
  89. Clicking on "Forget It" will cancel the whole ordeal and let you get on with
  90. your life.  Pretty standard stuff.  Next, if appropriate, you will be
  91. presented with a file requester to select which file(s) to transfer.  You may
  92. select more than one file by using the extended select (shift key while
  93. clicking).  If it doesn't make sense to select more than one file then don't
  94. do it.  There is no protection in the XPR standard for preventing against
  95. such monstrosities.  For example, if you're downloading a file using xmodem
  96. then don't select five file names to receive under.  Obviously xmodem is a
  97. single file protocol (no batches here).  It can only do one file at a time.
  98.  
  99.  
  100.  
  101. MDT - Up Close and Personal
  102. ---------------------------
  103.  
  104. Source code to MDT is generously included in this archive.  Please respect my
  105. wishes for usage.  I included the source code as an educational tool.  By
  106. looking at my work you can learn the proper way to implement not only full
  107. XPR support but also the secret to fast serial communications without going
  108. directly to the hardware.
  109.  
  110. Look but don't touch.  You are more than welcome to peruse the source code
  111. at your leisure but don't change it a bit.  I wrote this terminal program for
  112. simplicity.  It's beauty is in it's simplicity.
  113.  
  114. You may not, under any circumstances, modify my source code and send it back
  115. out.  Anybody remember 6485 BBS on the Commodore 64?  I still have nightmares
  116. about that one.
  117.  
  118.  
  119.  
  120. Known Bugs - How could this be?
  121. -------------------------------
  122.  
  123. The only known bug in this program deals with multiple selects in the file
  124. requester.  It doesn't work.  I have tried everything I can think of to use
  125. the multiple selects with the req.library but I can't seem to get them to
  126. work.  I can select more than one file just fine but when the requester
  127. returns the linked list containing the selected files is empty.  If anyone
  128. can figure this out then please notify me.
  129.  
  130.  
  131.  
  132. Future - What can I look forward to?
  133. ------------------------------------
  134.  
  135. Not much.  MDT is done.  Maybe I'll get the multiple select bug fixed
  136. someday.  I thought of dropping the req.library and going entirely with 2.0's
  137. asl.library but not right now.  I've got more pressing projects to finish.
  138.  
  139.  
  140.  
  141. How Do I Tell This Guy He Has His Head On Backwards?
  142. ----------------------------------------------------
  143.  
  144. I (Ken Schenke) may be reached on The Guru Zone BBS.  Right now, I would
  145. prefer FidoNet netmail @ 1:280/10.0 as the BBS is not full service and is not
  146. open to the public.  But, by the time this file reaches you I would go ahead
  147. and call.  After all, you may be in for a surprise.
  148.  
  149. Guru Zone      816-246-5253  1:280/10.0
  150.  
  151. I can also be reached on:
  152.  
  153. Amiga Central  816-587-5360  1:280/314.0
  154. Laser Online   816-444-4960  1:280/13.0
  155. AAmigaVille    816-796-5954  1:280/280.0
  156.  
  157.  
  158. Ken Schenke,  22-Jul-91,  Lee's Summit, MO.  USA
  159.