═══ 1. Help For MemStat ═══ MemStat Version 2.07 is a utility program which displays the current amount of available memory, the size of the swap file and the amount of free space on the swap drive under OS/2 2.x. It has proven to be a useful tool, both in the test environment and in the production environment. For help on any selectable field, select the field and press F1 or select one of the following options: o About this release o MemStat Display o MemStat Menus o MemStat Errors o Registering MemStat ═══ 2. Release Notes for Version 2.07 ═══ Enhancements in this release o None Enhancements in MemStat Version 2.06 o Reorganized the Help (removed the "Help for..." text from most of the panels). Enhancements in MemStat Version 2.05 o MemStat now supports dragging and dropping of colors and fonts onto its client area. o Updated address details of The Software Cottage. Enhancements in MemStat Version 2.04 o MemStat now has a Hide Frame This allows MemStat to take up less room on the screen. The frame display can now be toggled by double-clicking on the MemStat display window with the left mouse button. When the frame is hidden, MemStat can be moved about the screen by dragging the window using the left mouse button. o MemStat can now be configured to display a Short Description of the values it is displaying, rather than the long description. Once again, this takes up less screen space. o MemStat now has a Float to Surface option which causes MemStat to force itself to be the top-most window on the screen. This allows MemStat to be visible at all times if required. Enhancements in MemStat Version 2.03 o MemStat is now a 32-bit application. Admittedly, it calls a 16-bit API (DosMemAvail), but the rest of the application is 32-bit. Enhancements in MemStat Version 2.02 o None Enhancements in MemStat Version 2.01 o MemStat now displays the amount of disk space free on the swap drive. o The MemStat display is now configurable through the Options pulldown menu. o MemStat now has on-line context-sensitive help (you are reading it). Bug fixes in this release o Fixed the problem with not correctly getting the swap drive id when SWAPPATH is set using lower case. Bug fixes in MemStat Version 2.06 o Fixed the problems with color setting using Presentation Parameters. Bug fixes in MemStat Version 2.05 o Fixed the problem of a duplicate line in the help text. Bug fixes in MemStat Version 2.04 o None Bug fixes in MemStat Version 2.03 o None Bug fixes in MemStat Version 2.02 o MemStat now continues to update the memory status after the About... box is displayed. Bug fixes in MemStat Version 2.01 o MemStat now displays the swap file size correctly when it is not on Drive C: o Fixed a problem with the way MemStat saved its position when minimized. ═══ 3. MemStat Display ═══ The MemStat Display window contains up to three lines of information in this release. Depending on how you have set up MemStat, the following information may be displayed: Available Memory This is the value returned from the DosMemAvail function call and represents the size of the largest consecutive block of free memory available when the function was called. Note that this is memory available to 16-bit applications and may not be meaningful for 32-bit applications running under OS/2 2.x. Swap File Size This is the physical size of the swap file, the location of which is taken from the SWAPPATH parameter in CONFIG.SYS. Under OS/2 Version 2.x, the swap file increases in size as your applications use memory and decreases in size as physical memory becomes available so this value will go up and down as you work. Swap Disk Free Space This value is the amount of free space left on the drive containing the swap file. If this value goes too low, it is an indication that you may need to make more space on your swap drive or move your swap file to another drive. ═══ 4. MemStat Menus ═══ The following pulldown menus are available for selection from within MemStat: Options This menu allows the user to change the MemStat configuration, save the position of MemStat on the desktop, and exit from MemStat. It contains the following options: o Settings o Save Position o Exit Help This menu allows the user to request help, and to display the About dialog box. It contains the following options: o Help for help... o Extended help... o Keys help... o Help index... o About... ═══ 5. MemStat Settings Menu Option ═══ This menu option brings up the MemStat Settings dialog box which allows the user to alter the MemStat display. The user can tell MemStat which parameters to display and can change the display update interval to reduce the impact of MemStat on the system. The settings selected by the user are saved in OS2.INI and retrieved by MemStat when it is next loaded. ═══ 6. MemStat Save Position Menu Option ═══ Selecting this option allows the user to save the current position of MemStat on the screen. The next time MemStat is run, it will be displayed in the saved position. This option is automatically selected when you select Shutdown from the Workplace Shell Desktop. ═══ 7. MemStat Exit Menu Option ═══ Selecting this option exits from MemStat. ═══ 8. "Help for Help" Menu Option ═══ Selecting this option displays general help applicable to the Help Manager and its use. ═══ 9. Extended Help Menu Option ═══ Selecting this option displays extended help and information for MemStat. ═══ 10. Help Index Menu Option ═══ Selecting this option displays the Help Index for MemStat, allowing the user to quickly find the desired help page. ═══ 11. Help Keys Menu Option ═══ Selecting this option results in the display of help for the keystrokes available in MemStat. ═══ 12. MemStat About Menu Option ═══ This option is used to bring up the MemStat About dialog box, which displays copyright information about MemStat, including the current version number. ═══ 13. MemStat Settings Dialog Box ═══ To change any of the MemStat settings, click on the check boxes labelled: o Display Available Memory o Display Swap File Size o Display Swap Disk Free Space o Hide Window Frame o Short Descriptions o Float Memstat to Surface To change the Timer Interval, click on the edit field and enter a numeric value. Selecting the OK pushbutton will accept the current settings. Clicking on Cancel will discard any changes and close the dialog box. Clicking on the Help pushbutton will display this help panel. ═══ 14. Display Available Memory Check Box ═══ Checking this box results in MemStat displaying the amount of physical memory available to applications running under OS/2. Any changes made to this field will not be reflected in MemStat until the "OK" push-button is selected. ═══ 15. Display Swap File Size Check Box ═══ Checking this box results in MemStat displaying the current size of the swap file used by OS/2. Any changes made to this field will not be reflected in MemStat until the "OK" push-button is selected. ═══ 16. Display Swap Disk Free Space Check box ═══ Checking this box results in MemStat displaying the current amount of free space on the drive on which the swap file is stored. Any changes made to this field will not be reflected in MemStat until the "OK" push-button is selected. ═══ 17. Hide Window Frame Check box ═══ Checking this box results in MemStat hiding its frame window when displaying the requested information. This allows the MemStat window to take up less room on the desktop. The frame display can be toggled by double-clicking with the left mouse button on the MemStat display window. When the frame window is hidden, the Memstat window may be moved by selecting the window with the left mouse button and dragging the window to the desired location. Any changes made to this field will not be reflected in MemStat until the "OK" push-button is selected. ═══ 18. Short Descriptions Check box ═══ Checking this box results in MemStat displaying shortened descriptions of the information it is displaying. This allows the Memstat display to take up less room on the desktop. Any changes made to this field will not be reflected in MemStat until the "OK" push-button is selected. ═══ 19. Float Memstat to Surface Check box ═══ Checking this box results in the MemStat display floating to the surface when it is not the currently active window. This option is useful when it is desired to monitor memory status while running other applications which may take up the whole desktop. Any changes made to this field will not be reflected in MemStat until the "OK" push-button is selected. ═══ 20. Timer Interval Entry Fiald ═══ This entry field is used to enter the interval (in seconds) at which the MemStat display window updates the Memory Status display. Enter a value between 0 and 65535. A value of 0 will cause the update to occur as quickly as possible, that is, about every 1/18 of a second. ═══ 21. OK Push Button ═══ Selecting the OK pushbutton will result in the contents of the dialog fields being checked and, if there is no invalid data, the data entered will be saved and used by MemStat in displaying the memory status information. ═══ 22. Cancel Push Button ═══ Selecting the Cancel pushbutton will result in the dialog box closing without saving any changes made to its fields. ═══ 23. Help Push Button ═══ Selecting the Help pushbutton will result in help being displayed for this dialog box. ═══ 24. About Dialog Box ═══ The About Dialog Box gives some general information about MemStat, including software copyright notices and the current version number. Select "OK" to close the About Dialog Box. ═══ 25. MemStat Errors ═══ If an error occurs during execution, MemStat will attempt to display a message reporting the error and will then take appropriate action. Currently, MemStat will report the following errors: o Unable to create Timer o Must select at least one parameter to display o Invalid Timer Interval Entered o Unable to Save OS2.INI Profile Entry ═══ 26. System Timer Error ═══ MemStat was unable to start a new system timer. This indicates that the system timer limit has been exceeded. To fix this problem, close some applications that use system timers and try MemStat again. ═══ 27. No Parameters Displayed Error ═══ At least one Memory Status parameter must be selected for display. Check at least one of the check boxes in the Settings dialog box. ═══ 28. Timer Interval Error ═══ The timer interval must be set to a value between 0 and 65535. A value of 0 will cause the update to occur as quickly as possible, that is, about every 1/18 of a second. ═══ 29. Profile Error ═══ MemStat was unable to save its Profile information to OS2.INI because of a system error. Any settings changed in this session will need to be changed again, the next time MemStat is run. To fix this problem, check the validity of OS2.INI using an OS2.INI editor program to confirm that it is readable. If not, restore your latest backup of OS2.INI. ═══ 30. Registering MemStat ═══ The easiest way to register that you are using MemStat is to send an electronic mail note to Greg Jones at any of the addresses below. MemStat is currently being distributed as freeware. By registering, you are guaranteeing that you will find out when new releases are made. Program License Agreement MemStat is currently being distributed as a general interest utility. You are free to copy and use the software for personal use and distribution in its original, unmodified form provided no fee is charged beyond reasonable media and/or shipping charges. Corporate users interested in using MemStat are invited to contact The Software Cottage regarding licensing. For further information, contact: Greg Jones, The Software Cottage Pty Ltd 484 Waverley Road, Mount Waverley, Vic, 3149 AUSTRALIA. Ph: 61-3-802-7883 Fidonet: 3:634/384.2 CompuServe: 100033,3121 ═══ 31. Keys ═══ The following keys are available for use within MemStat: o General Keys F1 Get help Alt+F4 or F3 Close MemStat Alt+F5 Restore MemStat (when minimized) Alt+F7 Move the MemStat window Alt+F9 Minimize the MemStat window o Dialog Box Keys Enter Accept details and close dialog box Esc Cancel the dialog box Spacebar Set a check box on/off or perform the task described on the selected pushbutton Tab Move to the next entry field or check box o Editing Keys Backspace (left arrow delete) Delete the character to the left of the cursor Del Delete the character at the cursor End or Ctrl+Right Arrow key Move to the end of a field Home or Ctrl+Left Arrow key Move to the beginning of a field.