home *** CD-ROM | disk | FTP | other *** search
/ ftp.whtech.com / ftp.whtech.com.tar / ftp.whtech.com / club100 / cat / vt100.exe / lha / VTDOC1.DO < prev    next >
Text File  |  1991-08-07  |  13KB  |  333 lines
  1.  
  2.                              100/100
  3.  
  4.                         A VT100 Emulator
  5.  
  6.                             for the 
  7.  
  8.                           Model 100/102
  9.  
  10.                         NoteBook Computer
  11.  
  12.  
  13.  
  14.  
  15.                            written by
  16.                            Terry Luke
  17.  
  18.      This program is in the public domain and may be freely
  19.      distributed as long as this page remains with the program
  20.      and it is distributed without charge except for reasonable
  21.      duplication fees.  
  22.  
  23.                          Copyright 1987
  24.                            Terry Luke
  25.                        All Rights Reserved
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40. The Author of 100/100 assumes no liabilites to any user regarding
  41. any loss or damage caused by th 100/100 program.  Much effort has
  42. been taken to make 100/100 reliable, and error free, but not
  43. responsibility can be assumed for loss of data, interruption of
  44. service, or loss of business or profits.
  45.  
  46.  
  47.  
  48.                       100/100 DOCUMENTATION
  49.  
  50.                                 
  51.  
  52.  
  53.  
  54.  
  55.  
  56.                           INTRODUCTION
  57.  
  58. 100/100 Documentation
  59.  
  60. Your copy of 100/100 will give telecommunication capabilities to
  61. your TRS Model 100/102 you never thought possible.  Finally, you
  62. can get true VT100 emulation and ANSI terminal capabilities to
  63. allow you to access many host applications previously
  64. inaccessible to your laptop portable.  Now you are able to
  65. utilize the full resources of your VAX or other host which
  66. requires a VT100, while on the road, at home, or in your
  67. customer's office - wherever you happen to be.
  68.  
  69. Although there are obvious inherent limititations to using a 40
  70. column by 8 line screen to emulate a screen that is 80 x 24, each
  71. feature of 100/100 has been carefully chosen and designed to give
  72. you the most flexibility in an easy to use format - all while
  73. maintaining performance very close to the original TELCOM program
  74. inside your Model 100.
  75.  
  76. This manual has three sections.  SECTION I is a general overview
  77. of the capabilities and limitations of 100/100 and a summary of
  78. how to use its functions.  Beside providing an overview, the
  79. technical user, or the user very familiar with the Model 100 may
  80. find it all he/she needs to use the 100/100 program.
  81.  
  82. SECTION II provides more detail as to how to load and save the
  83. program and a more step by step approach with examples on how to
  84. use each feature of 100/100.  It also details how to relocate the
  85. program, and how to use it in conjunction with DIRACC 100 by Hugo
  86. Ferreyra.
  87.  
  88. SECTION III gives information that a technical or more
  89. experienced user may be interested in, regarding the program's
  90. use of memory, and information useful in avoiding conflicts with
  91. other machine language programs.  This section also explains what
  92. you may experience in using the VT100 emulator  due to limited
  93. features or features which have not been implemented.
  94.  
  95. Appendix A discusses XON/XOFF and how to toggle between disabled
  96. and enabled within the emulator, including when, if ever, this
  97. feature would be useful.
  98.  
  99. Appendix B details how to use 100/100 with the Xmodem program on
  100. CompuServe named SXM.100.  Enhancements to SXM are explained,
  101. including the ability to enter TELCOM or VT100 and then return to
  102. the Xmodem program without having to redial.
  103.  
  104. LIST OF PROGRAMS AND UTILITIES INCLUDED
  105.  
  106. 100/100 includes a complete suite of programs to allow you to do
  107. most anything you need and tailor it to your own requirements. 
  108. If you are receiving a tape or Portable Disk Drive (PDD) copy of
  109. the programs, the files with the ".CO" extensions will be
  110. included and will be ready to run.  If you are downloading from
  111. an electronic bulletin board, the loader programs will be the
  112. ones you will need.  They will, however, end in the extension
  113. ".DO" instead of ".BA".  They are the ASCII (Text) versions of
  114. the BASIC programs, since they are easier to download than the
  115. binary (or tokenized versions) with the ".BA" extensions.  For
  116. example, VTLDR.BA will most likely appear on the bulletin board
  117. as VTLDR.DO.  After downloading, enter BASIC on the MODEL 100/102
  118. and type LOAD "VTLDR.DO".  This will convert the text file to a
  119. BASIC program.  You can then save it by typing SAVE "VTLDR.BA",
  120. or you can leave it in text format and just type RUN after
  121. loading, to run it as a BASIC program.  It will then create the
  122. VT100.CO program.  Since ".CO" programs can't be downloaded
  123. without special telecommunications programs, all files downloaded
  124. must be text.
  125.  
  126. VT100.CO - This is the main program, machine language VT100
  127. Emulator Program.  It occupies 3406 bytes of high memory from
  128. 59554 to 62960.  It is relocatable to any memory location by
  129. using the loader program below.  
  130.  
  131. VTLDR.BA (.DO) - With this BASIC loader program, VT100.CO can be
  132. loaded into any memory address.  If other machine language
  133. programs conflict with VT100, this program will allow relocation. 
  134. Since the program contains all the data within itself, no
  135. additional loader data file is required.  8300 bytes long.
  136.  
  137. DIRPOK.BA (.DO) - Basic program used to activate F7 in Telcom to
  138. use DIRACC 100, a 152 byte machine language program by Hugo
  139. Ferreyra, used to access BASIC and the TEXT program while
  140. on-line.  This program also is used to redefine F7 for use with
  141. SXMACC to allow TELCOM and VT100 to be entered from a BASIC
  142. program such as SXM.100 Xmodem program.  Re-entry back to BASIC
  143. is made possible with this method.
  144.  
  145. DIRACC.BA (.DO) - The BASIC loader program by Hugo Ferreyra which
  146. creates the 152 byte add-on machine code as described above.
  147.  
  148. VT100D.CO - machine language code which combines the DIRACC
  149. program and VT100 together already.  If you receive these
  150. programs on disk or tape and don't need to relocate them, this is
  151. a ready to go program of VT100 and the DIRACC add-on which you
  152. just load and run.
  153.  
  154. SETUP.BA (.DO) - Basic program used to change default parameters
  155. of VT100 such as tab stops, autowrap and new-line mode.
  156.  
  157. DEFKEY.BA (.DO) - Basic program to define Function key 7 if
  158. DIRACC is not to be used.  Defaults to defining F7 to display
  159. files and free memory while on line.
  160.  
  161. SXMACC.CO - a machine-language module to be added to VT100 to
  162. allow its use with SXM 100 and other BASIC program which need to
  163. be able to call TELCOM and VT100 and return to the BASIC program.
  164.  
  165. SXMLDR.BA (.DO) - a loader program used to relocate SXM to match
  166. a relocated VT100.CO.
  167.  
  168. VTSXM.CO - VT100 with SXMACC.CO already combined and the function
  169. keys defined to allow use with SXM.100 and other BASIC programs
  170. (3499 bytes long, from 59462 to 62960 - not relocatable)
  171.  
  172. SXMMRG.DO - A patch to be merged with SXM 100, a BASIC program
  173. available on CompuServe and other bulletin boards which supports
  174. the Xmodem protocol for file transfer.
  175.  
  176. SXM.BA (.DO) - the SXM 100 program which allows Xmodem file
  177. transfer using the built in modem only.
  178.  
  179. SXMDOC.DO - the documentation file for the SXM 100 Xmodem program
  180. listed above.
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.                             SECTION I
  188.  
  189. OVERVIEW
  190.  
  191. 100/100 is a machine language program for the Model 100/102 that
  192. emulates the functions of the Digital VT100 terminal.  It allows
  193. the Model 100 to be used to access VAX and other computers and
  194. use programs which are screen oriented and require VT100
  195. compatibility.  It decodes the ANSI escape sequences and performs
  196. the proper action.  Text scrolls horizontally to simulate an 80
  197. column screen as the data is received and the program saves 80
  198. columns by 24 lines of data to be displayed in six windows by
  199. using the Model 100 function keys.
  200.  
  201. Although not all of the VT100 functions can be emulated on the
  202. Model 100, many of the features have been, including:
  203.  
  204. Tabs: up to ten horizontal tabs can be set.  Tabs set after the
  205. tenth are ignored. Tabs can also be cleared under program control
  206. or with the Setup program that is included.
  207.  
  208. Cursor keys:  the Model 100 cursor keys emulate the VT100 cursor
  209. keys, both in  cursor and application mode.
  210.  
  211. Keypad:  the VT100 keypad is also emulated using the graph key in
  212. conjunction with the keys labeled for use with the "NUM" key.
  213. (eg: GRAPH m = 0 on the VT100 keypad).
  214.  
  215. Scrolling Regions:  100/100 supports software selection of top
  216. and bottom margins to create scrolling regions smaller than the
  217. entire screen.
  218.  
  219. Reverse Scrolling:  The screen will scroll down when a reverse
  220. index command is received and the cursor is at the top margin.
  221.  
  222. Direct Cursor addressing:  The program will move the cursor to
  223. the proper location (HVP and CUP commands, etc.)
  224.  
  225. What are you?:  100/100 will respond properly when asked to
  226. identify itself, allowing use of programs which normally abort
  227. automatically if your are not using a VT100.
  228.  
  229. Erasing:  supports all the VT100 erase functions, cursor to end
  230. of line, end of screen, clear screen, etc.
  231.  
  232. Editing:  supports both replace and insert character mode as well
  233. as insert line and delete line commands.
  234.  
  235. Autowrap: Characters received will wrap automatically at the
  236. right margin if the feature is turned on, otherwise it defaults
  237. to no wrap at column 80.
  238.  
  239. Line Drawing Character Set:  100/100 will emulate the line
  240. drawing characters of the VT100 character set only.  Other
  241. special characters are not translated.
  242.  
  243. Newline Mode: both new line and no new line on linefeed are
  244. supported, either under program control or using the Setup
  245. Utility included.
  246.  
  247. Device status or cursor positioning reports.
  248.  
  249. Save and Restore Cursor
  250.  
  251. FEATURES NOT IMPLEMENTED
  252.  
  253. 132 column mode
  254. Origin relative mode 
  255. VT52 Mode
  256. Smooth scrolling
  257. Local Echo
  258. Alternate character sets 
  259. Attributes such as reverse video, bold or blinking.  (These
  260. commands are trapped however, to prevent garbage on the screen)
  261. Double-width or double-height characters
  262.  
  263. TELCOM COMPATIBILITY
  264.  
  265. 100/100 works in conjunction with TELCOM, so Autodial, Echo to
  266. printer, Uploading and Downloading are all available.  You must
  267. first enter terminal mode of TELCOM then use F6 to enter the
  268. VT100 emulator.  100/100 works equally well with either the
  269. built-in modem or the RS232 port.  During an online session, a
  270. user can switch back and forth between the VT100 and TELCOM at
  271. will using the F6 key.  This is particularly useful, not only to
  272. be able to use UPLOAD and DOWNLOAD in TELCOM, but because text
  273. files are sometimes easier to read in 40 column wrap mode than 80
  274. column horizontal scroll mode.  
  275.  
  276. In addition, 100/100 is completely compatible with the DIRACC.100
  277. program on CompuServe.  The F7 key while in TELCOM is defined by
  278. 100/100 to bring up the prompt "<T>ext or <B>asic".  The selected
  279. reponse jumps the user to the proper portion of the DIRACC
  280. program.  After editing a file or executing BASIC commands,
  281. DIRACC then returns you back to TELCOM while maintaining the
  282. connection.
  283.  
  284. XMODEM AND 100/100
  285.  
  286. To use this program with SXM.BA, a CompuServe program allowing
  287. file transfer with Xmodem protocol, see appendix B.
  288.  
  289.  
  290. MODEL 100 FUNCTION KEYS WITHIN TELCOM
  291.  
  292. The function keys remain the same in  TELCOM with the exception
  293. that 100/100 defines the F6 and F7 keys as follows::
  294.  
  295. F6 will enter VT100 mode
  296. F7 will bring up the prompt to enter "<T>ext or <B>asic.  If
  297. DIRACC is loaded and DIRPOK has been run, pressing 'T' will bring
  298. the user to TEXT, where a file can be created, or edited off-line
  299. for later uploading. F8 will exit text and reenter TELCOM. 
  300. Pressing 'B' at the previous prompt will bring the user to BASIC,
  301. where programs can be run or files killed.  Exiting to Menu,
  302. however, will disconnect the line.  To reenter TELCOM, press F6,
  303. which should be defined as "CALLHIMEM"+chr$(13).  Running the
  304. DIRACC loader program will set the F6 function key to do this. 
  305. Section II explains this process in greater detail.
  306.  
  307. MODEL 100 FUNCTION KEYS WITHIN VT100 MODE
  308.  
  309. Pressing F6 in TELCOM enters VT100 mode which redefines the
  310. function keys.  The Model 100's 40 column by 8 line screen is a
  311. window into one sixth of a normal 80 column by 24 line VT100
  312. screen.  In VT100 mode, the following keys are used for special
  313. functions:
  314.  
  315. F1 will show Section 1 of the VT100 screen.  As illustrated in
  316. FIGURE 1 below, this is the upper most left sixth of the screen
  317. (lines 1-8, columns 1-40)
  318. F2 will show Section 2, the middle left sixth of the screen
  319. (lines 9-16, columns 1-40)
  320. F3 will show Section 3, the lower left sixth of the screen (lines
  321. 17-24, columns 1-40)
  322. F4 will move down four rows from whatever vertical and horizontal
  323. position is presently being viewed.
  324. F5 will display columns 1-40 at the present vertical position. 
  325. If already at the left margin, no action will be taken
  326. F6 will display columns 21-60, showing the middle section of the
  327. screen.  The vertical position  coincides with the current
  328. vertical position.
  329. F7 will display the left side of the screen, columns 41-80 in its
  330. present vertical position.
  331. PASTE -the PASTE function key- will return to the original screen
  332. where the cursor is presently located and exit view mode.  The
  333. PASTE key is also used to exit fast mode and resume full echo to