Copyright Peter Coghlan 1991-2012. See license.txt for details.

These files are intended to be used to modify Hercules 3.07 to build on Alpha
VMS. This should also work on Itanium VMS but I have not tested this.

The easiest way to proceed is to download hercules-for-vms.zip to your VMS
system and use the VMS version of UNZIP to unpack it in the directory already
containing the source of Hercules 3.07. A [.vms] subdirectory will be created
which contains the VMS specific files.

Alternatively, copy all the files manually to the directory containing the 
hercules 3.07 source, except for vms.c, config.h, sched.h and termios.h which
should be placed in a subdirectory called [.vms] and compiledecnumber.com which
should be placed in the [.decnumber] subdirectory.

Set default to the [.vms] subdirectory and give the command:

@[-]compile vms

Set default to the [.decnumber] subdirectory and give the command:

@compiledecnumber

If bzip2 and zlib support are required, the associated header files and object
libraries should be placed in the [.vms] subdirectory. If not, edit the
config.h file and remove or comment out the lines containing HAVE_ZLIB_H,
HAVE_BZLIB_H, HAVE_LIBZ, CCKD_BZIP2 and HET_BZIP2. Also edit hercules.opt and
the other .opt files and remove or comment out lines containing libz and libbz2
at the bottom of the file.

Set default to the directory containing the Hercules 3.07 source.

The file called hercules-3_07-for-vms-patch.txt can be used as input to the GNU
or other Patch utility to update the Hercules source files as required. It is
not suitable for use with the VMS PATCH command. If a suitable Patch utility is
not available, it should be possible to make the changes required manually as
they are not extensive. 

Then give the commands:

@compilehercules
@linkhercules
@compileothers
@linkothers

If there are no errors, executable files including hercules.exe and various
other utilites should have been produced.

A foreign command can be set up pointing to hercules.exe so that command line
arguments can be given. If no command line arguments are required, the command

$ RUN HERCULES

will be sufficient and Hercules will look for hercules.cnf in the default
directory.

Testing has been done on OpenVMS Alpha V8.2 with HP C V7.1-015 and Multinet
TCP/IP V5.2 rev A. There should be no problems on later versions. Earlier
versions may require some extra tweaking.

These instructions brush over some of the details. If you have any problems,
email me and I will be happy to help. Remove the spaces from the address below
and replace AT with @ and DOT with .

s o f t w a r e AT b e y o n d t h e p a l e DOT i e