***   Welcome to interactive PVM(e) and MPL on the NIST SP2!   ***

   This directory contains two tutorial subdirectories: one for 
PVM and  PVMe (combined because the same source file can be used), 
and a second for MPL.   For each message passing library, there is
a detailed README file containing step-by-step tutorial instructions
for building and running the sample program.

  ***   Before you begin !! ***

   Before you get started, you should append the lines attached to
the end of this README.FIRST file to your .cshrc file.  (If your default 
shell is ksh, please contact karin@cam.nist.gov for the appropriate 
commands to add to your startup file.)

   You may select either ORNL PVM (pvm), IBM's PVMe (pvme), or IBM's
MPL (mpl)  as your default message passing environment by editing the 
.cshrc line indicated as the default setting.  By choosing a default, 
you are in no way committing yourself to a particular library, and 
you can easily switch between the two versions during any login session 
with a single command (startpvm, startpvme, or startmpl).

   To run the tutorials, you should make your own copy of the sample
directory. Here's an easy way to accomplish this (assuming you don't 
already have a directory called ~/interact):

   prompt> /usr/bin/cp -r /usr/local/doc/interact .

   After you've modified your .cshrc file and created your own sample
directory, you may begin your interactive session by logging in to 
grand17, grand18, grand19, or grand20.

   The README files give directions for proceeding with the tutorials.

   Good luck!


#-----------------------------------------------------------------
#  Add these lines to your .cshrc file to facilitate switching 
#  between PVM and PVMe.
#------------------------------------------------------
#
# Setup aliases for switching between pvm and pvme:
#
alias startpvm "exec $SHELL -i pvm"
alias startpvme "exec $SHELL -i pvme"
alias startmpl "exec $SHELL -i mpl"
alias set_pvm_pool /usr/local/apps/LLCREATE/bin/set_pvm_pool
alias debug /usr/local/apps/LLCREATE/bin/debug
setenv PVM_ARCH RS6K
setenv PVM_ROOT /usr/local/apps/pvm3
#
# Choose whether this session will be PVM or PVMe... 
#
# Set your desired default here:
#
set PVM_LIB=pvm
# 
# This will change the default if an argument is passed to csh:
#
if ( $1 != "" ) then
  set PVM_LIB=$1
endif

if ( ${?PVM_LIB} )  then
   if ( ${PVM_LIB} == "pvm" ) then
      unset PVMEPATH
      unset PVMDPATH
      setenv PVM_ROOT /usr/local/apps/pvm3
      alias pvm $PVM_ROOT/lib/$PVM_ARCH/pvm
      alias pvmd3 $PVM_ROOT/lib/$PVM_ARCH/pvmd3
   else if ( ${PVM_LIB} == "pvme") then
      unsetenv PVM_ROOT
      setenv PVMEPATH $HOME/pvme/bin/RS6K
      setenv PVMDPATH /usr/lpp/pvm3
      alias pvm /usr/lpp/pvm3/pvm
      alias pvmd3 /usr/lpp/pvm3/pvmd3e -n 4
      alias pvmd3e /usr/lpp/pvm3/pvmd3e -n 4
   else if ( ${PVM_LIB} == "mpl") then
      unsetenv PVM_ROOT
      unsetenv PVMEPATH
      unsetenv PVMDPATH
      setenv MP_PROCS 4
      setenv MP_RMPOOL 3
      alias poe /usr/bin/poe
   endif
endif
#------------------------------------------------------