home *** CD-ROM | disk | FTP | other *** search
/ Der Mediaplex Sampler - Die 6 von Plex / 6_v_plex.zip / 6_v_plex / DISK5 / DOS_41 / TSR32.ZIP / TSR30.DOC < prev    next >
Text File  |  1991-11-22  |  10KB  |  215 lines
  1.                  Changes in TSR Utilities Version 3
  2.                              Kim Kokkonen
  3.                           TurboPower Software
  4.                                11/22/91
  5.                 ------------------------------------
  6.  
  7. This file describes changes in version 3.2 of the TSR Utilities,
  8. relative to an earlier version, 2.9. It assumes familiarity with
  9. previous versions of the utilities. See TSR.DOC for more information.
  10.  
  11. Version 3.0 of the utilities was the first new version for a couple of
  12. years, and included a number of major changes. Version 3.1 of the
  13. utilities was a cleanup version, fixing compatibility problems and
  14. downright bugs discovered in version 3.0. Version 3.2 of the utilities
  15. generalizes the high memory support, so that it no longer requires DOS
  16. 5.0 or a particular version of any memory manager.
  17.  
  18. If you're updating from a previous version of the utilities, be sure
  19. to replace every file with the new version, since many of the programs
  20. work cooperatively.
  21.  
  22. Generally, the utilities have been updated for compatibility with
  23. MS-DOS 5.0, and to support high memory (upper memory blocks) as
  24. implemented by DOS 5.0 and other third party memory managers. Any
  25. memory manager that supports the UMB (upper memory block) features of
  26. XMS (extended memory specification) memory managers should work with
  27. the high memory features of the TSR Utilities. This includes 386MAX
  28. (Qualitas), QEMM386 (Quarterdeck), HIMEM/EMM386 (Microsoft), and
  29. HIDOS/EMM386 (Digital Research).
  30.  
  31. If you're using just the high memory features of MS-DOS 5.0 itself,
  32. without additional memory managers, note that you must have at least
  33. the following in your CONFIG.SYS in order for the TSR Utilities to
  34. access high memory:
  35.  
  36.   DEVICE=HIMEM.SYS
  37.   DEVICE=EMM386.SYS RAM
  38.   DOS=UMB
  39.  
  40. See the discussion of the EMM386.SYS driver in your MS-DOS 5.0
  41. documentation for more information about options compatible with
  42. creating upper memory blocks.
  43.  
  44. With other memory managers such as QEMM and 386MAX you should *not*
  45. put the DOS=UMB statement in CONFIG.SYS. (This is a change from
  46. versions 3.0 and 3.1 of the TSR Utilities.)
  47.  
  48. To test whether your memory manager is compatible with the TSR
  49. Utilities high memory features, try entering MAPMEM /U at the DOS
  50. command line. If you get a high memory report from MAPMEM, then you
  51. can assume that the memory manager is compatible with TSR Utilities
  52. 3.0. Because of the lack of complete standards for managing high
  53. memory, the names and attributes of programs in high memory may
  54. sometimes appear garbled: unfortunately there is little we can do
  55. about this without building features specific to particular memory
  56. managers into the TSR Utilities.
  57.  
  58. Note that even if you don't get a high memory report from MAPMEM, you
  59. can still use the TSR Utilities 3.0 without upper memory support.
  60.  
  61. The /U option of DISABLE, MAPMEM, RELEASE, and RELNET activates the
  62. high memory features of these utilities. DISABLE won't deactivate or
  63. reactivate a TSR loaded in high memory unless /U is specified. MAPMEM
  64. doesn't report programs loaded above 640K unless /U is specified.
  65. WATCH, MARK, FMARK, and MARKNET transparently access high memory when
  66. it is available.
  67.  
  68. The /U option causes a fundamental change in the behavior of RELEASE
  69. and RELNET. It is important that you understand what it does in order
  70. to use these utilities properly.
  71.  
  72. When the /U option is *not* specified, RELEASE and RELNET remove
  73. programs in address order. That is, with a few exceptions, they
  74. deallocate any memory blocks that have a memory address greater than
  75. or equal to that of the mark.
  76.  
  77. This behavior is almost never appropriate when TSR's are loaded high.
  78. When high memory is involved, the *chronological* order in which TSR's
  79. were loaded rarely matches the *address* order in which they were
  80. loaded. Before TSR's could be loaded high, these two orderings were
  81. usually the same, so no distinction was necessary. Now, however, it's
  82. common to load one program high, then one low, then another high; or
  83. to load one program into "region 2" of high memory, then another into
  84. "region 1", and so on.
  85.  
  86. Therefore, when the /U option is activated, RELEASE and RELNET release
  87. memory in *chronological* order. That is, they free up all memory
  88. blocks allocated since the time the mark was placed, regardless of the
  89. address position of the memory. Additional information is now stored
  90. in the mark file or memory mark to allow this to occur. Only when /U
  91. is specified do RELEASE and RELNET access high memory.
  92.  
  93. If you have *any* TSR's loaded into high memory, you should use the /U
  94. option, even if the particular TSR you're unloading is located in low
  95. memory. Depending on the chronological order in which you loaded the
  96. TSR's, an unload from low memory may also trigger unloads from high
  97. memory, or vice versa.
  98.  
  99. When you intend to use the /U option, you must provide a unique mark
  100. name for each mark (because there is no unambiguous way to find the
  101. correct unnamed mark). A mark name is inherent in the filename
  102. specified to FMARK and MARKNET.
  103.  
  104. Because of the chronological nature of RELEASE /U, you can load the
  105. MARK high and the associated TSR low (or vice versa) if desired.
  106.  
  107. --------------------------------------------------------------------
  108.  
  109. The following list details the changes made for version 3.2 to each
  110. program in the TSR Utilities:
  111.  
  112. DEVICE.EXE
  113.   - no substantive changes
  114.  
  115. DISABLE.EXE
  116.   - deactivates programs loaded high if the new /U option is specified
  117.   - uses a feature new to DOS 5 to find TSR's by name even if they
  118.     have released their environment
  119.   - new /Q option prevents writing any screen output
  120.  
  121. EATMEM.COM
  122.   - no substantive changes
  123.  
  124. FMARK.COM
  125.   - new /Q option prevents writing any screen output
  126.   - stores new "mcb chain" section of mark file for use in releasing
  127.     programs loaded high
  128.   - the mark itself may be loaded high
  129.  
  130. MAPMEM.EXE
  131.   - rewritten from scratch to allow reporting of upper memory blocks
  132.   - fixes problems that occurred when TSR's were loaded in CONFIG.SYS
  133.   - low memory report includes pre-DOS memory blocks so that the
  134.     blocks total to 640K
  135.   - reports on device driver memory allocation under DOS 5 when the /V
  136.     option is active
  137.   - reports EMS handle names when available
  138.   - uses a feature new to DOS 5 to report TSR's by name even if they
  139.     have released their environment
  140.   - modifies some command line options (type MAPMEM /? to see current
  141.     options)
  142.   - new /C option checks for presence of a named TSR
  143.     (syntax: /C TsrName). Halts with ErrorLevel 2 if the TSR isn't
  144.     loaded, ErrorLevel 1 if there is a command line syntax error, or
  145.     ErrorLevel 0 if the TSR is loaded. Note that this feature does not
  146.     require WATCH to be in memory.
  147.   - new /F option reports on just the free memory blocks available in
  148.     normal, high, expanded, and extended memory
  149.   - new /Q option prevents writing any screen output when the /C
  150.     option is used
  151.   - new /S option reports a summary of all memory areas
  152.   - new /U option activates upper memory reporting
  153.   - new /X option activates reporting of extended (XMS) memory
  154.   - supports some segment naming conventions of DRDOS 6
  155.   - fixes problem with TSRs that shrink their environment to zero size
  156.     (Flushot+)
  157.  
  158. MARK.COM
  159.   - new /Q option prevents writing any screen output
  160.   - stores new "mcb chain" section of memory mark for use in releasing
  161.     programs loaded high. This increases the amount of memory used for
  162.     a mark by about 50 to 500 bytes depending on the number of memory
  163.     blocks allocated.
  164.   - the mark itself may be loaded high
  165.  
  166. MARKNET.EXE
  167.   - new /Q option prevents writing any screen output
  168.   - stores new "mcb chain" section in mark file for use in releasing
  169.     programs loaded high
  170.   - saves BIOS data area associated with LPT ports
  171.   - saves XMS (extended memory) allocation state
  172.   - the mark itself may be loaded high. Note, however, that MARKNET
  173.     needs up to 18K of free memory when it is initially loaded, even
  174.     though it keeps less than 300 bytes when it goes resident.
  175.  
  176. RAMFREE.COM
  177.   - now supports >640K free RAM
  178.   - adds current environment block size to reported free RAM
  179.  
  180. RELEASE.EXE
  181.   - fixes problems that occurred when TSR's were loaded in CONFIG.SYS
  182.   - closes open file handles of released memory blocks
  183.   - updated for new behavior of WATCH
  184.   - new /Q option prevents writing any screen output
  185.   - new /U option allows it to remove programs loaded high
  186.   - increases maximum number of memory blocks to 256
  187.   - won't do an unnamed release on a memory mark loaded prior to a
  188.     file mark
  189.   - reverses order in which memory blocks are released to work
  190.     correctly with 386MAX high memory
  191.   - merges free blocks in high memory when possible (QEMM doesn't do
  192.     this automatically)
  193.  
  194. RELNET.EXE
  195.   - fixes problems that occurred when TSR's were loaded in CONFIG.SYS
  196.   - updated for new behavior of WATCH
  197.   - new /Q option prevents writing any screen output
  198.   - new /U option allows it to remove programs loaded high
  199.   - increases maximum number of memory blocks to 256
  200.   - adds automatic cancellation of NetWare IPX event control blocks,
  201.     now allowing independent release of Novell's NETBIOS.EXE TSR
  202.   - new (in 3.1) /I option prevents cancellation of IPX control blocks
  203.   - restores BIOS data area associated with LPT ports
  204.   - restores XMS (extended memory) allocation state
  205.   - reverses order in which memory blocks are released to work
  206.     correctly with 386MAX high memory
  207.   - merges free blocks in high memory when possible (QEMM doesn't do
  208.     this automatically)
  209.  
  210. WATCH.COM
  211.   - corrects problem that occurred when TSR's unloaded themselves
  212.   - WATCH itself may be loaded high
  213.   - adds support for TSR's loaded high
  214.   - reduce resident size of WATCH by about 1000 bytes
  215.