* IBM MPL * * IBM MPL * * IBM MPL * * IBM MPL * * IBM MPL * * IBM MPL * 
--------------------------------------------------------------------------
|  This directory contains a simple Fortran example for MPL
--------------------------------------------------------------------------
|                                                                        
|  Filename           Style   Description                                  
|  --------           -----   -----------                                  
|  mplmanager.f       MPMD    A basic "hello world" type program
|  mplworker.f                                                                
|                                                                        
--------------------------------------------------------------------------
|  Please direct any questions, comments or suggestions                  
|  to karin@cam.nist.gov.                                                
--------------------------------------------------------------------------

This directory includes the following files:

README.mpl 
make.mpl
mplmanager.f
mplworker.f

To interactively run the sample program under ** IBM MPL ** :

0) If this is your first use of the interactive nodes, make sure you
   have read and followed the instructions in ../README.FIRST !!
   You will be asked to add lines to your .cshrc file, copy the
   sample directory to your own area, and rlogin to one of the
   interactive nodes.

1) Switch to the IVM MPL environment, type: 

   prompt> startmpl

     (If mpl is your default environment, set in your .cshrc file,
      and you haven't switched to another environment, then you can skip 
      the startmpl step.  See ../README.FIRST for more information.)

   In your copy of the sample directory, type:

   prompt> make -f make.mpl

   The makefile will direct the compilation and linking of the 
   programs.  The executables are created in the current directory
   in this example. 

2) Set the environment variable describing the parallel programming 
   model (spmd or mpmd).  For this tutorial, the proper setting is mpmd:

   prompt> setenv MP_PGMMODEL mpmd

3) In the sample directory, start the POE (Parallel Operating Environment) 
   on the nodes of the interactive pool by typing:

   prompt> poe 

   You'll be prompted to enter the names of executables, one for each
   node of the machine.

   When you enter the last executable name, the program automatically
   begins running.  To run the program again, you repeat this step,
   starting with the command "poe".

6) Examine the results file generated by the mplmanager program:
  
   prompt> cat mplmanager.results

8) Clean up...  type:

   prompt> make -f make.mpl new
 
   This will remove the executable, object, output and error files,
   to restore the directory to its original state.

--------------------------------------------------------------------
|  Again,                                                          
|  please direct any questions, comments or suggestions            
|  to karin@cam.nist.gov.                                          
--------------------------------------------------------------------