Sun MPI 4.0 Programming and Reference Guide

Preface

Sun MPI 4.0 Programming and Reference Guide describes the Sun MPI library of message-passing routines and explains how to develop an MPI (message-passing interface) program on a Sun HPC system. For information about using MPI with Platform Computing's Load Sharing Facility (LSF) Suite 3.2.3, see the Sun MPI 4.0 User's Guide: With LSF. For informatin about using MPI with the Sun Cluster Runtime Environment (CRE), see the Sun MPI 4.0 User`s Guide: With CRE.

For the most part, this guide does not repeat information that is available in detail elsewhere; it focuses instead on what is specific to the Sun MPI implementation. References to more general source materials are provided in the section "Related Publications" of this preface.

The reader is assumed to be familiar with programming in C or Fortran. Some familiarity with parallel programming and with the message-passing model is also required.

Before You Read This Book

For general information about writing MPI programs, refer to any of the several MPI source documents cited in the section "Related Publications". Sun MPI 4.0 is part of the Sun HPC ClusterTools 3.0 suite of software. Jobs can be run using either LSF Suite or the Sun CRE. If you are using LSF Suite, see Platform Computing's documentation and the Sun MPI 4.0 User's Guide: With LSF for more information. If you are using the CRE, see the Sun MPI 4.0 User`s Guide: With CRE for more information. Product notes for Sun MPI are included in Sun HPC ClusterTools 3.0 Product Notes.

Using UNIX® Commands

This document may not contain information on basic UNIX commands and procedures such as shutting down the system, booting the system, and configuring devices.

See one or more of the following for this information:

AnswerBook(TM) online documentation for the Solaris(TM) 2.6 or Solaris 7 software environment

Other software documentation that you received with your system

Typographic Conventions

Table P-1 Typographic Conventions


Typeface	Meaning	Examples
`AaBbCc123`	The names of commands, files, and directories; on-screen computer output	Edit your `.login` file. Use `ls -a` to list all files. `% You have mail`.
`AaBbCc123`	What you type, when contrasted with on-screen computer output	`%` `su` `Password:`
`AaBbCc123`	Book titles, new words or terms, words to be emphasized Command-line variable; replace with a real name or value	Read Chapter 6 in the User's Guide. These are called class options. You must be superuser to do this. To delete a file, type `rm` `filename`.

Shell Prompts

Unless otherwise specified, examples are presented in C-shell syntax.

Table P-2 Shell Prompts


Shell	Prompt
C shell	`machine_name%`
C shell superuser	`machine_name#`
Bourne shell and Korn shell	`$`
Bourne shell and Korn shell superuser	`#`

Related Publications

This book focuses on Sun MPI and assumes familiarity with the MPI standard. The following materials provide useful background about using Sun MPI and about the MPI standard.

Books

Among the documents included with Sun HPC ClusterTools software, you may want to pay particular attention to these:

Application	Title	Part Number
Sun HPC ClusterTools software	Sun HPC ClusterTools 3.0 Product Notes	805-6262-10
Using ClusterTools software with LSF Suite	Sun MPI 4.0 User's Guide: With LSF	805-7230-10
Using ClusterTools software with the CRE	Sun MPI 4.0 User`s Guide: With CRE	806-0296-10
LSF Suite	LSF Batch User's Guide	805-6258-10
LSF Suite	LSF Parallel User's Guide	805-6259-10
LSF Suite	LSF Batch Programmer's Guide	805-6260-10
LSF Suite	LSF Batch User's Quick Reference	805-6522-10

In addition, you may want to consult the Prism(TM) documentation for information on debugging your Sun MPI program, as well as the Sun S3L documentation to learn about using the Sun Scalable Scientific Subroutine Library.

Prism	Prism 6.0 User's Guide	805-6277-10
Prism	Prism 6.0 Reference Manual	805-6278-10
Sun S3L	Sun S3L 3.0 Programming and Reference Guide	805-627`5-`10

These books, which are not provided by Sun, should be available at your local computer bookstore:

Using MPI: Portable Parallel Programming with the Message-Passing Interface, by William Gropp, Ewing Lusk, and Anthony Skjellum (Cambridge: MIT Press, 1994).

MPI: The Complete Reference, by Marc Snir, Steve W. Otto, Steven Huss-Lederman, David W. Walker, and Jack Dongarra (Cambridge: MIT Press, 1995).

Parallel Programming with MPI, by Peter S. Pacheco (San Francisco: Morgan Kaufmann Publishers, Inc., 1997).

Man Pages

Man pages are also available online for all the Sun MPI and MPI I/O routines and are accessible via the Solaris(TM) man command. These man pages are usually installed in /opt/SUNWhpc/man. You may need to ask your system administrator for their location at your site.

On the World Wide Web

There is a wealth of documentation on MPI available on the World Wide Web. Here are a few URLs for Web sites:

The MPI home page, with links to specifications for the MPI-2 standard:

http://www.mpi-forum.org

Additional Web sites that provide links to papers, talks, the standard, implementations, information about MPI-2, plus pointers to many other sources:

http://www.erc.msstate.edu/mpi/

http://www.arc.unm.edu/homepage/TutorialWorkshop.html

Sun Documentation on the Web

The docs.sun.com web site enables you to access Sun technical documentation on the Web. You can browse the docs.sun.com^SM archive or search for a specific book title or subject at:

http://docs.sun.com

Sun Welcomes Your Comments

We are interested in improving our documentation and welcome your comments and suggestions. You can email your comments to us at:

docfeedback@sun.com

Please include the part number of your document in the subject line of your email.