home *** CD-ROM | disk | FTP | other *** search
/ Phoenix CD 2.0 / Phoenix_CD.cdr / 02a / njfrer.zip / NJFRERAM.DOC < prev   
Text File  |  1987-05-14  |  7KB  |  172 lines
  1.  
  2.  
  3. NJFRERAM
  4.  
  5. Nifty James' Famous Free Memory Display Program
  6.  
  7. Version 1.12  of  06 May 1987
  8. Version 1.13  of  07 May 1987
  9. Version 2.00  of  19 May 1987
  10.  
  11. Copyright 1987 by Mike Blaszczak
  12. All rights reserved
  13.  
  14.  
  15. Instructions
  16. ------------
  17.  
  18.      NJFRERAM is a short, terminate-and-stay-resident utility.
  19.      It remains in memory, and allows the user to maintain a
  20.      display of free user memory in the upper right corner of
  21.      the screen.
  22.  
  23.      NJFRERAM is installed in memory simply by typing NJFRERAM.
  24.      The program will run and load itself into memory; it takes
  25.      about ~1300 bytes of memory.
  26.  
  27.      NJFRERAM is activated and deactivated by pressing the <Alt>
  28.      and <RightShift> keys simultaneously; that is, depress the
  29.      <Alt> key, depress the <RightShift> key, release the
  30.      <RightShift> key, and then release the <Alt> key.  This key
  31.      combination is used to keep conflicts to a minimum -- I
  32.      know of no other programs that use the <Alt>+<RightShift>
  33. |    key combination.  (And, if you do use a program that makes
  34. |    use of <Alt>+<RightShift>, you can use NJFRE2.COM, also
  35. |    included in this archive.  It's the exact same program,
  36. |    except it watches for <Alt>+<LeftShift>.
  37.  
  38. |    Once NJFRERAM's display has been activated, NJFRERAM will
  39. |    update the display of free memory at the top right corner
  40. |    of the screen every second.  From Version 2.00 up, NJFRERAM
  41. |    is also capable of displaying the amount of memory
  42. |    available on the popular "EMS" or "EEMS" cards.  NJFRERAM
  43. |    will work on either the "EMS" cards, from Intel, or the
  44. |    "EEMS" cards, from AST Research.  If you have an E/EMS
  45. |    card, pressing <Alt>+<RightShift> a second time, after the
  46. |    program has been activated, will display the amount of
  47. |    memory not in use on the card.  This number is only
  48. |    accurate to 16 kilobytes (that is, 16368 bytes), since that
  49. |    is the size of the memory blocks that the E/EMS driver
  50. |    software allocates.
  51.  
  52. |    If you don't have an E/EMS card, pressing
  53. |    <Alt>+<RightShift> again will turn off the display.  If you
  54. |    have an E/EMS card, pressing the keys while the E/EMS free
  55. |    display is up will turn off the display.
  56.  
  57.      Once the display is off, you can again press the keys to
  58.      turn it back on.
  59.  
  60.      I've tested this program heavily, using the various
  61.      programs that I use from day to day.  The program is
  62.      compatible with every piece of software that I use
  63.      regularly.  However, if you find a program that doesn't get
  64.      along with NJFRERAM, please let me know.  If it is
  65.      possible, I will try to update the program to keep it
  66.      working in as many environments as possible.
  67.  
  68. |    It has been brought to my attention, however, that NJFRERAM
  69. |    is *not* compatible with Instant Recall.
  70.  
  71.      Also, please note that NJFRERAM only monitors the memory
  72.      "seen" by DOS.  If you have Intel's EMS or AST's EEMS
  73.      memory in your computer, its presence will not be
  74.      refelected by the display that NJFRERAM generates.
  75.  
  76.  
  77.      Kudos
  78.      -----
  79.  
  80.      This program was an idea of RAY M, one of the other users
  81.      of the IBMSIG on The SOURCE.  Ray is a great guy, and gave
  82.      me the idea to write this useful little utility.
  83.  
  84.      Special thanks to DR FILE FINDER and BOB BRODY.  Without
  85.      their support, Version 2.00 wouldn't be a reality!
  86.  
  87.      Also, great thanks to the people in my "marketing
  88.      department", who helped me decide on a name for the
  89.      program.
  90.  
  91.  
  92.      Points of Interest
  93.      ------ -- --------
  94.  
  95.      The first thing that you'll probably notice when you
  96.      install and run NJFRERAM is that it shows you have 48 bytes
  97.      of memory free.  This is memory that DOS leaves 'lying
  98.      around', for its on use.  When a COM or EXE program is run,
  99.      DOS automatically allocates all of the available memory to
  100.      the program, leaving only these 48 bytes.
  101.  
  102.      For some reason, when DOS is sitting at the command prompt,
  103.      these 48 bytes are also only marked free.  You do indeed
  104.      have more free memory than this.  Strangely, if you type
  105.      the command   EXIT   at the DOS prompt, DOS will release
  106.      that memory, and the real amount of memory avaialble will
  107.      be apparent to NJFRERAM.  (At least, that's the way it is
  108.      under DOS 3.10, my operating system of choice.)
  109.  
  110.      Also, due to the way that some programs run, the NJFRERAM
  111.      display will be stuck at 48 bytes.  This is not a problem
  112.      with NJFRERAM; this is actually the amount of memory that
  113.      DOS 'sees'; remember that it allocated all the free memory
  114.      to the program that was running.  Generally, I've found
  115.      that programs that were written in C, and some programs
  116.      that were written in Assembly Langauge, will allow NJFRERAM
  117.      to show the proper amount of free memory.  More information
  118.      relating to this 'phenomena' can be found in the book "The
  119.      Developer's Guide To MS-DOS", on pages 80-95.  The book is
  120.      published by the Waite Group... it's well worth the
  121.      investment to most programmers.
  122.  
  123.      I've worked with several programs, and it seems that EDWIN,
  124.      the popular user-supported editor, is one of the programs
  125.      that does not allow NJFRERAM to display the correct amount
  126.      of memory.  However, EDWIN does have a command to show the
  127.      free memory.  The program works properly with my other
  128.      editor, The Lattice Screen Editor, which was written in C.
  129.  
  130. |    I've come to another interesting find.  In the DOS
  131. |    Technical Reference Manual, IBM instructs programmers to
  132. |    free a TSR programs' Program Segment Prefix area.  This
  133. |    usually frees betwee 48 and 480 bytes of memory.  In
  134. |    theory.  Actually, no memory is freed up.  Since this
  135. |    memory is lying around inbetween two allocated blocks, DOS
  136. |    will not use it.  So, the amount of free memory that you
  137. |    see at the DOS prompt is not always 48 bytes; sometimes
  138. |    it is zero, sometimes is over 1k.  But, the value will
  139. |    never be correct until you type the EXIT command.
  140.  
  141.      Shareware
  142.      ---------
  143.  
  144.      If you find this program useful, please send a small
  145.      contribution.  $7 or $10 is very adequate.  You'll sleep at
  146.      night knowing that you helped an aspiring young programmer!
  147.  
  148.      Thank you very much!
  149.  
  150.      Don't rip off shareware authors.  Please send a donation if
  151. |    you use this program.  I noticed that this program was
  152. |    downloaded from the IBMSW forum on CompuServe more than 150
  153. |    times in three days.  Obviously, this program is *very*
  154. |    popular.  But, as of today, I have received no
  155. |    contributions for it.  That's quite disappointing.  If I
  156. |    had received controbutions from only 10% of the people, I
  157. |    would be $100 to $150 richer, and I wouldn't be
  158. |    complaining.  Come now, if you use it, contribute!
  159.  
  160.  
  161. Mike "Nifty James" Blaszczak
  162. 112 Verlinden Drive
  163. Monroeville,  PA   15146-2041
  164.  
  165. Participate On The Source:  NIFTY JAMES
  166. Participate On NWI       :  MIKE B  or NIFTY JAMES
  167. The KCA PC-Guru BBS, in Pittsburgh:  MIKE BLAZAK
  168. On The SOURCE:  BCB922
  169. On CompuServe:  76210,1546
  170.  
  171.  
  172.