WASD yahMAIL for VMS Apache (CSWS)
 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


Development environment was CSWS V1.0-1 (VMS Apache 3.1.12). Installation steps:

  1. THIS SCRIPT REQUIRES CAREFUL CONFIGURATION
    read the yahMAIL Usage Guide thoroughly first!

  2. build executable

  3. copy executable and support procedure

  4. yahMAIL script startup

  5. add mapping and authorization rules as described in Configuration below

  6. read configuration chapter of yahMAIL Usage Guide again then modify YAHMAIL$CONFIG against local requirements:   $ EDIT YAHMAIL$CONFIG

  7. It is possible to localize the language of the text and messages provided by yahMAIL.  Check the file LANG_EN.C for details.


Configuration


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 VMS Apache installation the files are distributed as follows:

As discussed in the documentation, private access to user email requires authentication and authorization.  Apache offers a number of mechanisms for authentication and authorization configuration.  Please consult the relevant documentation.  The following provides example [CONF]HTTPD.CONF entries for SYSUAF authentication.

  # YAHMAIL.CONF will need to have it's paths to the documentation edited!
  Alias /yahmail/doc/ "/apache$common/src/yahmail/doc/"
  
  LoadModule auth_openvms_module
  /apache$common/modules/mod_auth_openvms.exe_alpha

  <Location /cgi-bin/yahmail>
  AuthType Basic
  AuthName "OpenVMS authentication"
  AuthUserOpenVMS On
  require valid-user
  </Location>

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