yahMAIL for WASD

yahMAIL for WASD
January 2001, 1.5.0

WASD VMS Hypertext Services, Copyright © 1996-2001 Mark G. Daniel.
This package (all associated programs), 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.

WASD yet another hyperMAIL provides direct, on-line Web access to a VMS system's native Mail environment via a standard browser. For further information see yahMAIL Usage Guide.

Installation

Installation steps:

THIS SCRIPT REQUIRES CAREFUL CONFIGURATION
read the yahMAIL Usage Guide thoroughly first!
build executable
- link-only:
  $ @BUILD_YAHMAIL MIME LINK
- alternatively COMPILE+LINK (requires DECC 5.n or 6.n):
  $ @BUILD_YAHMAIL MIME BUILD
- in a PMDF environment, to enable MIME uploads LINK:
  $ @BUILD_YAHMAIL MIME PMDF LINK
- alternatively COMPILE+LINK (requires above):
  $ @BUILD_YAHMAIL MIME PMDF BUILD
copy executable and support procedure
- initial installation:
  $ @INSTALL INSTALL WASD
- subsequent update:
  $ @INSTALL UPDATE WASD
yahMAIL script startup
- if server username is "HTTP$SERVER":
  $ @HT_ROOT:[LOCAL]YAHMAIL_STARTUP
- if server username is something else:
  $ @HT_ROOT:[LOCAL]YAHMAIL_STARTUP username
add mapping and authorization rules as described in Configuration below
read configuration chapter of yahMAIL Usage Guide again then modify YAHMAIL$CONFIG against local requirements: $ EDIT YAHMAIL$CONFIG
It is possible to localize the language of the text and messages provided by yahMAIL. Check the file LANG_EN.C for details.

Configuration

As discussed in the documentation, private access to user email requires authentication and authorization. The following rule is an example of what is required in HTTPD$AUTH.

  [realm-name]
  /cgi-bin/yahmail/~* r+w

The startup procedure must be executed at system startup or if the software is reinstalled or updated. Ensure this becomes part of the Web environment's startup.

For an WASD installation the files are distributed as follows:

HT_EXE:YAHMAIL.EXE
HT_ROOT:[SCRIPT]YAHMAIL.COM
HT_ROOT:[LOCAL]YAHMAIL.CONF
HT_ROOT:[LOCAL]YAHMAIL_STARTUP.COM

Note that this consolidated distribution (v1.2 onwards) relocates the yahMAIL documentation from versions 1.0 and 1.1 of the WASD distribution. It has been moved from

  /ht_root/doc/yahmail/

  /ht_root/src/yahmail/doc/

If this location has been "hard-wired" into any documentation elsewhere in the site (e.g. YAHMAIL.CONF) then it must be altered. A note concerning this new location is generated by the INSTALL procedure in the old location after it removes any previous documentation from the area.

An alternative is to add a mapping rule redirecting access from the former to the new location.

  redirect /ht_root/doc/yahmail/* /ht_root/src/yahmail/doc/*

Mark G. Daniel
Mark.Daniel@wasd.vsm.com.au
Mark.Daniel@dsto.defence.gov.au

Demonstration & Download
http://wasd.vsm.com.au/
http://wasd.vsm.com.au/wasd/
ftp://ftp.vsm.com.au/wasd/index.html