home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / UTILITY / SYSTEM / EATMEM11.ZIP / EATMEM.DOC < prev    next >
Encoding:
Text File  |  1991-11-16  |  6.9 KB  |  204 lines
  1.  
  2.  
  3.                                 EATMEM, v1.1
  4.                                 -------------
  5.                                 from TifaWARE
  6.  
  7.  
  8.  
  9.  
  10. What's New
  11. ----------
  12.  
  13.  
  14.      New to version 1.1 is support for Ralf Brown's alternate multiplex
  15. interrupt proposal. Since it specifies a way to handle multiplex ids
  16. dynamically, I have been able not only to get rid of EATMEM's '-m' option
  17. but also to test reliably whether EATMEM has been loaded. I've also added
  18. support for IBM's Interrupt Sharing Protocol, which permits removal of
  19. TSRs in arbitrary order. [Of course, your other TSRs must support this
  20. protocol too for it to be of much use.]
  21.  
  22.      Version 1.0 was the first public release of EATMEM.
  23.  
  24.  
  25.  
  26.  
  27. Introduction
  28. ------------
  29.  
  30.  
  31.      EATMEM is a simple utility to limit memory availability. In this day
  32. of multi-megabyte memory configurations, why would anyone want to do this?
  33. Well, the prime reason is to discover the minimum memory requirements of
  34. programs, whether they run under DESQview, on an ancient PC with less than
  35. 640K, or on a network.
  36.  
  37.      I have implemented EATMEM as a TSR, though its sole purpose is to
  38. take up memory. You specify how many Kbytes of memory to leave; EATMEM
  39. reserves the rest as it goes resident. Then you put other programs through
  40. their paces to see how they deal with RAM-cram. When you're done, you can
  41. uninstall EATMEM to get back where you started from.
  42.  
  43.  
  44.  
  45.  
  46. Usage
  47. -----
  48.  
  49.  
  50.      Running EATMEM is straightforward. Once you've placed the program
  51. where DOS can find it, type EATMEM -? to display a brief help message
  52. similar to the following:
  53.  
  54.      TifaWARE EATMEM, v1.1a, 11/16/91 - TSR utility to limit available memory.
  55.      Usage: eatmem [-options] Kbytes
  56.      
  57.      Options:
  58.        -r    = remove from memory
  59.        -?    = display this help message
  60.      
  61.      Kbytes is the amount of conventional memory to reserve.
  62.  
  63. [If you don't remember anything else, at least remember how to display
  64. this help message.]
  65.  
  66.      Generally you'll invoke EATMEM by specifying the number of Kbytes to
  67. leave free. EATMEM will reserve the rest and return you to the DOS prompt.
  68. For instance, EATMEM 64 would leave you with only 64K of conventional
  69. memory free. Since EATMEM does not do any work in the background, you
  70. shouldn't experience any compatibility problems with it.
  71.  
  72.      A few words of caution though, about how much memory can be reserved.
  73. On one hand, EATMEM needs some memory to install itself, under 1K. On the
  74. other, DOS itself needs some memory to reload its transient portion after
  75. EATMEM has gone resident; the amount varies from one version of DOS to
  76. another but is around 20K - 30K. If you try to reserve too much memory,
  77. then you'll see the error message "Memory allocation error. Cannot load
  78. MS-DOS, system halted." and your machine will crash. Caveat user!
  79.  
  80.      Like any good memory-resident program, EATMEM can be removed from
  81. memory. Just specify the '-r' option. EATMEM will sense whether it's safe
  82. to unhook itself and abort if not. EATMEM should only balk if some other
  83. TSR you have loaded doesn't follow IBM's Interrupt Sharing Protocol.
  84.  
  85.  
  86.  
  87.  
  88. If You Have Any Trouble
  89. -----------------------
  90.  
  91.  
  92.      EATMEM will let you know of problems that arise. Here are the
  93. messages you might see and how you should deal with them:
  94.  
  95.      eatmem: invalid option -- x.
  96.           - Type "EATMEM -?" for a list of valid options.
  97.  
  98.      eatmem: invalid argument.
  99.           - The argument was not a decimal number or was too
  100.             large. Respecify.
  101.  
  102.      eatmem: DOS v1 is not supported.
  103.           - Sorry, you'll have to upgrade.
  104.  
  105.      eatmem: unable to go resident.
  106.           - Either EATMEM found a copy of itself already 
  107.             active in memory, you have over 255 TSRs loaded,
  108.             or there's not enough memory to satisfy your 
  109.             request. Something's gotta go.
  110.  
  111.      eatmem: unable to remove from memory.
  112.           - Some other TSR was installed later that does
  113.             not share interrupts.
  114.  
  115.      eatmem: not yet installed.
  116.           - You must install EATMEM before you can try 
  117.             to uninstall it.
  118.  
  119. These messages are written to the standard error device. In this way, they
  120. won't disappear down a pipe or into a file should you redirect EATMEM's
  121. output.
  122.  
  123.      Additionally, EATMEM uses a return code to convey information about
  124. the success or failure of its operation. Possible return values are:
  125.  
  126.      Code      Meaning
  127.      ----      -------
  128.      0         EATMEM was successfully installed or removed
  129.      1         Help message was displayed
  130.      5         Incorrect DOS version
  131.      10        Installation failed
  132.      20        Removal failed
  133.      25        EATMEM has not yet been installed
  134.  
  135. You can test for these codes using the ERRORLEVEL construct in a batch
  136. file.
  137.  
  138.  
  139.  
  140.  
  141. Requirements
  142. ------------
  143.  
  144.  
  145.      TifaWARE EATMEM runs on machines operating under DOS v2.x or better.
  146. It requires about 1K of memory (plus whatever you tell it to reserve, of
  147. course :-). It uses standard DOS function calls so it should work even on
  148. machines that are not PC-compatible. 
  149.  
  150.  
  151.  
  152.  
  153. Who Owns It?
  154. ------------
  155.  
  156.  
  157.      I am releasing this program into the public domain. Since 1984 I have
  158. used public-domain software extensively, and I find it to be a terrific
  159. idea. Most programs are useful, and the source instructive. And they cost
  160. nothing! With this small contribution to the public domain I hope to pay
  161. back my gratitude to those other programmers who have made my computing so
  162. much easier.
  163.  
  164.      However, this program carries no obligation on my part to support
  165. users or provide future upgrades. I try to write clean code and believe it
  166. is "bug-free". Nevertheless, use this program ***AT YOUR OWN RISK***. Scan
  167. the source yourself, make any desired changes, and recompile the program,
  168. if possible. Make this standard practice with newly-acquired software and
  169. you'll not only protect your system from viruses but also get a better
  170. feel for exactly how programs work!
  171.  
  172.      As author of this program, I have two requests: First, please keep
  173. together the original source code, documentation, and executable if you
  174. distribute the package. This just makes it easier for others to use the
  175. software. Second, let me hear what you think of it - I'd appreciate a
  176. postcard with your comments. Enjoy!
  177.  
  178.  
  179.  
  180.  
  181. Kudos
  182. -----
  183.  
  184.  
  185.      Thanks are due to the authors of _Undocumented DOS_ for arousing my
  186. curiousity about memory allocation in DOS *and* providing a way to satisfy
  187. that curiousity. This book is a gold mine of information about DOS. I 
  188. highly recommend it. 
  189.  
  190.  
  191.  
  192.  
  193.  
  194.                           George A. Theall
  195.  
  196.                              TifaWARE
  197.                        506 South 41st St., #3M
  198.                       Philadelphia, PA.  19104
  199.                               U.S.A.
  200.  
  201.                          +1 215 662 0558
  202.  
  203.                theall@gdalsrv.sas.upenn.edu (Internet)
  204.