home *** CD-ROM | disk | FTP | other *** search
/ ftp.whtech.com / ftp.whtech.com.tar / ftp.whtech.com / club100 / pg / pgxos / xosdoc.do < prev    next >
Text File  |  2006-10-19  |  10KB  |  231 lines

  1. XOS-C.DOC  by Paul Globman (C) 1989
  2.  
  3. [01/12/2000: Paul Globman has agreed to make XOS-C and his other M100/102/T200 software available without any license fee or registration requirements as long as it is not used for commerical purposes.  Paul no longer provides support for any of this software.  Please do not contact him with questions.  I can provide some user experience.  R. H. Pigford <profengr@delanet.com>.]
  4.  
  5.      XOS - X-bank Operating System
  6.              (cross-bank)
  7.  
  8. XOS is a system of three programs that is designed to run in LOMEM of each of
  9. the T200's 3 RAM banks.  These three programs load/install as one program 
  10. interact with one another in such a way that you can have the software of all 3
  11. banks available in any bank.  XOS uses the first 768 bytes in each bank.
  12.  
  13. XOS runs in the location used by Disk Power 200.  With XOS installed, Disk 
  14. Power cannot be used and any attempt to use it could have disastrous results.
  15.  
  16. Installing XOS is simply a matter of 1) loading XOSLDR.CO and XOSDAT.CO into
  17. the same RAM bank, 2) HAVE AT LEAST 1K FREE RAM IN EACH BANK TO INSTALL XOS, 
  18. 3) run XOSLDR.CO, and 4) run XOSLDR.CO again (the second execution of
  19. XOSLDR.CO is sometimes needed in a cold started system... run it twice at all 
  20. times to insure proper installation).
  21.  
  22. After running XOSLDR.CO twice, you should move into each bank, enter BASIC
  23. and then return to the menu by pressing F8.  This step should be done before 
  24. moving any files from one bank to another.  The purpose for this step is
  25. to allow BASIC to recognize the new pointers installed into the Tandy 200's
  26. operating system. 
  27.  
  28. XOS was designed to offer cross-bank abilities (as well as other 
  29. enhancements) to the Tandy 200 at the MENU, with BASIC, TEXT, and TELCOM.
  30.  
  31.   ==================================
  32. MENU and TEXT enhancements:
  33.  
  34. XOS will enhance the operation of Menu functions, also offering several TEXT 
  35. utilities like background printing and cross-bank cut/paste.
  36.  
  37. At the Menu, ADRESS and SCHEDL have been made invisible, and the LABEL line
  38. will display up to 7 new functions in addition to the original 3.  The new 
  39. LABEL line will look like this:
  40.  
  41.           Cmd>           Name File     
  42. Bank Back Roms Copy Kill Pste Prnt Menu
  43.  [1]  [2]  [3]  [4]  [5]  [6]  [7]  [8]
  44.  
  45. F2 - REVERSE BANK SWITCHING - press F2 to go to menu of previous bank.
  46.  
  47. F3 - ROMS - press F3 for ROM selection menu.  Modify the use of F3(Roms) with
  48. XOSUTL.BA (provided).
  49.  
  50. F3 - CMD> - press F3 with cursor over BASIC to run a BASIC program.  If the 
  51. cursor is NOT over BASIC, then F3 will run a .CO file.
  52.  
  53. If CAPS LOCK is on, then the file to be executed will default to 3:CMD>.BA or
  54. 3:CMD>.CO, depending upon where the cursor was.
  55.  
  56. If CAPS LOCK is off, then you will be prompted "Cmd>".  Just type in a 
  57. filename (no extension) and press enter.  "3:" is the default bank and needs 
  58. no prefix.  Filename may begin with "1:" or "2:" to indicate file location, if 
  59. not in bank #3.
  60.  
  61. F6 - PASTE BUFFER TRANSFER - move the paste buffer to another bank for 
  62. cross-bank CUT and PASTE operation.
  63.  
  64. F6 - RENAME - rename program or file under cursor.  Allows illegal 
  65. characters and filenames, so use caution.
  66.  
  67. F7 - BACKGROUND PRINTING - press F7 with cursor over DO file.  This duplicates 
  68. SAVE TO LPT: from text.  Once begun, press F7 to abort.  Beep announces 
  69. start and stop of print task.  Printing will be suspended if you switch banks,
  70. switch LOMEM code (F8), or edit a file that is in lower RAM than the file that
  71. is printing.  Background printing will resume when the conditions are restored
  72. to normal.  This is especially useful for sending printer setup codes such as
  73. an ESC-E for emphasized printing.
  74.  
  75. F7 - FILES DISPLAY - press F7 to view the remaining two banks, displayed in 
  76. circular order (1,2,3,1,2), with current bank active for various MENU 
  77. functions.  Shift-F7(File) will restore the normal Menu display.
  78.  
  79. F8 - ADDITIONAL MENU OPTIONS - this will offer the additional options listed 
  80. for F3, F6, and F7.
  81.  
  82.   ===================================
  83. BASIC enhancements:
  84.  
  85. In BASIC, F8 has been re-defined to CALL 40961, which will re-install all XOS 
  86. hooks, should they become dis-engaged.  This can also be accomplished from 
  87. BASIC with the following command...
  88.  
  89. KEY8,"Menu"+chr$(24)+"CALL40961"+chr$(13)
  90.  
  91. XOS will enhance BASIC and M/L capabilities by allowing programmers to
  92. write programs that access other RAM banks.  The BASIC enhancements will 
  93. allow a running program to RUN a BASIC program, LOADM a .CO file, or KILL a 
  94. TEXT.DO file in another bank.
  95.  
  96. The instruction, CALL 41179, will load XBAS-2 into the ALT LCD buffer of the 
  97. current bank.  Once CALLed, 
  98.  
  99. XBAS-2 is used by the BASIC programmer to access files in other banks.  Data 
  100. files (.DO files) in other banks can be KILLed, and BASIC and M/L programs can 
  101. be brought in from other banks and executed in the current bank.
  102.  
  103. Once the BASIC program has executed the "CALL 41179" command, the routines can 
  104. be accessed with the following call:
  105.  
  106.     CALL 63600,CMD,VARPTR(X$)
  107.  
  108. The commands are 7 - KILL FILE.DO
  109.                  8 - LOADM FILE.CO
  110.                  9 - RUN FILE.BA
  111.  
  112. XBAS-2 does internal error checking and will beep if there is a problem.  
  113. XBAS-2 will not execute the wrong instruction and offers the BASIC 
  114. programmer a result descriptor byte so the BASIC program can trap and handle 
  115. problems.  The result descriptor (RD) byte is at 61302, and can be PEEKED 
  116. either before or after a CALL to XBAS-2.
  117.  
  118. KILL FILE
  119. This command is: F$="2:FILE.DO"
  120.                 :CALL63600,7,VARPTR(F$)
  121.  
  122. The RD byte is 0 if the file is found and killed.  The RD byte will retain 
  123. the CMD if the CALL is not sucessful, and a beep will sound.  During program
  124. debugging, a non zero RD means the file was not specified as .DO, the CMD was 
  125. not a seven (7), or the file to be killed, was not found.
  126.  
  127.  
  128. LOADM FILE.CO
  129. This command is: 
  130.  
  131.  F$="2:FILE.CO":CALL 63600,8,VARPTR(F$)
  132.  
  133. If RD=0 then the .CO file was loaded into place and the execution address is
  134. stored at 61303/61304.
  135.  
  136. The load address is stored at 61300/61301.  If these two bytes are both 0 
  137. then the file was not found.  Otherwise 61300/61301 has the load address of the
  138. file and HIMEM has to be cleared for this file to LOADM.
  139.  
  140.  
  141. RUN FILE.BA
  142. This command is: 
  143.  
  144.  F$="2:FILE.BA":CALL 63600,9,VARPTR(F$)
  145.  
  146. Your program will load and run the BASIC program F$, so if the program making 
  147. the call continues, then F$ wasn't found.  The RD would reflect the command 9.
  148.  
  149. For all XBAS-2 commands, the user must check RD and pointer addresses, 
  150. IMMEDIATELY after the CALL 63600.
  151.  
  152. The original XOS offered XBASIC.  To retain the features of XBASIC you must 
  153. store XBASIC.CO in bank #3.  Now the following code is the equivalent of 
  154. LOADM"XBASIC".
  155.  
  156. 10 CALL 41179             'LOADM XBAS-2
  157. 20 X$="3:XBASIC.CO"       'SPECIFY FILE
  158. 30 CALL63600,8,VARPTR(X$) 'LOADM XBASIC
  159. 40 IFPEEK(61302)<>0THEN99 'TEST LOAD
  160.  
  161. Now XBASIC is loaded and CALL 63600 is available with commands 1 thru 6.  A 
  162. simple CALL 41179 will reload XBAS-2 for commands 7,8, and 9.
  163.  
  164. BASIC programs are brought into the unsaved program buffer, and executed by
  165. IPL of the unsaved buffer progradisastIC programs called in by the CMD> 
  166. key should begin with the IPL"" statement to prevent it from unwanted 
  167. execution.
  168.  
  169. Attempts to alter the POWER time setting must be followed by POKE 40962.  Ex:
  170.  
  171.  10  POWER 100:POKE40962,100
  172.  20  POWER CONT:POKE40962,0
  173.  
  174.   =================================
  175. TELCOM enhancements:
  176.  
  177. XOS adds the following to TELCOM's TERM mode...
  178.  
  179.   F6 = display files and bytes
  180.   F6+SHIFT = direct access to TEXT
  181.   F7 = jump to TELCOM in next bank
  182.   F7+SHIFT = jmp TELCOM in prev. bank
  183.  
  184. XOS will allow you to jump from bank to bank while on-line with either
  185. an external or internal modem.  And whichever bank you jump to, the hooks
  186. are active to allow you to switch banks again.
  187.  
  188. The TELCOM hook code runs in the last 15 file slots of the directory of each 
  189. bank.  This means that you can have a maximum of 31 files per bank, instead 
  190. of 46.  From the T200 users I have spoken to, this is not a problem.
  191.  
  192. In return for the 15 file sacrifice you get several excellent TELCOM 
  193. enhancements.
  194.  
  195. NOTE: The first time you enter TELCOM in another bank, you will enter the TERM
  196. mode by pressing F4(Term).  Should you exit this bank, and re-enter it, you 
  197. will have to type TERM<ENTER> if F4(Term) doesn't work.
  198.  
  199. Each time you press F3(Cmd>) at the Menu, the TELCOM hooks will be reset in
  200. all three banks so the XOS features are active, in the same way F8 from BASIC 
  201. restores the XOS menu hook.  Programs that alter the TELCOM hooks can now be 
  202. used without concern.
  203.  
  204.   =================================
  205. YOUR CUSTOM 200
  206.  
  207. I have given XOS the ability to be customized.  F3 comes with "Roms" and 
  208. "Cmd>" as its default utilities.  The "Roms" function key can be made to 
  209. offer direct access to your OPTION ROM(s).
  210.  
  211. The "Cmd>" function key can be made to load and run default programs that are 
  212. named CMD>.BA and CMD>.CO in Bank #3 by maintaining CAPS LOCKed.  Unlocking 
  213. CAPS will allow user input to determine file to run.
  214.  
  215.  XOSUTL.BA will allow the redefining of F3(Roms) for your individual use.  
  216.  
  217. Note... UR-2 may disengage the XOS hook.  BASIC F8 will restore the XOS hook as
  218. it returns to the Menu.  Use this to access the NODE ROM and keep XOS engaged.
  219.  
  220. If you run XOSSAV.CO (with XOSDAT.CO in RAM), the current modified F3(Roms) 
  221. will be saved to XOSDAT so future loads of XOSDAT will not require any further
  222. modification.
  223.  
  224.  =====================================
  225. Acknowledgements:
  226.  
  227. James Yi [73327,1653] for part of the LOMEM adjustment code.
  228.  
  229. Randy Hess [73267,552] for beta testing and feedback.
  230.  =====================================
  231.