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

This directory includes the following files:

README.mpl 
make.mpl
mplmanager.c
mplworker.c
user.cleanup
user.setup

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

Set up your environment for xllcreate and copy the MPL 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/mpl/C ~/<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.mpl

   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 MPL, and MPMD.
        The main executable is "mplmanager", and the secondary "mplworker".
        The program does not take arguments, nor does it read
          from standard input. 
        The program does not explicitly open any input files.
        The user.setup and user.cleanup scripts are optional.

       *------------------------------------------------------------*
       * 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.