Resource Requirement
-------- -----------

IBM SP-2 System running AIX 3.2. 

	
Installation
------------

A1. Copy "./include/sp2gam.h" into your local /usr/include directory.
A2. Copy "./lib/libsp2gam.a" into your local /usr/lib directory.

or

B. Copy the directory in $PATH/gam-1.0, where $PATH is any path.


Using GAM-1.0
----- -------

If you followed steps A above: 

C1. Make sure your programs #include <sp2gam.h>

C2. Compile your C program as follows:

    mpCC -O2 foo.c

C3. and link it as follows:

    ld -e d_overlay_main -T512 -H512 -lc -o foo foo.o -lsp2gam


If you followed step B above:

C1. Make sure your programs #include "sp2gam.h"

C2. Compile your C program as follows:

    mpCC -O2 foo.c -I$PATH/gam-1.0/include

C3. and link it as follows:

    ld -e d_overlay_main -T512 -H512 -lc -o foo foo.o libsp2gam.a \
	-L$PATH/gam-1.0/lib

Running Programs using GAM-1.0e
------- -------- ----- --------

1. Source gam-1.0/SETENV

2. Use the scripts in gam-1.0/bin to run AM programs.  First, do a
symbolic link of am_run to am_run{8,16,32,64,128}, e.g.
        ln -s am_run32 am_run
if you want to used *up to* 32 nodes.

To run programs with up to 8 nodes use the scripts amr{2,...,8}. For
example:

   gam-1.0/bin/amr2 foo 

To run programs using N nodes where N > 8, do:
        setenv MP_PROCS N
and use the amr script.

These scripts will isolate the AM application programs from the
non-SPMD model.