SystemMeter v1.31 Nov 2001 -------------------------- for Windows 95/98/Me/NT/2000 written by Marko Bozikovic (marko.bozikovic@envox.com) Requirements ------------ Win98 or WinNT 4.0 SP4 or later IE 4.0 (or later) installed. Installation ------------ Unzip SystemMeter.zip file into your PowerPro directory. File list --------- SystemMeter.dll SystemMeter_readme.txt skins\SystemMeter\Simple Gray\skin.bmp skins\SystemMeter\Simple Gray\skin.xml Unistall -------- Remove SystemMeter.dll and SystemMeter_readme.txt from your PowerPro folder. Delete SystemMeter folder from PowerPro skins folder. Overview -------- SystemMeter is a plugin for a great program called PowerPro, written by Bruce Switzer (http://www.inforamp.net/~crs2086/index.htm) It is used to monitor various system resources (uptime, CPU usage, modem activity, etc.) The plugin was inspired by SysMeter written by thirty4 interactive (http://www.thirty4.com) Currently supported system resources: 1. Date/Time 2. Uptime 3. CPU usage 4. Physical memory usage 5. Swap file usage 6. Disk space 7. Modem traffic 8. Data transferred using modem 9. Network traffic 10. Data transferred across LAN Configuration ------------- All you need to run SystemMeter is a bitmap file for window skin and an XML config file that will specify what monitors to run and how to display them. You can see a sample skin in skins\SystemMeter\Simple Gray folder in your PowerPro folder. Configuration file layout is simple: ... ... Skin attributes --------------- name - skin name author - author name version - skin version url - skin link/author email Window attributes ----------------- background - specifies skin bitmap dock - (optional, default = bottomright)topleft, topright, bottomleft or bottomright left - X window position (not needed if dock attribute is specified) top - Y window position (not needed if dock attribute is specified) update - (optional, default = 1000) update time in milliseconds ontop - (optional, default = 1) set to 0 if don't want SystemMeter window to be topmost window snapto - (optional, default = 15) snap distance (pixels) from screen edges alpha - (optional) alpha transparency value (0 - completely transparent, 255 - opaque); Win2000 and later only! savepos - (optional, default = 0) if set to "1", window position will be saved when exiting SystemMeter Note on skin bitmaps: SystemMeter supports 'great pink' transparency. That is, pixels with color value (R=255, G=0, B=255) will be transparent. Monitor type attribute ---------------------- date_time - sytem date and/or time uptime - system uptime cpu - CPU usage mem - physical memory usage swap - swap usage disk_usage - disk usage monitor modem - modem traffic modem_data - amount of data sent and/or received net - network traffic net_data - amount of data sent and/or received across LAN Monitor-specific attributes --------------------------- date_time --------- format - date/time format: %Y - 4-digit year %y - 2-digit year %m - month number %b - short month name (English only) %B - long month name (English only) %d - day of the month %a - short weekday name (English only) %A - long weekday name (English only) %h - hours (12-hour clock) %H - hours (24-hour clock) %p, %P - 'a' or 'p' indicators %M - minutes %S - seconds uptime ------ format - uptime format: %d - uptime days, no leading zero %D - uptime days, leading zero %h - uptime hours, no leading zero %H - uptime hours, leading zero %m, %M - uptime minutes %s, %S - uptime seconds mem --- avail - (optional) set to 1 to monitor available memory; default is 0 (% mem used) swap ---- avail - (optional) set to 1 to monitor available swap file; default is 0 (% swap used) disk_usage ---------- drive - (optional) drive letter (letter only); default is "c" avail - (optional) set to 1 to monitor available disk space; default is 0 (% drive space used) modem ----- port - modem port, eg. "com2" traffic - traffic direction (0 - in, 1 - out, 2 - both) NOTE: data passed to graph and histogram displays is in bytes/sec (take care if setting maxval for those displays) modem_data ---------- port - modem port, eg. "com2" traffic - traffic direction (0 - in, 1 - out, 2 - both) disconnect_reset - (WinNT/2000/XP only) set to 1 if you want the counter to be reset after a connection is dropped (optional, default is 0) scale - (optional, default is bytes) scaling factor ("k" for kB, "m" for MB, none for bytes) NOTE: This monitor behaves differently under Win9x and WinNT/2000/XP. On Win9x, the counter is not reset after connect/disconnect, effectively measuring the amount of data sent and/or received between two reboots. On WinNT/2000/XP, it measures the amount of data sent and/or received while a connection is active. The counter is reset when a new connection is made. net --- adapter - adapter name; The easiest way to get the adapter name is yo select 'List network adapters' from the right-click menu, select the adapter from the list and clicking 'Copy to clipboard' button. After that, simply paste the name into your skin file. traffic - traffic direction (0 - in, 1 - out, 2 - both) NOTE: data passed to graph and histogram displays is in bytes/sec (take care if setting maxval for those displays) net_data -------- adapter - adapter name; The easiest way to get the adapter name is yo select 'List network adapters' from the right-click menu, select the adapter from the list and clicking 'Copy to clipboard' button. After that, simply paste the name into your skin file. traffic - traffic direction (0 - in, 1 - out, 2 - both) scale - (optional, default is bytes) scaling factor ("k" for kB, "m" for MB, none for bytes) Displays -------- Text attributes --------------- x - text X position y - text Y position align - (optional, default is left) text alignment: left, right or center this attribute controls how x attribute is interpreted, e.g. for "right" alignment, x represents right side of the displayed text prefix - (optional) text that will be placed in front of the data suffix - (optional) text that will be placed after the data (eg, "%") font - font name font_size - font size in points bold - optional; set to 1 for bold font italic - optional; set to 1 for italic font color - font color; the format is: BBGGRR in hex Graph attributes ---------------- left - graph X position top - graph Y position width - graph width height - graph height filled - set to 1 for a filled graph; 0 for line graph (not needed if using 'skin' parameter) skin - sets the skin bitmap (bitmap must have the same dimensions as the graph) color - graph color; the format is: BBGGRR in hex maxval - (optional) if set to a value > 0, the values in the graph will not be scaled automatically during runtime; insted, values greater than maxval will be truncated to maxval; note that some monitors (e.g. CPU) set maxval themselves Histogram attributes -------------------- left - graph X position top - graph Y position width - graph width height - graph height orientation- 0 - vertical, min is down 1 - vertical, min is up 2 - horizontal, min is left 3 - horizontal, min is right step - (optional) sets the increment step (in pixels); default is 1 skin - (optional) sets the skin bitmap (bitmap must have the same dimensions as the histogram) color - graph color; the format is: BBGGRR in hex maxval - (optional) if set to a value > 0, the values in the graph will not be scaled automatically during runtime; insted, values greater than maxval will be truncated to maxval; note that some monitors (e.g. CPU) set maxval themselves NOTE: All attribute values MUST be enclosed in quotes! Controlling SystemMeter ----------------------- To start SystemMeter from PowerPro, you must store the FULL pathname of the skin file into x0 variable, and then run "*Exec Plugin SystemMeter start" command. So, in a script, it would look something like this: *Assign x0 "C:\Program Files\PowerPro\skins\SystemMeter\Simple Gray\skin.xml" *Exec Plugin SystemMeter start To hide/show SystemMeter window, run this command: "*Exec Plugin SystemMeter showhide" To unload SystemMeter, run "*Exec Plugin SystemMeter *" command. SystemMeter has a right-click menu with the following options: Reload skin - reloads the current skin List network adapters - opens a dialog that lists installed network adapters (copy the name and use it with net monitors) About SystemMeter - show the about box And that's it! Enjoy! LICENSE AND WARRANTY -------------------- The SystemMeter DLL file, this readme file and "Simple gray" skin files (skin.bmp and skin.xml) are all Copyright 2001 by Marko Bozikovic. All Rights Reserved. THIS SOFTWARE IS DISTRIBUTED "AS IS," WITHOUT WARRANTY AS TO PERFORMANCE OF MERCHANTABILITY OR ANY OTHER WARRANTIES WHETHER EXPRESSED OR IMPLIED. BECAUSE OF THE VARIOUS HARDWARE AND SOFTWARE ENVIRONMENTS INTO WHICH THIS PROGRAM MAY BE PUT, NO WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE IS OFFERED. GOOD DATA PROCESSING PROCEDURE DICTATES THAT ANY PROGRAM BE THOROUGHLY TESTED WITH NON- CRITICAL DATA BEFORE RELYING ON IT. THE USER MUST ASSUME THE ENTIRE RISK OF USING THE PROGRAM. SystemMeter PowerPro plugin is freeware. SystemMeter PowerPro plugin may be distributed freely, as long as all files in the package are distributed, including this readme file. SystemMeter PowerPro plugin may not be sold nor be used in any profit- oriented endeavor without the express written permission of the author with the exception that SystemMeter PowerPro plugin may be distributed freely via media intended to make shareware available to the public for trial. All trademarks used in the documentation are the property of their respective owners and are used for explanatory purposes only.