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