
          PVM 3.0:  Parallel Virtual Machine System 3.0
              University of Tennessee, Knoxville TN.
          Oak Ridge National Laboratory, Oak Ridge TN.
                  Emory University, Atlanta GA.
     Authors:  A. L. Beguelin, J. J. Dongarra, G. A. Geist,
         R. J. Manchek, B. K. Moore, and V. S. Sunderam
                  (C) 1992 All Rights Reserved

                             NOTICE

Permission to use, copy, modify, and distribute this software and
its documentation for any purpose and without fee is hereby granted
provided that the above copyright notice appear in all copies and
that both the copyright notice and this permission notice appear in
supporting documentation.

Neither the Institutions (Emory University, Oak Ridge National
Laboratory, and University of Tennessee) nor the Authors make any
representations about the suitability of this software for any
purpose.  This software is provided ``as is'' without express or
implied warranty.

PVM 3.0 was funded in part by the U.S. Department of Energy, the
National Science Foundation and the State of Tennessee.

________________________________________________________________________
UNPACKING

This distribution contains source code, simple examples, and run-time
support for PVM version 3.  The documentation for PVM can be obtained
separately from Netlib.  To get a list of available subsets, send
e-mail to "netlib@ORNL.GOV" with the subject:  "send index from pvm3".

Extract files so that this directory is ~/pvm3 .


BUILDING

Type "make" in this directory.  Make will use aimk to build the daemon
executable (pvmd3), C library (libpvm3.a), Fortran library (libfpvm3.a)
and console client program (pvm).


INSTALLING

The libraries and executables are installed in ~/pvm3/lib/ARCH/, where
ARCH is the host architecture name, e.g. "CRAY".

The pvm console (pvm) should be in your shell search path.  You might
want to copy it to the right directory or add ~/pvm3/lib/ARCH to your
path.  Note that if you use more than one type of machine (architecture),
you'll need to select the correct directory somehow.  Check out the
file doc/cshrc.stub for a way to do this.


STARTING DAEMONS

To start pvm, type "pvm".  This starts the console task, which execs a
pvmd if one is not already running.  More hosts can be started by using
the console "add" command.

To stop pvm, use the pvm console command "halt".

For more information about the console commands, use the console "help"
function.

To start the pvmd without starting the console, type "pvm3/lib/pvmd".
This is a shell script that determines the correct architecture and
starts the pvmd (pvm3/lib/ARCH/pvmd3).  Any number of hosts can be
started by supplying the pvmd with a host file.


APPLICATION PROGRAMS

Programs should be linked with pvm3/lib/ARCH/libpvm3.a .  Fortran
programs should also be linked with pvm3/lib/ARCH/libfpvm3.a .
Include header file pvm3/include/pvm3.h for constants and function
prototypes.  Executables should be installed in pvm3/bin/ARCH .


CONTACT

Please direct any e-mail (questions, bug fixes, etc.) to:

	pvm@msr.EPM.ORNL.GOV.


