Welcome to CPUMeter, Version 1.0b

This program is SHAREWARE, you are allowed to distribute the zipfile cpum*.zip.
Do NOT redistribute any part of this zipfile. After a trial period of 4 weeks, 
you have to register if you want to use the program any further. Otherwise, you 
must remove it from your computer.

----------------------------------------------------------------------------
CONTENTS:
 1. Program description
 2. Legal stuff
 3. Installation
 4. History
 5. Future plans
 6. Known Bugs
----------------------------------------------------------------------------

----------------------
1. Program description
----------------------
CPUMeter is an enhanced CPU-usage meter, similar to "PULSE.EXE". 
Unlike other CPUmeters, it does not use a counting loop to determine the
CPU load. It uses the DosQProcStat API call. This reduces CPU load and CPU
powerconsumption and gives the possibility to show infos about CPU-hogging
processes. For details look in the helpfile.

This program is SHAREWARE. That means you are allowed to copy and distribute
the original archive (cpum*.zip) and you are allowed to test the program for
four weeks. 
After that time, you MUST register it or remove the program from your PC(s).
To register, send me
A: - either DM 20,- cash or as negotiable "EUROCHECK"
   - or     US$20,- cash or as negotiable "EUROCHECK"
B: - either your postal-adress
   - or your email-adress, so I will know where to send your registration-key.
     
My adress is:
  Christof Pastors
  Luitpoldstr. 12
  91054 Erlangen
  Germany

I am also open to comments and discussion about my program, any constructive 
comment will be appreciated. If you want to contact me via email:
     pastors@eev.e-technik.uni-erlangen.de

The newest version of CPUMeter can be found on the regular ShareWare-servers 
(like Hobbes) or (the very newest) at:
     http://eev11.e-technik.uni-erlangen.de/cpumeter.html



--------------
2. Legal Stuff
--------------
 CPUMeter is Copyright (c) 1996, Christof Pastors

This program is provided "as is" to give you a chance to try the product for
four weeks.
After that time, you MUST register it or remove the program from your PC(s). I
will give NO kind of SUPPORT to unregistered users (though I am open for
comments and constructive criticism). I tried to find as many bugs as possible,
but I am IN NO WAY RELIABLE FOR INDIRECT OR  SIMILAR  DAMAGES, INCLUDING  ANY
LOST PROFITS OR LOST DATA ARISING OUT OF  THE  USE OR  INABILITY TO USE THE
SOFTWARE OR ANY DATA SUPPLIED .


----------------
3. Installation
----------------
Simply unzip the zipped files in a single directory. Then create a new 
program-object by starting cpu_inst.cmd or by dragging and customizing 
an object from a program template in your templates-folder.  READY.

CPUMeter does not register a DLL nor does it create an entry in the 
ini-files of OS/2, I don't like programs modifying system-files!

NEW! Accurate results with High-Resolution-Timer!

To exploit all capabilities of CPUMeter, you can use the new "High-Resolution
-Timer". For this, you need two new drivers from IBM: CLOCK01.SYS and 
TIMER0.SYS. If you have one of those rare microchannel-PCs, you need the 
CLOCK02.SYS driver instead of clock01. With those drivers, the problem is 
fixed that CPUMeter shows to much CPU-load when an application is waked 
very often (for example to handle mouse-movement messages).

Enabling this option can cause problems

  - DOS-programs that use the same Harware-timer will hang. This is propably 
    the case with many DOS-Games.
  - WINDOWS-sessions may hang when starting or show bad response to mouse-input.
  - Seamless WINOS2-sessions may even block the OS/2 desktop when they hang on 
    startup.
If you have problems with a DOS-program that needs the same hardware-timer,
go to the settings-Notebook of CPUMeter and disable the use of HRTimer. In rare
cases, you should also exit CPUMeter after this step to free the Hardware-timer.
 

How YOU can get these drivers:

- They will be part of MERLIN, the next version of OS2,
- I added the MMPM_MPU.ZIP archive that comes from IBM to the CPUMeter  
  archive. You can find the needed drivers in there.
- They are part of the DEVCON-9 "Developer's Toolkit for OS/2 Warp" ( see
  BETA-section there)
- They are part of the new Real-Time-Midi package developed by IBM.
- And they can be found per ftp at the HOBBES-Shareware archive (MMPM_MPU.ZIP).

How to install the new drivers:

If you don't use ( or need ) the according Multimedia-Setup "MINSTALL.EXE",
which brings you full MPU-401 multimedia support, install them "by hand":

- Make a backup copy of the old clock01.sys in the \os2\boot\ directory.
- Copy the new clock01.sys and timer0.sys in this directory.
- Add the statement "BASEDEV=TIMER0.SYS" to your config.sys.
- Reboot.

If CPUMeter can't open the new timer on program-startup, it will use the
(inaccurate) standard-timer.

----------------
4. History
----------------
Ver 0.9a:  Finally, this is version 0.9a which has all basic features I wanted
           to add.
           Its the first version given to beta-testers, now I wait for
           feedback....

Ver 0.9b:  Now I got the first feedback (see also future plans):
           - Fixed graphic-bug. With line-style "not-filled", the background
             was not repainted at all. As one result, the lines got "smeared".
           - Made About-dialog and Helpfile infos consistent.

Ver 0.9c:  - Fixed two bad pointers who crashed CPUMeter when closing the app.
           - The window can be moved with the mouse.
           - Added bargraphs for CPU-load, Disk-usage and swapfile-size.
           - Message-boxes could crash CPUMeter, fixed now.
           - The Real-Time-Midi timer can be used by CPUMeter if found,
             --> BIG IMPROVEMENT in accuracy.
           - Better window (re-) placement when window-corner exceeds
             desktop-size.
           - Reduced memory- and CPU-usage.

Ver 0.9d:  - Finally made a Settings Notebook
           - Now a user defined drive can be monitored
           - Improved scaling of the Linegraph
           - CPUMeter closes more smoothly
           - The new HighResolutioinTimer is used if present

Ver 0.9e:  - Added the long wanted Process-List
           - Added a "Kill process" feature
           - All Dialogs are non-modal now. I hate modal dialog-windows.

Ver 1.0a:  - This version will be released
           - Updated readme and helpfile
           - Added popup-menu in process-list
           - Added hotkeys for process-list and settings-notebook

Ver 1.0b:  - Romney White was so kind to look through the helpfile, thanks alot!
           - I rewrote the process list completely, its consists now of
             OpenClassLibrary objects, it can be resized and font/color
             is saved in the cpumeter.ini file
           - Added the Goto button to the process list
           - the process list is refreshed when a killed process has gone
           - True Color support in the pocess list window
           - The settings are now also saved at system-shutdown


----------------
5. Future plans
----------------
Some ideas that MAY BE realized in the future ( I am open for discussions
about missing features):

- I want to rewrite the main window.

- Support for more than 16 colors also for the main window
  ( In the moment, only 16 colors are supported)

- Enhanced layout for the process-list. Maybe infos about all threads and
  all windows of a process can be shown.

- Memory and speed-tuning (Not very easy when using the IBM OCL)



----------------
6. Known bugs
----------------
- The HighResolution timer interferes with some DOS/Windows programs!

- Personal Communications PC3270 fails to start when CPUMeter is up?

- The horizontal scrollbar of the process list does not work