
PVM version 3 examples
05 Aug 1993

________________________________________________________________________

This directory contains C and FORTRAN example programs using PVM 3.0.

1.) Hello + hello_other:
	Two programs that cooperate - shows how to create a new task
	and pass messages between tasks.

2.) Master + slave, fmaster + fslave:
	A master/slave example where the master process creates and
	directs some number of slave processes that cooperate to do the
	work.  C and FORTRAN versions.

3.) Spmd, Fspmd:
	An SPMD (Single Program Multiple Data) example where a single
	"hostless" program creates copies of itself and then proceeds
	to solve a problem in parallel.  Fspmd is identical except
	written in FORTRAN.

4.) Testall.f:
	Illustrates the use of most of the available PVM 3.0 FORTRAN
	calls and also serves to test which options are implemented at
	the present time.

5.) Timing + timing_slave:
	A simple program to illustrate how to measure network bandwidth
	and latency.

To build these examples, use the aimk program (probably in ../lib/aimk).

	aimk hello hello_other    Pair of hello programs
	aimk master slave         C version of master/slave example
	aimk fmaster fslave       FORTRAN version of master/slave example
	aimk spmd                 C version of SPMD example
	aimk fspmd                FORTRAN version of SPMD example
	aimk testall              FORTRAN interface tester
	aimk timing timing_slave  timing example in C

To run examples:  The executables are placed in pvm3/bin/ARCH.  To
execute simply type the executable name at any UNIX prompt after PVM
has been started up.  The examples are independent of the number of
computers in the virtual machine.

You should execute one of:

	hello
	master
	spmd
	testall
	timing

