* ORNL PVM * * ORNL PVM * * ORNL PVM * * ORNL PVM * * ORNL PVM * * ORNL PVM * 
--------------------------------------------------------------------------
|  This directory contains a simple Fortran example for PVM and PVMe
--------------------------------------------------------------------------
|                                                                        
|  Filename           Style   Description                                  
|  --------           -----   -----------                                  
|  manager.f          MPMD    A basic "hello world" type program
|  worker.f                                                                
|                                                                        
--------------------------------------------------------------------------
|  Please direct any questions, comments or suggestions                  
|  to karin@cam.nist.gov.                                                
--------------------------------------------------------------------------

This directory includes the following files:

README.pvm (this file) * ORNL PVM *
README.pvme 
make.pvme
make.pvm
manager.f
manager.input.pvm
manager.input.pvme
user.cleanup
user.setup
worker.f

To run the sample program in batch under ** ORNL PVM ** ,
making use of the batch job preparation utility xllcreate:

Set up your environment for xllcreate and copy the PVM/PVMe example 
(if not already done):

   1) a) Add the following lines to your .cshrc file:
         setenv LLC_ROOT /usr/local/apps/LLCREATE
         alias llcreate ${LLC_ROOT}/bin/llcreate
         alias xllcreate ${LLC_ROOT}/bin/xllcreate
      b) Remove from your .cshrc any old references to XL_ROOT and (x)loadlgen
      c) Source your .cshrc file so these settings take effect
         (* Don't forget this step ! *)

   2) Copy the sample directory to your own area:    

      /usr/bin/cp -r /usr/local/doc/Examples/pvm+pvme/Fortran ~/<your_directory>

      This will create a subdirectory under your home directory
      called <your_directory>.

   3) Set your DISPLAY environment variable if not already set.

Build and submit the example:

   4) In the directory ~/<your_directory>, type: make -f make.pvm

   5) Call up the xllcreate program: xllcreate

   6) Experiment with the entry panel, using the Help button to
      get started.  You may use "Help" throughout xllcreate as needed.

      For the program to properly execute, you will need to enter
      the following information:

        The program is PVM, and MPMD.
        The main executable is "manager", and the secondary "worker".
        The program does not take arguments, but does read
          from standard input. The appropriate file to redirect
          is called "manager.input.pvm" (You can change the input
          value in manager.input.pvm.)
        The program does not explicitly open any input files.
        The user.setup and user.cleanup scripts are optional, but
           user.cleanup will copy back an output file you won't 
           otherwise see, as well as the pvm log file.

       *------------------------------------------------------------*
       * NOTE: A short postscript document describing X-llcreate    *
       *       is available. See $LLC_ROOT/doc/LLC-doc.ps.          *
       *------------------------------------------------------------*

   7) Create the command file with "Create *.cmd File"

   8) Submit the job!

Experiment with your own program...

   9) Assuming all goes well with this example, please feel free to try
      out the utility on your own favorite example.  Simply call up
      xllcreate from the directory containing the executable(s).


                              * * * * * * *
          Comments and suggestions will be greatly appreciated.
     Feel free to call ext. 5119 or send e-mail to karin@cam.nist.gov.