═══ 1. What is pmSysMon ? ═══ SystemMonitor v3.0 The ultimate monitoring Tool for OS/2 pmSysMon is a 32-bit multithreaded PM statusbar that displays (almost) everything you've ever wanted . You can freely configure which information you want to be displayed and which items should be disabled. ═══ 2. pmSysMon Registation ═══ pmSysMon Registation The registration fee is only 10 US$ or 100 ATS or 15 DM. Where can you get the satisfacton of being honest at a lower price? But first:  Benefits of Registering  How to Register ═══ 2.1. Benefits of Registering ═══ If you register pmSysMon  you'll keep the shareware-idea alive :-)  you'll see no annoying registration-dialog at startup and end  you are allowed to choose any wave you like  you'll be informed when there are updates which will work with your existing registration mumber -> Updates are FREE ;-( And How to Register?? ═══ 2.2. How to Register ═══ You are licensed to use SystemMonitor for a period of 30 days, after this trial period you are asked :-) to register. There are several Benefits of Registering To do this, just fill in the text provided in the file ORDER.FRM and send it to the address below. The registration fee is 10 US$ or 100 ATS or 15 DM. You can send the money in cash (which is cheaper for you) or you use a postal order (that is,send the money via post office,not via bank ). Sorry, we are not able to accept either checks or other currencies. If you choose a postal order, please send the money in Austrian Shillings; if you send cash DO NOT send coins. We cannot accept any other form of payment (e.g. credit cards,checks). (The bank takes nearly 80% of a $10 check as commission, which we cannot afford). We are really honest, so you don't have to worry when sending the money in cash ! Of course all of the given information will be treated confidentially. Take care, when filling in order.frm, that your first and last names are legible and correct, because we will base your registration code calculated on this information. After you enter this number, your version of SystemMonitor is registered. It will be much easier if you also send us your Internet E-mail address, so we can send you update announcements and the registration number more quickly and easily. To register fill in the order form, and send it and the payment to: Irmgard Wasinger Turmburgg. 2/33 1060 Vienna AUSTRIA E-mail: e8925005@stud1.tuwien.ac.at Registration is for personal use only!!! Running this Program on more than one machine requires special registration - contact the authors for special prices. Students can request a special academic price. ═══ 3. Features ═══ Features The features which are displayed in the bar can be turned on and off by either clicking the right mouse-button or by double-clicking the left one on the bar. You will then see a pop-up menu that allows you to check all the items you want displayed in the bar, and to uncheck those you choose not to use. Another, easier to use, way is to do all of the configuration in the Notebook's Display Page. Using the pop-up menu or the Notebook, you can also select which buttons are to appear in the bar - for more detailed information, see Special Features. Click here for detailed information on the Features pmSysMon can display! To configure the look and performance of pmSysMon, see Configuration. ═══ 4. Special Features ═══ There are several buttons in the action bar which either display extra information or perform some action, e.g. program launch or system shutdown. If you don't want the buttons to be displayed, you can get the same effect by selecting 'Utils' in the pop-up menu. This will bring up a submenu, in which you can select the same features. If pmSysMon has the focus,you can also use shortcuts instead of pressing the buttons. e.g. Alt-t will bring up the tasklist, Alt-r will launch the Run dialog, ..  Battery  Lock  Run  Task  Disk  Shut ═══ 4.1. Battery ═══ This feature is available only in a laptop machine which supports the power-saving feature.  APM enabled Displays if your computer is battery powered; if you are using a laptop, it should always say 'Yes'.  APM online  Battery Status Displays the status of your battery: High, Low, Critical or Charging.  Battery Life Displays state of charge of your battery - 100% means fully charged, 0% means empty. ═══ 4.2. Lock ═══ Enables you to lock your system. This is a fast and easy way to password-protect your system if you want to leave your computer for some minutes. ═══ 4.3. Run ═══ Opens a file-selection dialog, so you can choose an executable file (*.exe, *.com, *.cmd, *.bat) to run. ═══ 4.4. Task ═══ Opens a Task List, which displays all running tasks. On the Configuration page in the Configuration Notebook you can also specify that the pmSysMon tasklist is to replace the system Window List, and is to appear when both mouse buttons are pressed. pmSysMon's tasklist is freely sizable and its size and position are stored, so it always pops up in the same place.  By pressing the right mouse button on an entry you a menu will appear allowing you to - Switch To - Quit (or press Delete) - Kill - Minimize - get INFO about any task you like. Quit assures that unsaved data is not lost; Kill terminates the application without saving.  There are additional security features which warn you if you try to close e.g. a invisible application, or some task which the system might need.  You can have the Task List open on your desktop until you close it or switch to another program. (unlike the system Window List, which disappears when it loses the focus, or when you terminate a running application)  The Task List notices if any application was started or terminated, and generally refreshes itself.  Multiple Task Selection is possible for all actions except getting information about a selected task.  Sorting and Filtering By pressing the right mousse button on empty space or the container title a menu will appear allowing you to - Sort the contents of the Task List by either name or PID. - Filter only Visible or Jumpable entries. - Refresh the Task List manually.  Information about a task is only displayed if you select 'Info'. If you select 'Info', a dialog will appear which shows you the - Pid - Session - ProgType (e.g. PM,WindowableVIO,VDM,..) - Visibility of the selected task. ═══ 4.5. Disk ═══ Choosing this option causes a dialog to open, showing you the following:  FileSystem: Indicates if this Drive is a HPFS, CDFS or FAT formatted drive.  Location: Indicates if this Drive is a local or remote drive.  Removable: Indicates if this Drive is removable (CD or Floppy Disk) or not.  Description: Indicates the type of this Drive (e.g. Floppy, Fixed Disk, Tape Drive, ...).  VolumeLable: Shows the label of this drive.  Total Space: Shows the size of the drive.  Free Space: Shows the ammount of free space on this drive  Used Space: Shows the ammount of used space on this drive The button with the Folder Icon enables you to Open the drive which is currently selected. ═══ 4.6. Shut ═══ pmSysMon offers you three ways to shut down your system:  Shutdown Performs a normal shutdown, after which you can either reset your computer or switch it off.  Reboot (this) OS/2 After shutdown, OS/2 is automatically rebooted (this means that the Boot Manager is skipped if you have one installed).  Choose BootDrive Reboots from the drive you specify in the adjacent field (also overrides the Boot Manager). (Note - If you choose a drive with no bootable system, the system will boot from drive C). ═══ 5. Configuration ═══ Configuration In addition to selecting which Features you want to be displayed in the bar, you can also configure many other details of the look and the performance of pmSysMon to suit yourself. By using Drag and Drop you can adapt the Color and Font to your liking. All other configuring is done in a notebook which appears when you select 'Configuration...' in the pop-up menu.  Configuration  Appearance  Sound  Refresh  Display  Alarm If you do not want to apply the changes you made just press the 'Cancel' button. Otherwise press 'Ok'. On the bottom of every notebook page there is a 'Help' button which provides an expaination about that page. ═══ 5.1. Configuration ═══ On this page the basic configuration of pmSysMon can be done:  Always on Top If this item is checked, pmSysMon will come to the front, and never be hidden by any other window (so you can always see the status bar).  Replace System Window List If this item is checked, pmSysMon's Task List will pop up when you press both left and right mouse-button, instead of the system Window List. (You can still see the system Window List by pressing Ctrl+Esc) pmSysMon's Task List has a lot of features  NumLock turned on at program start As OS/2 turns NumLock off every time after boot, it might be useful to have pmSysMon turning it on when started. If the NumLock state is already 'On', it remains in that state. If you are using a laptop, this feature is always turned off as turning Numlock on remaps the alpha-numeric keys on almost every laptop, which can make texts unreadable.  This machine is battery powered Check this feature is you are using a laptop ! If this item is checked, you are able to monitor the status of your battery.  Show Seconds If this item is checked and 'Time' is selected from the Popup-Menu, the time is displayed with seconds. If you're working on a slow computer, keep this option turned off as the time display will (of course) be updated every second.  Free Diskspace in percent If this item is checked, the free space of the monitored drives and the disk usage in the Disk dialog is shown in percent rather than in the absolute byte value.  Compact UpTime Checking this item causes the uptime to be displayed in a more compact way to save some space in the bar. If less than a day has passed, only hours and minutes are displayed, and if your computer was running for more than a day, only days and hours are shown. ═══ 5.2. Appearance ═══ Configure the appearance of pmSysMon:  CPU Graphical If this item is checked, the CPU activity will be displayed graphically rather than as plain text. This is much more attractive, but consumes more space in the bar and a little more of the CPU's time.  CPU Pulse-like If you select this item and 'CPU graphical' is checked, the CPU activity will be displayed as a time function (like IBM's Pulse), rather than as a triangle. This has the advantage that you can see how the activity changes over a period of time, while the triangle displays only the current CPU usage.  Pulse filled Same as 'CPU Pulse-like', but the interior of the pulse is filled. Note that if you are working on a slow machine, it will probable enhance your system performance if you do not use the filled pulse-type CPU display, because this mode keeps the CPU busier than do the triangle or plain text modes.  Shrink to minimum width If this item is checked, the status bar doesn't occupy the whole width of your screen but uses only as much space as required to display the items you chose.  Long Descriptions in bar If this item is checked, the descriptions of the features displayed in the status bar will be whole words instead of abbreviations, e.g. 'Swap', 'UpTime', 'Virtual Mem' instead of 'Swp', 'Up', 'VMem' or  Border Width Move the slider to adjust the width of the bar's border to your liking. This gives you the possibility to configure pmSysMon's 3 dimensional look.  Color and Font ═══ 5.2.1. Color And Font ═══ Color and Font You can change the  Background Color of the Bar by dropping a color onto the bar.  Foreground Color of the Bar (the color of the font) by pressing Ctrl and dropping a color onto the bar.  Pulse Color by pressing Ctrl and dropping a color onto the Cpu Graph.  Triangle Color by pressing Ctrl and dropping a color onto the Cpu Graph. This wil bring up a dialog where you can specify if you want to change the color for critical or low Cpu load.  Font by dropping a font onto the bar. Note that by changing the font size, you also change the height of the bar and the room an item needs to be displayed. ( So the larger the font,the less information can be monitored ) You should try different combinations of font, size and style to find out what is best for your needs. e.g. if you want as many items as possible to be monitored, it will be best to choose a small size and a narrow font. ═══ 5.3. Sound ═══ Configure which sound file you want played, and how often this is to be done: This page is only available if you have MMOS2 installed on your system and if you're not using the -quiet command line option, so you don't see a notebook page with everything disabled. You can choose any .WAV file you like (in the registered version) by pressing the 'Select Wave ..' button. This sound will then be played at intervalls you select (e.g. every hour,quarter-hourly, etc.) - just click on the button with the time interval you prefer. If you don't want any sounds, select 'None'. (We found it useful to have a reminder sound to keep us in mind of the passage of time.) ═══ 5.4. Refresh ═══ Configure the refresh rates of the features: By moving the corresponding slider, you choose how often the various displays are to be updated. Note that your system will be less busy if the values of the update frequencies are higher, but you may not notice changes and the values (especially for CPU) will be less accurate. These values are effective only if the corresponding items are displayed in the status bar (e.g. if you don't need the information about Swap, it will not be sampled by the program).  CPU This value determines how often the CPU Activity is updated ( if you chose graphical display: how often the graph is redrawn ). This also effects the Average CPU Activity.  Mem This value determines how often the value of the Virtual Memory and the Physical Memory are updated. The number of active Tasks is updated with the same refresh rate.  Swap This value determines how often the size of the Swap file and Swap Free is updated .  Drives This value determines how often the free space of the monitored Drives is updated . ( It usually makes sense to have a larger value for this feature, because the free space on your drives won't often change rapidly ). The Battery Status is updated with the same refresh rate. The default values used by pmSysMon are the ones we considered a good trade-off between accuracy and time-consumption. ═══ 5.5. Display ═══ Check all the features and buttons you want to be displayed in the bar (and uncheck those you are not interested in). If you check an item, but there is too little room in the bar for displaying it, you'll be informed by a dialog. This dialog can be disabled by checking off the checkbox saying "Don't show this message next time" once. These are all the features that can be displayed in the bar :  Date,Time Displays actual date and time (with seconds or without ). Date and Time are separately configurable. - this means you can also choose to display Time only, Date only, or both. Time and date are displayed in the format for which OS/2 is currently configured - this means that if you have configured the date format as YYMMDD, and with '/' as separator, this is how the date will be displayed. So what you see might look like or or maybe like .  UpTime Displays the time that passed since your last reboot.  CPU activity Displays the percentage of CPU usage to show how busy your processor is ( 0% means CPU is idle ). There are four possible views. The CPU activity can be displayed as: 1. Plain Text 2. Graphically as a triangle filled with current usage. 3. Graphically as empty pulse This allows you to monitor the evolution of CPU activity with time. 4. Graphically as filled pulse If you're working on a slow system, you should notice that monitoring CPU activity consumes some extra processor time - if you choose text-only display, less CPU time is consumed by pmSysMon. If you turn the CPU monitoring feature off, CPU activity isn't measured at all, and the system will run a little faster.  Average Cpu Activity Displays the average CPU usage since pmSysMon started. This value is most accurate if you put pmSysMon in the Startup-Folder, because then average CPU usage is calculated using all information since boot.  Number of Tasks Displays the number of tasks which are currently active.  Virtual Memory Displays the amount of free Virtual Memory. Note that Virtual Memory includes RAM and swapped memory .  Physical Memory Displays the amount of free Physical Memory.  Swap Displays the size of your swap file.  Swap Free Tells you how much your swap file can be enlarged.  Drives Displays the available space of as many drives as you are interested in. You can either highlight all the drives you want to be monitored in the Drives Listbox of the notebook, or you can use the popup-menu. After selecting the 'Drives' item from the pop-up menu, a submenu will appear which lists all the drives installed on your system. Click on the letter of the drive you wish to monitor (e.g D:) and the desired information will appear in the bar. See Special Features for detailed information about the functionallity of the buttons. ═══ 5.6. Alarm ═══ If you like to be warned when the free space on your harddisk gets below a certain minmum, check this item. In the listbox you can select which drives should be checked for low space, and the limit for these drives can be set either in MB's or in percentage of the disk's size. In the case the space on any of the selected drives gets below the limit, an alarm sound will occur and a dialog will appear. There you see which drive caused the warning and by pressing the 'Search Deletable Files' button you have the possibility of Searching For Files you probably don't need anymore (like *.tmp or *.bak) and deleting the unnecessary ones after pressing the 'Delete ..' button. ═══ 6. Search For (Deletable) Files ═══ Search For (Deletable) Files This Dialog helps you clean up your hard disk - additionally it can be used to search for files using Regular Expression !  Use the Delete button to delete all the selected files.  Use the View button to start E.EXE with all the selected files.  Use the Open Icon button to open the directories the selected files reside in.  Use the Search button to start a new search. Cleaning up the hard disk Select file specs you consider unneeded by pressing the adequate checkbox. Selecting Contents of TempDir will add all files found in the directories specified in your CONFIG.SYS as a temporary directory (SET TEMP=...). TEMP,TMP,TEMPDIR and TMPDIR are taken into account. Selecting Contents of DelDir will add all files found in the directories specified in your CONFIG.SYS as an 'undelete' directory (SET DELDIR=...). Last but not least you can supply a Regular Expression search pattern which will be compared with all files on your hard disk. Then start the search by pressing Search - after the ListBox is filled select all unneccessary files and press Delete. Just Searching For Files The Regular Expression entryfield supplies you with a powerful tool to look for files. Turn off all other checkboxes (*.TMP,...) and use a search pattern which will be compared with all files on the drive. e.g.: FILE.*\.CHK$ will match all File????.CHK If you need case sensitive searching don't forget to turn on that checkbox. ═══ 7. CommandLine Options ═══ CommandLine Options To use a commandline option, type pmSysMon -Option or pmSysMon /Option or add -Option in the parameter field of the programm's configuration page (available by pressing the right mouse-button on the pmSysMon icon on your desktop). Possible CommandLine Options are:  QUIET If you have MMOS2 installed on your system but don't want the music.dll to be loaded because you don't use the Sound features, use this option.  MMOS2 If you have MMOS2 installed on your system but pmSysMon doesn't detect it, you can force use of the Sound by adding this option. (If this problem occurs, please inform the authors!) ═══ 8. About the Authors ═══ About the Authors We're two students, studying Physics at the Technical University of Vienna; our names and addresses as follows:  Irmgard Wasinger Turmburgg. 2/33 1060 Vienna AUSTRIA E-mail: e8925005@stud1.tuwien.ac.at  Ramin Nourbakhch Siebertg. 34/14 1120 Vienna AUSTRIA E-mail: e8925004@stud1.tuwien.ac.at Please feel free to contact us, either by post or E-mail, with any suggestions, remarks, or bug reports. We depend on this sort of feedback from our users to help us define the direction of our development.