home *** CD-ROM | disk | FTP | other *** search
/ Jason Aller Floppy Collection / 60.img / VMOS.ZIP / READ.ME < prev    next >
Text File  |  1990-01-25  |  14KB  |  368 lines
  1.                   StarPath Systems Incorporated
  2.       Vmos/3 version 1.1 release notes (pre-release version)
  3.                          January 25, 1990
  4.  
  5.                        
  6.  
  7. Installing a new system
  8. -----------------------
  9. To install Vmos/3 on the default C: drive, place a copy of the 
  10. installation disk in drive A: and type:  
  11.         A:INSTALL <Enter> 
  12.  
  13. To install on a different drive:, type:  
  14.         A:INSTALL <drive specifier> <Enter> 
  15.  
  16.  
  17.  
  18. Updating an existing system
  19. ---------------------------
  20. To update Vmos/3 on all installed drives, type:  
  21.         A:UPDATE <Enter> 
  22.  
  23. This will automatically search disk drives C:, D:, E: and F: for 
  24. an active \VMOS directory. 
  25.  
  26. To update only a specific drive type:  
  27.         A:UPDATE <drive specifier> <Enter>       
  28.  
  29.  
  30.  
  31. Preparation
  32. -----------
  33. Configure the system hardware to DISABLE all shadow ROM and EMS.  
  34. These features are sometimes provided by the system BIOS and 
  35. controlled during CMOS ROM Setup.  
  36.  
  37. Vmos/3 directly supports the shadowing of the system BIOS and EMS 
  38. 4.0 emulation.  Any other software providing these services 
  39. directly conflicts with the operation of Vmos/3.
  40.  
  41. Remove all device drivers (other than hard disk drivers) and TSRs 
  42. before starting Vmos/3 for the first time.  See CONFIG.SYS 
  43. considerations, below for more information.
  44.  
  45.  
  46.  
  47. Starting
  48. --------
  49. To start Vmos/3 type:  
  50.         CD \VMOS
  51.         VMOS <options>
  52.  
  53. <options> is one or more option flags.  Each is an upper case or 
  54. lower case character.  Some have a numeric value following 
  55. immediately (with no space between).  Generally, upper case 
  56. enables an option, lower case disables it.  For detailed 
  57. information about option flags, see Command Line Options, below. 
  58.  
  59.  
  60.  
  61. Customizing
  62. -----------
  63. VMOSAUTO.BAT is executed each time a new DOS Session is created.  
  64. VMOSAUTO.BAT displays a HELLO message from the file \VMOS\HELLO, 
  65. and sets the DOS Prompt for the new Session, then looks for a 
  66. batch file, NEWTASK.BAT.  If found, NEWTASK.BAT will execute at 
  67. the end of VMOSAUTO.  Using it, you can start particular DOS 
  68. programs for specific DOS Sessions.  Examples are included in the 
  69. two batch files.  Please examine them carefully to see if 
  70. changing them would be useful to you. 
  71.  
  72. The \VMOS\HELLO file gives some brief instruction, and refers to 
  73. specific poritons of the Reference Guide.  This file may be 
  74. modified or deleted, as is useful to your particular 
  75. implementation. 
  76.  
  77.  
  78.  
  79. Changes in Version 1.1
  80. ----------------------
  81. Memory System and Swap File - Because virtual paging supports 
  82. logical RAM over and above physical RAM, a paging file large 
  83. enough to support the desired maximum RAM and EMS should be 
  84. allocated.  The default maximum paging file is 4mb.  Swap file 
  85. space above 4mb is allocated using the S option on the VMOS 
  86. command line.  See New Command Line Options, below. 
  87.  
  88.  
  89. EMS - Up to 32 megabytes per DOS Session can be supported.  The 
  90. number of EMS Pages available to each Session is determined by 
  91. the following calculations when the Session is created: 
  92.  
  93. System Pages = (Swap File Pages + RAM Pages) / 4
  94.  
  95. If System Pages < 96 then EMS Pages = 16
  96.                      else EMS Pages = System Pages - 64
  97.  
  98. For example, a 2mb 386 system with a Vmos/3 Swap File of 4mb 
  99. (default) would result in the following calculation to determine 
  100. EMS Pages:
  101.  
  102. Swap File Pages = 1024
  103. RAM Pages = 512
  104. System Pages = 384
  105. Pages for EMS = 320
  106.  
  107. 320 EMS Pages results in about 1.2mb of EMS available for each 
  108. DOS Session.  To increase this amount, add about twice the 
  109. desired increase to the Swap File size.  
  110.  
  111. To raise this example to 8mb EMS (about 7mb more EMS), use a Swap 
  112. File size of about 28mb (24mb more than the default).  This is 
  113. done with an <option> parameter of S28000.  See Command Line 
  114. Options, below, for an explanation of the S <option>. 
  115.  
  116.  
  117. BUFFERS - Earlier versions of Vmos/3 suggested use of BUFFERS=1 
  118. in the CONFIG.SYS file.  With the improved version of the disk 
  119. cache, a more typical value of BUFFERS=20 is recommended.
  120.  
  121.  
  122. Initialization Screen - When starting Vmos/3, an Initialization 
  123. Screen is produced with startup diagnostic and configuration 
  124. information.  Part or all of the Initialization Screen can be 
  125. disabled using a command line option when starting Vmos/3.  See 
  126. Command Line Options, below for details on the C option.
  127.  
  128.  
  129.  
  130. Technical Advisory Notes (TANs)
  131. -------------------------------
  132. Currently available TANs are included on your Vmos/3 release 
  133. disk.  These files may be printed or displayed to view.  The 
  134. topics covered in each are: 
  135.  
  136. TAN001.TXT  - COM port configuration
  137. TAN002.TXT  - Mouse configuration
  138. TAN003.TXT  - LAN configuration and IRQ mapping
  139. TAN004.TXT  - One megabyte systems
  140.  
  141.  
  142.  
  143. Vmos/3 Command Changes
  144. ----------------------
  145. The Configure Quiet Command allows the display of the Command 
  146. Line while in Operator Mode.  This speeds the processing of 
  147. Commands in VMOSCONF or in the DOS Load File Command.  To inhibit 
  148. display of the Command Line:
  149.         Configure Quiet On
  150.  
  151. To enable display of the Vmos/3 Command Line (the default):
  152.         Configure Quiet oFf
  153.  
  154. CAUTION:  Be sure to re-enable the display of Command Line 
  155. information using the Configure Quiet oFf Command.  Failure to do 
  156. so will result in no further display of Commands, even when typed 
  157. from the keyboard.  
  158.  
  159. If this occurs, strike ESC several times to return the OCS to the 
  160. begining of a new Command, then strike the letters invoking the 
  161. Configure Quiet oFf Command, C Q F <Enter>. 
  162.  
  163.  
  164. The DOS Session Command creates Sessions providing a maximum 
  165. amount of DOS memory compatible with the current video in use.  
  166. No special effort is required to ensure the maximum RAM 
  167. configuration.  
  168.  
  169. The DOS Display Command has been changed to better integrate 
  170. dual video monitors and provide maximum logical RAM for each DOS 
  171. Session. 
  172.  
  173. In dual monitor systems, Sessions can be created specifically for 
  174. one monitor.  The DOS sessionDisplay Command is used to select a 
  175. particular monitor and configure the maximum amount of DOS 
  176. Session memory possible. 
  177.  
  178. The DOS Display Command now appears as follows:
  179.         DOS sessionDisplay mGa Vga Ega Cga
  180.  
  181. mGa Sessions are configured with 720kb 
  182. CGA Sessions are configured with 760kb
  183. Vga and Ega Sessions are configured with 640kb
  184.  
  185.  
  186.  
  187. The DOS Load deVice Command has been changed slightly from its 
  188. description on pages 4-2 and 4-3 in the Reference Guide.  The 
  189. segment parameter is limited to a 4 character segment address, 
  190. rather than the segment and offset defined in the Reference 
  191. Guide.  The example appearing on page 4-3 of the Reference Guide 
  192. is corrected as follows: 
  193.         DOS Load deVice B000 4 C:\ANSI.SYS
  194.  
  195.  
  196.  
  197. Command Line Options 
  198. --------------------
  199. These are provided on the VMOS command line.  Each <option> is 
  200. represented by a letter and, optionally, a number following 
  201. immediately.  
  202.  
  203. For an <option>, an upper case letter enables the option, lower 
  204. case disables it.  Options are: 
  205.  
  206. (default)   H         - Cache for approximately one track of disk data
  207.             h         - No disk cache
  208.             Hnnnn     - Disk cache is nnnn kilobytes
  209.  
  210. (default)   S         - Allocation as documented (4mb or smaller) 
  211.             s         - No swap file
  212.             Snnnn     - Swap file is nnnn kilobytes
  213.  
  214. (default)   C         - Configuration Summary is displayed    
  215.             CF        - Full Configuration Initialization Screen
  216.             c         - No         "              "          "
  217.             
  218. (default)   L         - Byte locking and Compatibility Mode enabled
  219.             l           Byte locking and Compatibility Mode disabled
  220.  
  221. Specifying no options is equivalent to:  VMOS H S C L
  222.  
  223. H - A disk cache of 500kb or more (option H500) will improve 
  224. performance dramatically, especially on systems without buffered 
  225. 1:1 interleave controllers.  An amount of 500kb or more is 
  226. recommended, except on 1 megabyte systems.  On systems of 4mb or 
  227. larger, a minimum of 1,000kb (option H1000) is recommended. 
  228.  
  229. For 1 megabyte systems, consider the trade off between running 
  230. multiple programs and improved I/O system performance using a 
  231. cache.  If page swapping is very low due to running few, small 
  232. DOS Sessions, then allocating RAM to a very small cache may be 
  233. advantageous.  
  234.  
  235. However, if multiple large DOS Sessions are needed, then 
  236. allocating RAM to a cache may result in inadequate RAM for system 
  237. operation, or increased paging overhead.  A high level of program 
  238. paging will probably remove any performance gain realized from 
  239. the cache. 
  240.  
  241. S - The swap file allocation flag permits those with large swap 
  242. file needs or very small disk resources to control the size of 
  243. the swap file.  The default of upper case S will generate a swap 
  244. file no larger than 4 megabytes or half the remaining disk space, 
  245. whichever is lesser. 
  246.  
  247. s - No Swap File permits operation where full operation within 
  248. physical RAM is desired.  With this option, no disk file is 
  249. created or accessed. 
  250.  
  251. C - For normal operation, the configuration summary is displayed 
  252. during Vmos/3 initialization.  If a problem is encountered, this 
  253. information should be noted and related to StarPath Support.
  254.  
  255. CF - Full startup diagnostic and Configuration information is 
  256. displayed with this option.  If Initialization stops or fails, 
  257. the status information displayed on this screen will be helpful 
  258. to StarPath Support.
  259.  
  260. c - No Configuration Information is displayed when Vmos/3 starts.  
  261. The first DOS Session defined in VMOSCONF is placed into 
  262. Foreground.  If no DOS Session Commands are found, the Operator 
  263. Control Screen is displayed.
  264.  
  265.  
  266.  
  267. CONFIG.SYS Considerations
  268. -------------------------               
  269. Set BUFFERS to 20 or more.
  270.  
  271. Device drivers can be installed in the initial DOS or individual 
  272. DOS Sessions.  
  273.  
  274. When a driver is installed with DEVICE= in CONFIG.SYS, each DOS 
  275. Session will be created with its own copy of the installed 
  276. driver.  
  277.  
  278. To install a driver in the initial DOS, use DEVICE= in the 
  279. C:\CONFIG.SYS file.   
  280.  
  281. Device drivers can also be installed in individual DOS Sessions.  
  282. This has the advantage of not consuming valuable DOS RAM space 
  283. below 640kb in DOS Sessions not needing the driver.
  284.  
  285. To intstall a driver in an individual DOS Session, use the Vmos/3 
  286. DOS Load deVice Command.  See page 4-2 in the Vmos/3 Reference 
  287. Guide and Vmos/3 Command Changes, above. 
  288.  
  289. For the most part, drivers can be successfully installed and used 
  290. this way.  Certain drivers, such as communication interfaces, are 
  291. best installed in the Session using the resource.  
  292.  
  293.  
  294.  
  295. Having Problems?
  296. ----------------
  297. Is your system a 1 megabyte system?  If so, is all ROM shadowing 
  298. disabled?  Some motherboard designs do not return all RAM, even 
  299. with shadowing disabled.  This may result in your system having 
  300. less than the 1mb you believe it to have.  If there is any 
  301. question, contact the system manufacturer.  Vmos/3 requires a 
  302. minimum of one full megabyte of RAM to operate.
  303.  
  304. All ROM shadowing should be disabled on all systems.  Vmos/3 
  305. provides automatic shadowing of the system BIOS, and reverts to 
  306. non-shadowing operation if RAM needs become critical.
  307.  
  308. It is very helpful to have a printer connected to your primary 
  309. parallel port (LPT1) when experiencing problems with Vmos/3.  If 
  310. Vmos/3 detects a problem, it will print diagnostic information 
  311. very helpful to our engineers.  Please keep these "Die" and "GP 
  312. Error" reports and have them ready when you call Support. 
  313.  
  314. Remember to "strip" your CONFIG.SYS and AUTOEXEC.BAT files to the 
  315. bare minimum when you install Vmos/3.  Device drivers and TSRs 
  316. may be added back one at a time after Vmos/3 is operational.  If 
  317. a problem is noticed after a driver is installed, contact Support 
  318. for assistance. 
  319.  
  320. Any device driver or TSR installed before Vmos/3 was started will 
  321. be replicated (cloned) in each DOS Session.  TSRs usually should 
  322. be started only in the DOS Sessions where they are needed.  
  323. Device drivers may also be installed the original DOS or 
  324. individual DOS Sessions.  See CONFIG.SYS Considerations, above, 
  325. for more information. 
  326.  
  327. If a program started in a DOS Session seems to stop until you hit 
  328. a key, then run for a while before stopping again, it's probably 
  329. being suspended by WAIT KEYS.  This means that Vmos/3 thinks it 
  330. is only waiting for keyboard input and doing nothing else, so it 
  331. suspends the Session until a keystroke is seen.  
  332.  
  333. Vmos/3 detects this properly for most programs.  One easy way to 
  334. test this is to press and hold the Shift key with the Session in 
  335. Foreground.  If the program resumes operation while the Shift key 
  336. is depressed, then it confirms WAIT KEYS.  Please notify us of 
  337. the name of the software you were running when this happened.  In 
  338. the short term, you can disable WAIT KEYS for the particular DOS 
  339. Session by using the Command:  DOS Waitkeys <TaskID> oFf 
  340.  
  341.  
  342.  
  343. Problems and questions
  344. ----------------------
  345. For your first 30 days of free support, please report all 
  346. problems and questions to the address, voice phone or FAX below.  
  347. If you encounter a problem, the chances are good that we are 
  348. aware of it and already have completed or are working on the 
  349. solution.  We may be able to provide a temporary operational 
  350. "work around", a corrected version immediately, or will tell you 
  351. when it will be available.  
  352.  
  353. PLEASE COMPLETE AND MAIL YOUR PRODUCT REGISTRATION CARD 
  354. IMMEDIATLY.  WHEN YOU REGISTER YOUR WARRANTY SUPPORT STARTS.  
  355. PLEASE REFER TO THE REGISTRATION MATERIALS ACCOMPANYING VMOS/3 
  356. FOR INSTRUCTIONS ON USING THE SUPPORT. 
  357.  
  358.   Vmos/3 Support
  359.   StarPath Systems Inc.
  360.   4700 S. Hagadorn Rd.
  361.   E. Lansing, MI  48823
  362.   voice:  517/332-1256
  363.     FAX:  517/332-7822
  364.     BBS:  517/332-3644
  365.  
  366.  
  367. 
  368.