This book describes the facilities and tools for the IBM Parallel Environment (PE) for AIX program product and how to use them to debug and analyze parallel programs. It describes the various PE tools for debugging parallel programs and visualizing a program's performance.
This book concentrates on the actual commands, graphical user interfaces, and use of these tools as opposed to the writing of parallel programs. For this reason, you should use this book in conjunction with IBM Parallel Environment for AIX: MPI Programming and Subroutine Reference, (GC23-3894) and IBM Parallel Environment for AIX: MPL Programming and Subroutine Reference (GC23-3893).
This book assumes that AIX Version 4.3.2 or later, X-Windows**, and the PE software are already installed. It also assumes that you have been authorized to run the Parallel Operating Environment (POE). The PE software is designed to run on an IBM RS/6000 SP, an RS/6000 network cluster, or on a mixed system where additional RS/6000 processors supplement an SP system. For complete information on installing the PE software and setting up users, see IBM Parallel Environment for AIX: Installation, (GC23-3892). Also, see the appropriate AIX 4.3.2 or later documentation listed under "Related Publications". For information on POE and executing parallel programs, see IBM Parallel Environment for AIX: Operation and Use, Volume 1, Using the Parallel Operating Environment and IBM Parallel Environment for AIX: Hitchhiker's Guide
This book is designed primarily for end users and application developers. It is also intended for those who run parallel programs, and some of the information and tools covered should interest system administrators. Readers should have some experience with graphical user interface concepts such as windows, pull-down menus, and menu bars. They should also have knowledge of the AIX operating system and the X-Window system. Where necessary, this book provides some background information relating to these areas. More commonly, this book refers you to the appropriate documentation.
This book contains the following information:
This book uses the following typographic conventions:
|Type Style||Used For|
|bold||Bold words or characters represent system elements that you
must use literally, such as command names, flag names, and path names.
Bold words also indicate the first use of a term included in the glossary.
|italic||Italic words or characters represent variable values that you
Italics are also used for book titles and for general emphasis in text.
|Constant width||Examples and information that the system displays appear in constant width typeface.|
In addition to the highlighting conventions, this manual uses the following conventions when describing how to perform tasks. User actions appear in uppercase boldface type. For example, if the action is to enter the pedb command, this manual presents the instruction as:
The symbol "*" indicates the system response to an action. So the system's response to entering the pedb command would read:
As an alternative to ordering the individual books, you can use SBOF-8588 to order the entire IBM Parallel Environment for AIX library.
For National Language Support (NLS), all PE components and tools display messages located in externalized message catalogs. English versions of the message catalogs are shipped with the PE program product, but your site may be using its own translated message catalogs. The AIX environment variable NLSPATH is used by the various PE components to find the appropriate message catalog. NLSPATH specifies a list of directories to search for message catalogs. The directories are searched, in the order listed, to locate the message catalog. In resolving the path to the message catalog, NLSPATH is affected by the values of the environment variables LC_MESSAGES and LANG. If you get an error saying that a message catalog is not found, and want the default message catalog:
The PE message catalogs are in English, and are located in the following directories:
If your site is using its own translations of the message catalogs, consult your system administrator for the appropriate value of NLSPATH or LANG. For additional information on NLS and message catalogs, see IBM Parallel Environment for AIX: Messages and AIX for RS/6000: General Programming Concepts.
In order to use the PE man pages or access the PE online (HTML) publications, the ppe.pedocs file set must first be installed. To view the PE online publications, you also need access to an HTML document browser such as Netscape. An index to the HTML files that are provided with the ppe.pedocs file set is installed in the /usr/lpp/ppe.pedocs/html directory.
If you have a question about the SP, PSSP, or a related product, the following online information resources make it easy to find the information:
If you have the Resource Center on CD ROM, see the readme.txt file for information on how to run it.
All of the PE books are available in Portable Document Format (PDF). They are included on the product media (tape or CD ROM), and are part of the ppe.pedocs file set. If you have a question about the location of the PE softcopy books, see your System Administrator.
To view the PE PDF publications, you need access to the Adobe Acrobat Reader 3.0.1. The Acrobat Reader is shipped with the AIX Version 4.3 Bonus Pack and is also freely available for downloading from the Adobe web site at URL http://www.adobe.com.
As stated above, you can also view or download the PE books from the IBM RS/6000 web site at http://www.rs6000.ibm.com. At the time this manual was published, the full path was http://www.rs6000.ibm.com/resource/aix_resource/sp_books. However, note that the structure of the RS/6000 web site can change over time.