
          PVM 3.2:  Parallel Virtual Machine System 3.2
              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,
   W. C. Jiang, 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.2 was funded in part by the U.S. Department of Energy, the
National Science Foundation and the State of Tennessee.

________________________________________________________________________
PVM

PVM is a software system that enables a collection of heterogeneous
computers to be used as a coherent and flexible concurrent computational
resource.

The individual computers may be shared- or local-memory multiprocessors,
vector supercomputers, specialized graphics engines, or scalar
workstations, that may be interconnected by a variety of networks,
such as ethernet, FDDI.

User programs written in C, C++ or Fortran access PVM through library
routines.


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 startup script (pvm3/lib/pvm) should be in your shell
search path.  This script determines machine architecture and runs the
correct console program in pvm3/lib/ARCH/pvm.


STARTING DAEMONS

To start pvm, run pvm3/lib/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, run pvm3/lib/pvmd .
A number of hosts can be started by supplying the pvmd with a host
file.


APPLICATION PROGRAMS

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


CONTACT

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

	pvm@msr.EPM.ORNL.GOV.

A newsgroup, comp.parallel.pvm, exists for discussion about PVM.

