Seti@Home Monitor v1.0.2 for xCenter

1. Introduction
---------------

  This monitor was made based on "SETIPROG.ZIP" and "SETIGAUGE.ZIP",
mixing its functionalities so we have a complete widget to report
SETI@Home status.

  I would like to thank Th.Klein (warpcafe _at_ yahoo.de) and ??? 
(kiwi _at_ perelin.de) for the original scripts in whose this one
is heavily based.


2. Requirements
---------------

  - A computer running OS/2 Warp 4 or better (^=
  - xWorkplace + xCenter installed. Tested with version 1.02.
  - Rexx Gauge widget by Martin Lafaix (tested with version 0.5.2),
    which can be found at http://lafaix.online.fr/wpi.
  - Seti@Home client for OS/2 (tested with version 3.3)

  Note that this widget shall be the ONLY Seti monitor running.
I had not tested it running together Ellie or anything else... So I
don't know if it'll run ok.


3. Features
-----------

   The main features are:
   - Gauge and text displaying current state for Seti packet.
   - Tooltip used for displaying:
	- Completed Workunits
	- Ratio (%/h)
	- How many time was spent in the actual WU
	- How many time is expected to finish this WU
   - Colored gauge will show:
	- Green: Seti is working ok
	- Red: Seti data is found, but it seems to be stopped
	- Yellow: No seti data found... waiting for data.
   - User colors/default colors
   - SETI@Home Stats Page support


4. How to install?
------------------

  - After you installed xCenter and Rexx Gauge, create a gauge widget. To
do so, click with MB2 on xCenter, select "add widget" and then select
"rexx gauge". The widget will be shown as an empity widget.
  - Click with MB2 in this widget and select "properties".
  - Copy and Paste the contents of SETIMONITOR.WGT on the text box labeled
"Gauge script".
  - Copy and Paste the contents of SETIMONITORCLICK.WGT on the text box 
labeled "Double-click action".
  - Change the "Refresh rate" to 10000 ms and, as an option, set the "Gauge
width" as "Fixed" and with something like 55 pixels.
  - There is no need to add anything at "Default Title" nor at "Double 
Click" action.
  - In the "Gauge Script", look at the top of the script. Look for the text:

/* Seti Directory */
p='J:\seti\'

  You must set this to your actual seti directory. For example, if your
Seti@Home is installed at D:\SetiAtHome, you should change these lines to:

/* Seti Directory */
p='D:\SetiAtHome\'

  - In the "Double-click action", look at the top of the script. Look for
the text:

/* Your Browser Exe (full path: pe. 'C:\MOZILLA\MOZILLA.EXE') */
browser = 'C:\MOZILLA\MOZILLA.EXE'

  You must define your browser directory AND executable. If you
use Netscape instead of mozilla, per example, it should look like
this: 

/* Your Browser Exe (full path: pe. 'C:\MOZILLA\MOZILLA.EXE') */
browser = 'C:\NETSCAPE\PROGRAM\NETSCAPE.EXE'

  - In the "Double-click action", look for the text:

/* Your e-mail used on SETI@Home Registration */
email = 'your_seti@email.com'

  And define it with the e-mail you registered at SETI@Home site.
For example: if your SETI@Home email is  johndoe@aol.com , the
line should be defined as:

/* Your e-mail used on SETI@Home Registration */
email = 'johndoe@aol.com'
 
  - Your widget is ready! Click in "Ok" and you will see it running.


5. Fine Tunning
---------------

   - Changing SETI Monitor Widget Colors

   Probably you had noticed the colors used in this widget are "hardcoded".
Well, not at all. If you want to change the colors using the "REXX Gauge
Settings" dialog, look for those lines in the begining of the "Gauge Script":

/* Use user defined colors? */
UserDefinedColors = 0

   If you change it to:

/* Use user defined colors? */
UserDefinedColors = 1

   Then the widget will use the regular colors shown in "Gauge Colors" at
"REXX Gauge Settings" dialog box. You can change them to whatever you
want, using drag'n'drop from solid/mixed color palette.


   - Using a comma as a decimal separator

   If in your country the character used as decimal separator is a
comma instead of a dot, look for this lines in the begining of "Gauge 
Script":

/* Use Comma instead of Dot */
UseComma = 0

   And change it to:

/* Use Comma instead of Dot */
UseComma = 1

   And your Seti Monitor will be compliant to your country! (^=


   - Gauge is always RED!
 
   If your gauge is always red, that means the SETI work is VERY slow
in your machine. SETI Monitor uses the following procedure to determine
if SETI is running or not: after a defined amount of time (100 seconds,
by default) it verifies if the percentage was changed. If not, the gauge
becomes red.
   The time it waits for a change before going into red is defined
by TWO variables. One of them is the "Refresh Rate" in the Settings 
dialog. Usually this should be set to 10000 (10s).
   The other variable is the one found on those lines of the "Gauge
Script":

/* MaxChecks determines how much pollings must be done before */
/* Going into RED (stopped) state. Time = RefreshRate*MaxChecks */
MaxChecks = 10

   MaxChecks determines how many refreshs will wait for a change
in the WU work. The default value is 10 (10*10s = 100s). If your
gauge is always red, you should try to change the variable
MaxChecks to something higher than 10... 20, for example:

/* MaxChecks determines how much pollings must be done before */
/* Going into RED (stopped) state. Time = RefreshRate*MaxChecks */
MaxChecks = 20

   And everything will be fine. (^=


6. Contact
----------

   If you find bugs, feel free to correct them and send me a corrected
version of the widget! (^=
   You can find me (Daniel Caetano) at the address:

   daniel _at_ caetano.eng.br

   The original author of the base scripts can be also found here:

	Th.Klein:
	warpcafe _at_ yahoo.de

	????:
	kiwi _at_ perelin.de


7. History
----------

Aug 22, 2004 - Version 1.0.1
   - Added support to double click action: open SETI@Home server stats.

Aug 16, 2004 - Version 1.0.0
   - Initial Release of SETI Monitor Widget
