home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / MEM202.ZIP / MEMSTAT.DOC next >
Text File  |  1992-05-09  |  11KB  |  319 lines
  1. MEMSTAT - OS/2 Presentation Manager Memory Status Utility, Version 2.02 
  2. Copyright (C) 1991, 1992 The Software Cottage. All rights reserved. 
  3.  
  4. For further information, contact: 
  5.     Greg Jones, 
  6.     The Software Cottage 
  7.     71 Bruce Street, 
  8.     Mount Waverley, Vic, 3149 
  9.     AUSTRALIA. 
  10.  
  11.     Ph: 61-3-807-4939 
  12.     Fidonet: 3:634/384.2 
  13.     CompuServe: 100033,3121
  14.  
  15.  
  16. What is MemStat?
  17. ----------------
  18.  
  19. MemStat Version 2.02 is a utility program which displays the current
  20. amount of available memory, the size of the swap file and the amount
  21. of free space on the swap drive under OS/2 1.x and 2.x.
  22.  
  23. It has proven to be a useful tool, both in the test environment and
  24. in the production environment.
  25.  
  26.  
  27. Installation 
  28. ------------
  29.  
  30. To install MEMSTAT, place MEMSTAT.EXE in a directory in your path,
  31. MEMSTAT.HLP in a directory pointed to by your HELP environment
  32. variable, and use STARTUP.CMD to start it or make it an auto-start
  33. application in one of your groups (or in the "Startup" folder under
  34. OS/2 Version 2.0). 
  35.  
  36.  
  37. Operation 
  38. ---------
  39.  
  40. MEMSTAT commences operation once it is started and displays the memory
  41. and swap file status, updated at one second intervals. 
  42.  
  43. If MEMSTAT receives a WM_SAVEAPPLICATION message, e.g. after
  44. selecting "Desktop->Save" under OS/2 1.3, it saves its current
  45. position to OS2.INI.  The next time it is started MEMSTAT will move
  46. its display window to that position. This allows you to place MEMSTAT
  47. in a position suited to your working environment. 
  48.  
  49.  
  50. Release Notes for Version 2.02
  51. ------------------------------
  52.  
  53. This is purely a bug-fix release to fix the problem of MemStat not
  54. updating the memory status after the About... box is displayed.
  55.  
  56. Release Notes for Version 2.01
  57. ------------------------------
  58.  
  59.    Enhancements in this release
  60.    -   MemStat now displays the amount of disk space free on the swap drive.
  61.    -   The MemStat display is now configurable through the Options pulldown
  62.        menu.
  63.    -   MemStat now has on-line context-sensitive help.
  64.  
  65.    Bug fixes in this release
  66.    -  MemStat now displays the swap file size correctly when it is not on
  67.       Drive C:
  68.    -  Fixed a problem with the way MemStat saved its position when
  69.       minimized.
  70.  
  71.    Cautions
  72.    -  MemStat needs to read CONFIG.SYS from the Boot Drive, so be careful
  73.       if you boot PM from a floppy disk and then run MemStat (It can be
  74.       done under 1.x!).
  75.  
  76.  
  77. The MemStat Display
  78. -------------------
  79. The MemStat Display window contains up to three lines of information
  80. in this release. Depending on how you have set up MemStat, the
  81. following information may be displayed:
  82.  
  83.    Available Memory
  84.  
  85.    This is the value returned from the DosMemAvail function call and
  86.    represents the size of the largest consecutive block of free memory
  87.    available when the function was called. Note that this is memory
  88.    available to 16-bit applications and may not be meaningful for 32-bit
  89.    applications running under OS/2 2.x.
  90.  
  91.    Swap File Size
  92.  
  93.    This is the physical size of the swap file, the location of which is
  94.    taken from the SWAPPATH parameter in CONFIG.SYS. Under OS/2 Version 1.x,
  95.    this parameter will start at 512K and gradually increase depending on the
  96.    memory requirements of the applications you run. Under OS/2 Version 2.x,
  97.    the swap file actually decreases in size as physical memory becomes
  98.    available so this value may go up and down as you work.
  99.  
  100.    Swap Disk Free Space
  101.  
  102.    This value is the amount of free space left on the drive containing
  103.    the swap file. If this value goes too low, it is an indication that
  104.    you may need to make more space on your swap drive or move your swap
  105.    file to another drive.
  106.  
  107.  
  108. MemStat Menus
  109. -------------
  110.  
  111. The following pulldown menus are available for selection from within
  112. MemStat:
  113.  
  114.    Options
  115.    This menu allows the user to change the MemStat configuration, save
  116.    the position of MemStat on the desktop, and exit from MemStat. It contains
  117.    the following options:
  118.  
  119.       Settings
  120.       This menu option brings up the MemStat Settings dialog box which
  121.       allows the user to alter the MemStat display. The user can tell
  122.       MemStat which parameters to display and can change the display
  123.       update interval to reduce the impact of MemStat on the system.
  124.       The settings selected by the user are saved in OS2.INI and retrieved
  125.       by MemStat when it is next loaded.
  126.  
  127.       Save Position
  128.       Selecting this option allows the user to save the current position of
  129.       MemStat on the screen. The next time MemStat is run, it will be
  130.       displayed in the saved position. This option is automatically selected
  131.       if you check the Save check-box on the Desktop Manager's Shutdown
  132.       Dialog Box (OS/2 Version 1.x) or when you select Shutdown from the
  133.       Workplace Shell Desktop (Os/2 Version 2.x).
  134.  
  135.       Exit
  136.       Selecting this option exits from MemStat.
  137.  
  138.    Help
  139.    This menu allows the user to request help, and to display the About
  140.    dialog box. It contains the following options:
  141.  
  142.       Help for help...
  143.       Selecting this option displays general help applicable to the Help
  144.       Manager and its use.
  145.  
  146.       Extended help...
  147.       Selecting this option displays extended help and information for
  148.       MemStat.
  149.  
  150.       Keys help...
  151.       Selecting this option results in the display of help for the keystrokes
  152.       available in MemStat.
  153.  
  154.       Help index...
  155.       Selecting this option displays the Help Index for MemStat, allowing
  156.       the user to quickly find the desired help page.
  157.  
  158.       About...
  159.       This option is used to bring up the MemStat About dialog box, which
  160.       displays copyright information about MemStat, including the current
  161.       version number.
  162.  
  163.  
  164.  
  165. MemStat Settings Dialog Box
  166. ---------------------------
  167.  
  168. To change any of the MemStat settings, click on the check boxes labelled:
  169.  
  170.    Display Available Memory
  171.    Checking this box results in MemStat displaying the amount of physical
  172.    memory available to applications running under OS/2.
  173.  
  174.    Display Swap File Size
  175.    Checking this box results in MemStat displaying the current size of the
  176.    swap file used by OS/2.
  177.  
  178.    Display Swap Disk Free Space
  179.    Checking this box results in MemStat displaying the current amount of 
  180.    free space on the drive on which the swap file is stored.
  181.  
  182.    Timer Interval
  183.    To change the Timer Interval, click on the edit field and enter a
  184.    numeric value between 0 and 65535. A value of 0 will cause the update
  185.    to occur as quickly as possible, that is, about every 1/18 of a second.
  186.  
  187. Any changes made to the above fields will not be reflected in MemStat until
  188. the "OK" push-button is selected.
  189.  
  190.    OK pushbutton
  191.    Selecting the OK pushbutton will result in the contents of the dialog
  192.    fields being checked and, if there is no invalid data, the data entered
  193.    will be saved and used by MemStat in displaying the memory status
  194.    information.
  195.  
  196.    Cancel Push Button
  197.    Selecting the Cancel pushbutton will result in the dialog box closing
  198.    without saving any changes made to its fields.
  199.  
  200.    Help Push Button
  201.    Selecting the Help pushbutton will result in help being displayed for
  202.    this dialog box.
  203.  
  204.  
  205.  
  206. About Dialog Box
  207. ----------------
  208.  
  209. The About Dialog Box gives some general information about MemStat, 
  210. including software copyright notices and the current version number.
  211.  
  212. Select "OK" to close the About Dialog Box.
  213.  
  214.  
  215. Keys
  216. ----
  217.  
  218. The following keys are available for use within MemStat:
  219.  
  220.    General Keys
  221.  
  222.    F1
  223.       Get help
  224.  
  225.    Alt+F4 or F3
  226.       Close MemStat
  227.  
  228.    Alt+F5
  229.       Restore MemStat (when minimized)
  230.  
  231.    Alt+F7 
  232.       Move the MemStat window 
  233.  
  234.    Alt+F9
  235.       Minimize the MemStat window 
  236.  
  237.    Dialog Box Keys
  238.  
  239.    Enter 
  240.       Accept details and close dialog box
  241.  
  242.    Esc 
  243.       Cancel the dialog box
  244.  
  245.    Spacebar 
  246.       Set a check box on/off or perform the task described on the selected 
  247.       pushbutton 
  248.  
  249.    Tab 
  250.       Move to the next entry field or check box 
  251.  
  252.    Editing Keys
  253.  
  254.    Backspace (left arrow delete) 
  255.       Delete the character to the left of the cursor 
  256.  
  257.    Del
  258.       Delete the character at the cursor
  259.  
  260.    End or Ctrl+Right Arrow key 
  261.       Move to the end of a field 
  262.  
  263.    Home or Ctrl+Left Arrow key 
  264.       Move to the beginning of a field. 
  265.  
  266.  
  267. MemStat Error Messages
  268. ----------------------
  269.  
  270. If an error occurs during execution, MemStat will attempt to display
  271. a message reporting the error and will then take appropriate action.
  272.  
  273. Currently, MemStat will report the following errors:
  274.  
  275.    "Unable to create Timer"
  276.    MemStat was unable to start a new system timer. This indicates that
  277.    the system timer limit has been exceeded. To fix this problem, close
  278.    some applications that use system timers and try MemStat again.
  279.  
  280.    "Must select at least one parameter to display"
  281.    At least one Memory Status parameter must be selected for display. Check
  282.    at least one of the check boxes in the Settings dialog box.
  283.  
  284.    "Invalid Timer Interval Entered"
  285.    The timer interval must be set to a value between 0 and 65535. A value
  286.    of 0 will cause the update to occur as quickly as possible, that is, about
  287.    every 1/18 of a second.
  288.  
  289.    "Unable to Save OS2.INI Profile Entry"
  290.    MemStat was unable to save its Profile information to OS2.INI because
  291.    of a system error. Any settings changed in this session will need to be
  292.    changed again, the next time MemStat is run. To fix this problem, check
  293.    the validity of OS2.INI using an OS2.INI editor program to confirm that
  294.    it is readable. If not, restore your latest backup of OS2.INI.
  295.  
  296.  
  297. Registering MemStat
  298. -------------------
  299.  
  300. The easiest way to register that you are using MemStat is to send an
  301. electronic mail note to Greg Jones at any of the addresses below. MemStat
  302. is currently being distributed as freeware. By registering, you are
  303. guaranteeing that you will find out when new releases are made.
  304.  
  305.  
  306. Program License Agreement 
  307. -------------------------
  308.  
  309. MemStat is currently being distributed as a general interest utility.
  310. You are free to copy and use the software for personal use and distribution
  311. in its original, unmodified form provided no fee is charged beyond reasonable
  312. media and/or shipping charges. 
  313.  
  314. Corporate users interested in using MemStat are invited to contact
  315. The Software Cottage regarding licensing.
  316.  
  317.  
  318.  
  319.