VMSeti for WASD

20th March 2004, version 1.5.2

VMSeti Copyright © 2000-2004 Mark G. Daniel.
This package comes with ABSOLUTELY NO WARRANTY.
This is free software, and you are welcome to redistribute it
under the conditions of the GNU GENERAL PUBLIC LICENSE, version 2.

VMSeti  provides a simple, efficient interface for monitoring the progress of VMS-based SETI@home processing. Works with SETI@home versions 2.n and 3.n.

Installation

1. $ SET DEFAULT HT_ROOT:[SRC.VMSETI]

2. compile+link the executable (requires DECC):
   $ @BUILD_VMSETI BUILD

   -OR-  just link the executable (using supplied object module):
   $ @BUILD_VMSETI LINK

3. copy executable and support procedure (WASD v8.1 and later)
   $ COPY HT_EXE:VMSETI.EXE CGI_EXE:
   $ COPY VMSETI.COM HT_ROOT:[CGI-BIN]
   
   $ COPY VMSETI.COM HT_ROOT:[SCRIPT_LOCAL]  (earlier than v8.1)

4. access to establish it works using demonstration data files
   http://your.hosts.name/cgi-bin/vmseti

5. ensure the server script can read the SETI data files
   $ SET PROTECTION=W:RE device:[000000]SETI.DIR
   v1.3: $ SET PROTECTION=W:RE device:[SETI]*.TXT
   v2.n: $ SET PROTECTION=W:RE device:[SETI]*.SAH
   v3.n: $ SET PROTECTION=W:RE device:[SETI]*.SAH

6. customize to suit the local site
   $ EDIT HT_ROOT:[SCRIPT_LOCAL]VMSETI.COM

7. INSTALL to allow access to OUTFILE (reporting of power spikes)
   $ INSTALL ADD HT_EXE:VMSETI.EXE /PRIV=(SYSPRV)

Usage

VMSeti locates data files either from the environment variables established during installation above, or the path supplied with the request. Any such path must be mapped by server configuration.

In this way a default location can be provided using the script wrapping procedure and if the site supports multiple processing streams these can be selected by supplying a URL containing a path along with the script.

To include some local information on the report page use the VMSETI_LOCAL environment variable to supply text (plain or HTML), or if the first character is a '@' the location of a file containing this text. Local information is included towards the bottom of the page. This information could provide links to other instances of site processing.

Mark G. Daniel
Mark.Daniel@wasd.vsm.com.au
(Should the above address present problems or provide no response for an extended period then use Mark.Daniel@dsto.defence.gov.au)

Demonstration & Download
http://wasd.vsm.com.au/cgi-bin/vmseti
http://wasd.vsm.com.au/wasd/
ftp://wasd.vsm.com.au/wasd/index.html