PU Monitor 2.1

Content

1. Introduction
2. Requirements
3. Installation
4. Configuration
5. License Agreement
6. Trademarks
7. Contact Information
8. Credits

Introduction

PU Monitor is a general purpose system monitoring tool for OS/2 PM. The idea of implementing such a tool, came to me when I looked into "Settings" page of Warp Center, and found there was nothing of interest to me except CPU usage. Other available system monitors couldn't meet my needs for different reasons and I decided to write another one. The number of parameters monitored is limited now to CPU usage, TCP/IP traffic, available memory, uptime, and POP3 mailbox monitor. In version 2.0 connection monitor was also added, which has no screen presentation and can be used as custom version of ping utility able to inform you that connection to some site is lost.

Because the first version of PU Monitor was completely satisfactory for me, I have stopped further development. Later this version was made available to public and I received a lot of feedback from users of first version of PU Monitor, that's why I resumed development. The current version significantly differs from first one. This version is completely rewritten, uses multithreaded design to gather information, buffered drawing for smooth and flicker free look, greatly improved user interface, support for many graph types, settings notebook, and many many more smaller improvements, so it is really a fully new program.

Requirements

Operating system

OS/2 Warp 4.0 with FP#1 installed

or

OS/2 Warp 3.0 with FP#35 installed

TCP/IP

TCP/IP 3.0 (comes with OS/2 Warp 3.0 Connect)

or

TCP/IP 4.0 (comes with OS/2 Warp 4.0)

or

TCP/IP 4.1 (separate product)

Installation

Configuration

1. CPU Monitor
2. IP Monitor
3. Memory Monitor
4. Mailbox monitor

Later these windows will be named by their assignment

When you start PU Monitor for the first time, they are shown using default configuration which may definitely different from what you want. To solve this problem, just press right mouse button over PU Monitor window and you'll see menu.

This menu consist from following items:
1. About

invokes Settings dialog box at About page.

2. Settings

invokes Settings dialog box at specified page.

General

CPU Meter

Memory Meter

TCP/IP Traffic

Mail Checker

Connectivity

3. Read mail

invokes mail program, if it is properly installed and configured in Settings dialog at Mail Checker page.

4. Exit

closes program window and shuts down program.

Settings dialog.

Settings dialog contains most settings of PU Monitor. It consists of 7 pages:

General

CPU Meter

Memory Meter

TCP/IP Traffic

Mail Checker

Connectivity

About

General

This page is used to set up general settings and colors for user defined palette.
• Group Behavior:
• Float on top.

Range: On/Off.

This check box is responsible for switching on and off Float on top feature of PU Monitor. Making them on gives PU Monitor ability to float on top of all windows, even if they are maximized and therefore makes it always visible.

• Attach to Warp Center.

Range: On/Off.

This check box is responsible for switching on and off Attach to Warp Canter feature of PU Monitor. Making them on gives PU Monitor ability to float on top of Warp Center window. Windows which overlaps Warp Center overlaps also PU Monitor window. Also PU Monitor tries to follow Warp Center Window as long as possible.
Note: This feature is dependent from availability of Warp Center window in Window List. Therefore, if you delete Warp Center from this list, for example using Task Switcher from SysBar/2 package, this feature would not work.

• Lock in place.

Range: On/Off.

This check box is responsible for switching on and off ability of PU Monitor window to be dragged with left mouse button. You should note that this check box is does not switch off the ability of PU Monitor window to be changed in size.

• Group Look:
• Overlap Warp Center buttons
• Left

Range:"None"/"Shutdown"/"Find/Shutdown"/"Lock/Find/Shutdown"/"All"
• Right

Range:"None"/"Tray List"

Select Warp Center buttons which will overlapped by PU Monitor. This options have effect only when Attach to Warp Center is on.

• 3D look: look of PU Monitor sub windows.

Range: On/Off.
• Group Palette:

Default
Inverse Gray
Light Gray
Dark Gray
Green on Black
Gray on Black 1
Gray on Black 2
Combined Black
User defined	uses colors which can be tuned through Color group described below.

• Group Color



Choose color which you want to edit, and set it as you prefer using Red, Green and Blue spin buttons. Image above will help you to find dependence between color name and parts of PU Monitor. If you want to preview results, press Apply push button.
Note: pressing this push button will make all changes permanent and stores it in PU Monitor INI file.

CPU Meter

This page tunes CPU usage meter.
• Refresh interval: interval between window refreshes.

Range: 1-10 seconds.
• Graph: type of the graph displayed in windows.

Range: None/Bar/Graph.
• Text: show or hide values of last CPU Usage measurement.

Range: On/Off

Memory Meter

This page tunes Memory Meter, Uptime and Clock display.
• Refresh interval: interval between measurements of amount of free memory and updating of window content.

Range: 1-100 seconds.
• Clock: show or hide clock.

Range: On/Off
• RAM: show or hide information about free RAM.

