======================================================================
               HOW TO INSTALL TAPE/PVM ON YOUR SYSTEM

                          Eric Maillet
                  LMC-IMAG, Grenoble, France
                     Eric.Maillet@imag.fr
======================================================================

---------------------    REQUIREMENTS: -------------------------------

- pvm3.2 or pvm3.3.4 or above
- imake (used to generate the appropriate Makefiles for your system)
- perl4.0 (some of the tools that come with Tape/Pvm are written in perl)
- about 4 MB of free disk space (for sources, obs, libs)
----------------------------------------------------------------------

NOTE: you don't have to be root to install TAPE/PVM. It's intended to
be installed on your personal user account. You can consider TAPE/PVM
as being a usual PVM application. See the manual for a more
general decription of TAPE/PVM (the manual 'tape-manual.ps.gz' is available
in the same place you got this distribution).

NOTE2: PVM 3 has to be correctly installed on your system.  The environment
variables PVM_ROOT, PVM_ARCH, PVM_VERSION have to be set properly. The pvm3
directory must exist in your home directory. If you want to build a
FORTRAN interface for TAPE/PVM, the PVM source tree has to be accessible.
Here are some examples of the required environment variables:

  PVM_ARCH=RS6K
  PVM_ROOT=/home/my_name/pvm3
  PVM_VERSION=pvm3.3.4

NOTE3: Tape/Pvm has been tested on PVM versions 3.2.6, 3.3.4 and 3.3.7. It 
should work fine for higher versions. We are testing Tape/Pvm on higher 
versions as soon as these are installed on our system.

First, you have to uncompress and un-tar the TAPE/PVM source tree
anywhere on your user account:

   gzip -dc tape.tgz | tar xvf -

or, for those using gnutar

   gnutar xzvf tape.tgz

You will obtain the 'pvmtape' directory (referred to as .). Cd to it now, 
and do the following:

1) 'source ./config.csh'

Decide if the default settings for imake are correct. These are in 'site.def'
which is usually located in /usr/lib/X11/config. I recommend to use an
ANSI C Compiler (e.g. gcc).

If settings are OK (which is probably the case) comment the IMAKEINCLUDE
line in 'config.csh'

EFFECT OF STEP 1): sets the following environment variables

 - IMAKEINCLUDE : in case you want to use personal 'site.def'
                  (default is not to use personal 'site.def')
 - TAPE_ROOT    : where TAPE/PVM's binaries and includes are installed
 - PVM_SRC_ROOT : location of the PVM3 source tree

NOTE: 'config.csh' tries to locate your PVM3 source tree in /usr/local.
If you installed PVM3 in a different location edit 'config.csh'. If the
PVM3 source tree is not accessible, you can't have FORTRAN support.

2) edit './config'

Decide if you want FORTRAN support. Set 'TapeFortran' accordingly.

NOTE: Set 'TapeFortran' to 'YES' only if 'config.csh' in step 1)
reported that you can have FORTRAN support.

Go directly to 4) if you decided in 1) to use default settings for imake

3) edit './site.def'

Specify the compiler used to build TAPE/PVM. Default is to use 'gcc'.

I have tested the following compilers:

   o gcc, SunOS, Sun4
   o gcc, OSF/1, DEC ALPHA
   o gcc, AIX/6000, IBM SP1
   o xlc, CSet++ AIX/6000, IBM SP1

NOTE: './site.def' overrides the definitions in your system 'site.def' 
(usually in /usr/lib/X11/config). In case you want to use your
system's 'site.def', you have to uncomment the IMAKEINCLUDE line in
'config.csh' (see step 1).

NOTE2: if for some reason (e.g. bad installation) your imake looks for
its configuration files in the wrong place (e.g /usr/local/lib/X11/config)
instead of /usr/lib/X11/config) you can define the ConfigDir
macro in your 'site.def' (e.g., #define ConfigDir /usr/lib/X11/config).
  
4) build and install TAPE/PVM

- To build the Makefiles do (in the root of TAPE/PVM's source tree)

      make Makefile  ( to rebuild the main Makefile for your system )
      make Makefiles ( to build the Makefiles in the subdirectories )
      make depend    ( update dependencies for include files )

If something goes wrong, the main 'Makefile' can get corrupted. In
this case, rebuild a correct 'Makefile' by

imake -DUseInstalled -I/usr/lib/X11/config  -DTOPDIR=. -DCURDIR=.

( Note: your config dir may be elsewhere )
 
- To build TAPE/PVM do (in the root of TAPE/PVM's source tree)

      make

NOTE: to compile the TAPE/PVM FORTRAN library, your version of make has
to support pattern matching rules (e.g. GNU Make version 3.72.1).

NOTE2: if you get an error in ./lib/fderoute, your version of make does
probably NOT support pattern matching rules. Turn to ./lib/fderoute
and run, for example, gnumake. This will build the Fortran
interface. Then, turn back to the root of the source tree (.) and
re-run your normal make.

- To install TAPE/PVM's binaries and tasks do

      make install

NOTE: if you used the default settings in 'config.csh' (cf step 1) you will
find TAPE/PVM's libraries and includes in $PVM_ROOT/tapelib.

TAPE/PVM is now installed. The 'examples' subdirectory contains
example programs you can instrument. Just turn to the corresponding
subdirectories, read the README and/or INSTALL files and try them out.

     
