Copyright 1998-1999, University of Notre Dame.
Authors: Jeffrey M. Squyres, Kinis L. Meyer with M. D. McNally 
         and Andrew Lumsdaine

This file is part of the Notre Dame LAM implementation of MPI.

You should have received a copy of the License Agreement for the Notre
Dame LAM implementation of MPI along with the software; see the file
LICENSE.  If not, contact Office of Research, University of Notre
Dame, Notre Dame, IN 46556.

Permission to modify the code and to distribute modified code is
granted, provided the text of this NOTICE is retained, a notice that
the code was modified is included with the above COPYRIGHT NOTICE and
with the COPYRIGHT NOTICE in the LICENSE file, and that the LICENSE
file is distributed with the modified code.

LICENSOR MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED.
By way of example, but not limitation, Licensor MAKES NO
REPRESENTATIONS OR WARRANTIES OF MERCHANTABILITY OR FITNESS FOR ANY
PARTICULAR PURPOSE OR THAT THE USE OF THE LICENSED SOFTWARE COMPONENTS
OR DOCUMENTATION WILL NOT INFRINGE ANY PATENTS, COPYRIGHTS, TRADEMARKS
OR OTHER RIGHTS.

Additional copyrights may follow.


Distribution information
------------------------

The general LAM web site can be found at:

	http://www.mpi.nd.edu/lam/

The latest release of the LAM software can be found at:

	http://www.mpi.nd.edu/lam/download/

The posts to the LAM mailing list are also archived on the web:

	http://www.mpi.nd.edu/MailArchives/lam/

Mirrors of all of these sites are available.  Consult:

	http://www.mpi.nd.edu/lam/mirrors/


Introduction
------------

This is LAM/MPI version 6.3.  Although this version has been tested
in many different environments, it is still "beta" -- your mileage may
vary.

Users are highly encouraged to report all problems with LAM 6.3 to
the LAM mailing list (lam@mpi.nd.edu) We would like to release LAM/MPI
in non-beta form at some point, and rely on user input to identify and
help fix problems.

As such, we request that you also download the "lamtest" package from
the LAM web site and run it on your system.  If any errors are
encountered, please send us all the output (see the README file in
that package).  

We would greatly appreciate your time and effort in helping to verify
LAM/MPI on a wide variety of systems.

*** Users are ***highly*** encouraged to read the RELEASE_NOTES file,
*** as it contains information on all the new features in this version
*** of LAM/MPI.

Files
-----

The contents of the text files at this level are:

COPYRIGHT	-- Copyright notice
HISTORY		-- History of changes
INSTALL		-- How to install and run LAM
README		-- This file
RELEASE_NOTES	-- Description of features of this version

The contents of the directories at this level are:

config		-- installation configuration files
contrib		-- some contributed code
examples	-- example programs
help            -- LAM help file
lib/otb		-- libraries
man		-- manual pages (start with lam(7))
mpi2c++         -- the MPI 2 C++ bindings from the Laboratory for 
                   Scientific Computing at the University of Notre Dame
otb		-- source for LAM access commands
otb/sys		-- source for daemons
otb-obj		-- objects for above
romio           -- the ROMIO distribution for MPI IO from the Mathematics and 
                   Computer Science Division of the Argonne National
                   Laboratory
schema		-- configuration files for nodes and topologies
share		-- portable sources and header files
tools		-- source for LAM management utilities
tools-obj	-- objects for above

Installation instructions and release notes are in the INSTALL and
RELEASE_NOTES files, respectively.  We recommend also checking the web
site since it may contain more up to date post-release information.

As of yet there is no LAM 6.3-specific documentation apart from the
release notes and the LAM 6.1 documentation (which, for the most part,
is applicable to LAM 6.3).  The LAM 6.1 documentation can be
obtained from http://www.mpi.nd.edu/lam/download/.


Contact information
-------------------

LAM is currently a pseudo-supported package by the University of Notre
Dame.  That is, there are graduate students who are actively working
on LAM, but are more dedicated to new features and bug fixes.
However, there is a LAM mailing list to which general questions can be
directed.

To subscribe to the list, send mail to the following address:

	majordomo@mpi.nd.edu

with the line "subscribe lam" in the body of the e-mail (the contents
of the Subject line are irrelevant).  You may unsubscribe at any time
by sending an e-mail with "unsubscribe lam" in the body of the message
to the same majordomo address.

NOTE: People tend to only reply to the list; if you subscribe, post,
and then unsubscribe from the list, you will likely miss replies 

Also please be aware that lam@mpi.nd.edu is a list that goes to a few
hundred people around the world -- it is not uncommon to move a
high-volume exchange off the list, and only post the final resolution
of the problem/bug fix to the list.


I have a question/problem.  What do I do?
-----------------------------------------

The INSTALL and RELEASE_NOTES files contain much information which may
answer your question.  Additionally, the INSTALL file provides a
"Troubleshooting" section on how to find information on specific
problems.


I need to contact the authors directly
--------------------------------------

If you have specific requests for the authors of LAM (bearing in mind
that general questions/problems will probably be addressed quicker
across the general LAM list), send mail to:

	llamas@mpi.nd.edu


Make today an MPI day!

-=-

LAM/MPI Project
http://www.mpi.nd.edu/lam/
Laboratory for Scientific Computing
Department of Computer Science and Engineering
University of Notre Dame
