

INSTALLATION
------------

step 1: Get system from 

          http://www.nsrc.nus.sg/STAFF/edward/pg_pvm.html

step 2: Uncompress & untar, eg. 
         
          > gzip -d pg_pvm-0.9.tar.gz
          > tar xvf pg_pvm-0.9.tar

step 3: Set up environment variables, eg.

          > setenv PVM_ROOT <whereever your PVM installation is>
          > setenv PVM_ARCH `$PVM_ROOT/lib/pvmgetarch`

step 4: Type make in the source directory.
        NOTE: you will need write permission to your
		  PVM_ROOT directory!
			

RUNNING
-------

step 1: Translate your source code.

		  C:  1) #include "pg_proto.h"
	         2) compile with "-I$PVM_ROOT/pg/include"	

		  FORTRAN: change the folloing
	         pvmfmytid --> pgfmytid
				pvmfexit --> pgfexit
				pvmfrecv --> pgfrecv
				pvmfnrecv --> pgfnrecv
				pvmftrecv --> pgftrecv
				pvmfsend --> pgfsend
				pvmfmcast --> pgfmcast
				pvmfspawn --> pgfspawn
				pvmfinitsend --> pgfinitsend
				pvmfpsend --> pgfpsend
				pvmfprecv --> pgfprecv

        Compile C & FORTRAN with "-L$PVM_ROOT/pg/lib/$PVM_ARCH -lpg"

step 2: Start PVM as usual.

step 3: Run PG_PVM server, eg.

			 > $PVM_ROOT/pg/lib/$PVM_ARCH/pgserver
        
		  You should get the example response

          > waiting for ACK from server 
		    > PG server 40003 started ... 

step 4: Run you application as per normal

step 5: In case of problems, you may start the PG_PVM console, eg.
		 
			 > $PVM_ROOT/pg/lib/$PVM_ARCH/pgcons 

        Type help for instructions.  If everything seems to be stuck
		  it may be due to the topological sort routine.  Read manual 
		  for instructions.
      
ACKNOWLEDGEMENT
---------------

PG_PVM first came about with my study of the PGPVM source files.
Many thanks to Brad Topol for our initial discussions.  PG_PVM
does not claim to be better then PGPVM ... we're just different :o)

AUTHOR
------

Dr Edward Walker
National Supercomputing Research Centre
81, Science Park Drive
Singapore 0511

internet: edward@nsrc.nus.sg
tel: (65)-770-9234