Range: On/Off
• Group Uptime:
• Show: show or hide displaying of uptime.

Range: On/Off.
• Method: chooses method of uptime measurement.

Range: Standard/HiRes Timer.

Note 1:HiRes stands for High Resolution timer.
For more detailed information look at IBM DEVELOPER'S TOOLKIT FOR OS/2 WARP.

Note 2:Standard and High Resolution timers show slightly different results, because High Resolution timer depends on the device driver which is loaded during the boot sequence a few seconds later than the kernel itself is started. Also, the using of DOS application (especially games) can break results shown by this method.
Despite these disadvantages, this method is highly recommended for computers with high uptimes, because it does not wrap values greater than 48 days.

TCP/IP Traffic

This page tunes TCP/IP Traffic monitor.
• Refresh interval: interval between measurements of traffic.

Range: 1-100 seconds.
• Graph: type of the graph displayed in windows:

Range: None/Bar/Graph.
• Text: type of values of IP traffic measurement.

Range: "None"/"In/Out"/"In/Out/Totals"
• Interface: this combo box contains list of interfaces available at computer. Choose one interface which you want to monitor.

Note: not all interfaces always exists. For dial-up connections in TCP/IP stacks prior to 4.1, serial interface appears when connection is established and disappears when connection is closed. For TCP/IP 4.1 serial interface appears when connection is established for the first time and exists until reboot.
• Adaptive bar graph: calculate maximum values for bar graph at runtime instead of use maximal throughput of interface reported by IP stack.

Range: On/Off

Mail Checker

This page tunes POP3 mail box checker.
• Enabled: enables this feature.

Note: disabling this feature by leaving this check box unchecked does not hides Mail Checker sub window. If you don't want to use this feature and leave more space to other sub windows you should manually change size of the rightmost sub window where Mail Checker resides.
• Refresh interval: interval between checking up the number of messages in mail box.

Range: 10-999 seconds.
• Group On new mail:
• Sound signal: enables audible signal when new mail has arrived.

Range: On/Off.
• Repeat sound: enables repeat of sound signal while mail box is not empty.

Range: On/Off.
Note: Mail checker expects that mail box will be empty when you read all messages in it. If your mail program is tuned up so that it don't delete messages in mail box it is recommended to make this switch off. Leaving Sound signal on in this case will take expected effect: you will hear signal once when new mail is arrived.
• Run: Check box, entry field and push button.

This feature allows you to start program when new mail is arrived. If you want to use this feature make check box Run on (i.e. checked) and type full path to program, or push button [...] and find the program required using File Open dialog. Program will run using program path as working directory.
• Group Mail Reader:
• Path: type full path to program which you use as mail reader. Or find program using File Open dialog by pressing [...] button.
• Parameters: type additional parameters which may be required by your mail package.

Note: this program can be started through choosing menu item Read mail. Also, this program will be started using program path as a working directory. This is required for some mail readers such as PMMail.
• Group Account:
• User: type your account name
• Server: type address or host name of server which handles your mail box.
• Password: type password for your account.
• Port: type port on which POP3 server works. By default this value is 110, this is default value for POP3 service.

Connectivity

This page tunes custom ping feature which acts as connectivity monitor.
• Refresh interval: interval for scanning of list of hosts.

Range: 1-999 seconds.
Note: If you monitor more than one site, this interval will be distributed among these sites.
• Group Monitored sites:

This group consists of entry field, list box and three push buttons: Add, Del and Update. This group is used for editing list of sites. To add new site in list, type name or address of site in entry field and click on the Add push button. If you want to delete site from the list, choose site in list box and click Del. If you want to change site name, choose site in list, edit it as appropriate in entry field and press Update button.
• Group On loss of connectivity:

This group consist of Sound signal and Run check boxes, two entry fields and [...] push button. Usage of this group is similar to usage of Mail Reader group at Mail Checker page, except in parameters you can type %s parameter which will be replaced with name of site.

About

Contains short information about author and contact information.

License Agreement

Redistribution and use of PU Monitor in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

THIS SOFTWARE IS PROVIDED BY THE AUTHOR OR CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

PU Monitor Copyright (c) 1998,1999 Sergey I. Yevtushenko

Trademarks

Trademarks mentioned in documentation
• OS/2, TCP/IP for OS/2 - Trademark of IBM Corp.
• IBM DEVELOPER'S TOOLKIT FOR OS/2 WARP - Trademark of IBM Corp.
• PMMail - Trademark of SouthSide Software.
• SysBar/2 - (c) Dmitry I. Platonoff.

Contact Information

Author can be reached
• Internet: evsi@naverex.kiev.ua es@sbs.kiev.ua
• Fidonet: 2:463/114.69@fidonet
• Author's home page

Credits

Dmitry Ban
Denis Dubenin
Dmitry Platonoff
Alexander Krapivin

And many many others not listed above.

Special thanks to Judy Ann Dukie
She done hard work of proof reading this text.