Guide and Reference

About This Book

The IBM Parallel Engineering and Scientific Subroutine Library (Parallel ESSL) is a set of high-performance mathematical subroutines. This book applies to Parallel ESSL for AIX.

This book is a guide and reference manual for use in doing application programming in Fortran, C, C++, and High Performance Fortran (HPF). It includes:

• An overview of Parallel ESSL and guidance information for coding and running your program, as well as using error handling

• Reference information for coding each subroutine calling sequence

This book is meant to be used in conjunction with the ESSL Version 3 Guide and Reference. Where information is identical between Parallel ESSL and ESSL for AIX, such as matrix storage modes, this book references the appropriate section of the ESSL Version 3 Guide and Reference.

This book is written for a wide class of users: scientists, mathematicians, engineers, statisticians, computer scientists, and system programmers. It assumes a basic knowledge of mathematics, Single Program Multiple Data (SPMD) parallel processing concepts and familiarity with Fortran, C, C++, or HPF.

How to Use This Book

Front Matter consists of the Table of Contents, Special Notices, and Preface. Use these to find or interpret information in the book.

Part 1. "Guide Information" provides guidance information for using Parallel ESSL.

• Chapter 1, "Overview, Requirements, and List of Subroutines" gives an overview of Parallel ESSL and lists required hardware and software products. Read this chapter first to determine the aspects of Parallel ESSL you want to use.

• Chapter 2, "Distributing Your Data" describes how to distribute your data across processes for various types of data structures: vectors, matrices, and sequences. Use this information when designing and coding your program.

• Chapter 3, "Coding and Running Your Program" explains coding requirements for calling Parallel ESSL from Fortran, C, C++, and HPF programs, performance coding tips, and how to run your program in the Parallel Environment. Use this information when coding or running your program.

• Chapter 4, "Migrating Your Program" describes how to migrate your program to Parallel ESSL. Use this information when updating your program for a new release of Parallel ESSL or when moving from ScaLAPACK to Parallel ESSL.

• Chapter 5, "Using Error Handling" describes how to use error handling in Parallel ESSL to retrieve information about errors that occur in your program and diagnose problems. Use this information when designing and coding your program as well as diagnosing your problems.

Part 2. "Reference Information (Message Passing)" provides reference information you need to code calling sequences for the Parallel ESSL message passing subroutines. Each chapter contains an introduction and subroutine descriptions. To understand the information in the subroutine descriptions, see "Interpreting the Subroutine Descriptions". Use the appropriate chapter when coding your program:

• Chapter 6, "Level 2 PBLAS (Message Passing)"

• Chapter 7, "Level 3 PBLAS (Message Passing)"

• Chapter 8, "Linear Algebraic Equations (Message Passing)"

• Chapter 9, "Eigensystem Analysis and Singular Value Analysis (Message Passing)"

• Chapter 10, "Fourier Transforms (Message Passing)"

• Chapter 11, "Random Number Generation (Message Passing)"

• Chapter 12, "Utilities (Message Passing)"

Part 3. "Reference Information (HPF)" provides reference information you need to code Parallel ESSL calling sequences in an HPF program. Each chapter contains an introduction and subroutine descriptions. To understand the information in the subroutine descriptions, see "Interpreting the Subroutine Descriptions". Use the appropriate chapter when coding your program:

• Chapter 13, "PBLAS (HPF)"

• Chapter 14, "Linear Algebraic Equations (HPF)"

• Chapter 15, "Eigensystem Analysis and Singular Value Analysis (HPF)"

• Chapter 16, "Fourier Transforms (HPF)"

• Chapter 17, "Random Number Generation (HPF)"

Appendix A. Basic Linear Algebra Communication Subprograms (BLACS) Quick Reference Guide provides a list of calling sequences for the BLACS subroutines.

Appendix B. Sample Programs contains a sample message passing Fortran 90 and a sample HPF application program, both using Parallel ESSL. It also contains sample message passing application programs using the Fortran 90 and Fortran 77 sparse linear algebraic equation subroutines.

Glossary contains definitions of terms used in this book.

Bibliography provides information about publications related to Parallel ESSL. Use it to identify and order publications with supporting information.