home *** CD-ROM | disk | FTP | other *** search
/ Boston 2 / boston-2.iso / DOS / PROGRAM / BASIC / POWBASIC / LIBRARY2 / PBPLUS.ZIP / PBPLUS96.DOC next >
Text File  |  1990-05-12  |  5KB  |  103 lines
  1.  
  2.               This file contains documentation for PBPLUS96
  3.              (Copyright 1990 by Robert Zale)
  4.      =================================================================
  5.  
  6. PBPLUS96 is a program which can be used in conjuction with PowerBASIC
  7. version #2.00 in order to obtain an additional 96K of memory for compiling
  8. and running programs.
  9.  
  10. Several conditions must be met in order to use this extra memory:
  11.  
  12.   1. You must have an EGA or VGA graphics card present in your system,
  13.      with at least 128K of memory installed on it.
  14.  
  15.   2. No other software or hardware in your system can use the memory
  16.      located at A0000..B7FFF hex (except for the graphics card).  Note that
  17.      some EMS expanded memory drivers or XMS extended memory drivers may
  18.      try to use this area of memory.  PBPLUS96 makes every attempt to
  19.      determine whether another program is using this memory before it takes
  20.      control of it, but some programs which use non-standard memory
  21.      allocation methods may not be detectable.  If you are at all unsure
  22.      of which memory areas your applications require, do not execute this
  23.      program in conjunction with them.  If an undetected conflict occurs,
  24.      using PBPLUS96 will most likely cause your system to crash, resulting
  25.      in the loss of all data in memory.
  26.  
  27.   3. You must be in 80-column color text mode (BIOS video mode 3) when
  28.      PBPLUS96 is invoked, and you must remain in that mode until you
  29.      release the memory by executing PBPLUS96 OFF.  PBPLUS96 takes over
  30.      the BIOS video interrupt (10 hex) and ignores requests which would
  31.      change the video mode or otherwise disturb the 96K memory area.
  32.      PBPLUS96 cannot trap direct writes to EGA/VGA graphics registers,
  33.      however.  Executing a program which performs direct writes while
  34.      PBPLUS96 is active will most likely cause your system to crash.
  35.  
  36.  
  37. To set aside the 96K of video memory for use by PowerBASIC, execute PBPLUS96
  38. with the ON command-line option:
  39.  
  40.     PBPLUS96 ON
  41.  
  42. PBPLUS96 takes over the BIOS video interrupt (10 hex).  It also places a TSR
  43. (terminate-and-stay-resident) program in memory.  This program requires
  44. about 8K and remains in memory until your system is rebooted.
  45.  
  46. At this point you can use PowerBASIC to compile and/or run programs.
  47. Remember that your programs cannot change the video mode (in order to
  48. perform graphics, for instance) or do anything else which would cause the
  49. memory from A0000..B7FFF (hex) to be disrupted.  Attempting to do so may
  50. cause unpredictable results, quite possibly including a system crash.  Your
  51. programs may take over interrupt 10 (hex), but they must restore it to its
  52. original value before terminating.  Failure to do so will prevent the later
  53. deallocation of the 96K memory area, eventually necessitating a system reboot
  54. to restore your normal memory configuration.
  55.  
  56. When you are finished using the extra memory, execute PBPLUS96 with the OFF
  57. command-line option:
  58.  
  59.     PBPLUS96 OFF
  60.  
  61. This will restore the video interrupt (10 hex) to where it was pointing
  62. before PBPLUS96 ON was executed, and will return the 96K of video memory
  63. to the EGA/VGA card.  The TSR will remain in memory.  At this point, the
  64. video system will appear to be "normal" to any programs that are subsequently
  65. executed; that is, you can perform graphics or any other video operations
  66. which would otherwise disrupt the PBPLUS96 memory.
  67.  
  68. To acquire the memory again later, simply execute PBPLUS96 ON again.  To
  69. release it, execute PBPLUS96 OFF.
  70.  
  71.  
  72. Due to the nature of PBPLUS96's interaction with your video hardware and
  73. BIOS software, we cannot guarantee that it will work properly with all
  74. programs in all circumstances.  In particular, executing a program which
  75. deals with the video card or the BIOS directly, or which SHELLs to a program
  76. that does, may cause unpredictable results.  In order to limit the
  77. possibility of such conflicts, you should activate PBPLUS96 only when it is
  78. necessary in order to compile or run a large program.  Once the compile or 
  79. run is finished, you should execute PBPLUS96 OFF to release the video memory.
  80.  
  81. As an example, you may wish to set up a batch file which takes the memory,
  82. uses the command-line compiler (PBC.EXE) to compile a program to an .EXE
  83. file, pauses after compilation, then releases the memory:
  84.  
  85.     PBPLUS96 ON
  86.     PBC -CE %1 %2 %3 %4 %5 %6 %7 %8 %9
  87.     PAUSE
  88.     PBPLUS96 OFF
  89.  
  90. The pause is necessary so that you can see any error messages or statistics
  91. displayed by PBC.EXE, before PBPLUS96 clears the screen.
  92.  
  93. A similar batch file runs the PB.EXE compiler:
  94.  
  95.     PBPLUS96 ON
  96.     PB %1 %2
  97.     PBPLUS96 OFF
  98.  
  99. In this case, pause is not neccessary, as PB.EXE does not exit to DOS after
  100. compilation.
  101.  
  102. ============================================================================
  103.