PRISM USER'S GUIDE Version 2.0, April 1994 Copyright (c) 1991-1994 Thinking Machines Corporation. ABOUT THIS MANUAL ***************** Objectives of This Manual ------------------------- This manual explains how to use the Prism programming environment to develop, execute, debug, and analyze the performance of programs on a CM-2, CM-200, or CM-5 Connection Machine system. Intended Audience ----------------- The manual is intended for application programmers developing programs in C, C*, Fortran 77, or CM Fortran. We assume you know the basics of developing and debugging programs, as well as the basics of using a CM. Some familiarity with the UNIX debugger dbx is helpful, but not required. Prism is based on the X and OSF/Motif standards. Familiarity with these standards is also helpful but not required. Revision Information -------------------- This manual has been revised to incorporate changes made for Prism Version 2.0, primarily to support message-passing programs on the CM-5. Organization of This Manual --------------------------- The manual contains these chapters: Chapter 1 Introduction Gives an overview of Prism. Chapter 2 Using Prism Provides general information about using Prism. Chapter 3 Loading and Executing a Program Describes how to load and execute a program in Prism. Chapter 4 Debugging a Program Describes how to use Prism to perform certain basic kinds of debugging, such as setting a breakpoint and tracing program execution. Chapter 5 Printing and Displaying Data Describes how to choose data for printing and display, and how to specify the way in which the data is to be visualized. Chapter 6 Obtaining Performance Data Describes how to collect and interpret performance statistics for your program. Chapter 7 Editing and Compiling Programs Describes how to edit and compile source code using Prism. Chapter 8 Getting Help Describes how to use Prism's on-line help and on-line documentation facilities. Chapter 9 Customizing Prism Describes how to change Prism's behavior to suit your needs and preferences. Chapter 10 Node Prism Describes how to use Node Prism to debug, visualize data in, and analyze the performance of message- passing programs. Appendix A Commands-Only Prism Describes how to use Prism in commands-only mode, without its graphical interface. Appendix B Using Prism with CMAX Describes how to use Prism with programs that have been converted from Fortran 77 to CM Fortran via the CMAX Converter. Appendix C Glossary Defines specialized terms used in the Prism documentation. Related Documents ----------------- Refer to the release notes for last-minute information on Prism. The release notes are available on-line by choosing the Release Notes selection from the Help menu or by issuing the command help release. The Prism Reference Manual provides reference descriptions of all Prism commands. For general information about developing and running programs on a CM-2 or CM-200 series Connection Machine system, consult the CM User's Guide. For information on the CM-5, consult the CM-5 User's Guide. Notation Conventions -------------------- Ctrl-D Simultaneous keystrokes are shown with a connecting hyphen. To type the Ctrl-D combination, for example, press and hold down the Control key, then press the D key. ***************************************************************** The information in this document is subject to change without notice and should not be construed as a commitment by Think- ing Machines Corporation. Thinking Machines reserves the right to make changes to any product described herein. Although the information in this document has been reviewed and is believed to be reliable, Thinking Machines Corporation assumes no liability for errors in this document. Thinking Machines does not assume any liability arising from the application or use of any information or product described herein. ***************************************************************** Connection Machine (r) is a registered trademark of Thinking Machines Corporation. CM, CM-2, CM-200, and CM-5 are trademarks of Thinking Machines Corporation. CMOST, CMAX, and Prism are trademarks of Thinking Machines Corporation. C* (r) is a registered trademark of Thinking Machines Corporation. Paris and CM Fortran are trademarks of Thinking Machines Corporation. CMMD, CMSSL, and CMX11 are trademarks of Thinking Machines Corporation. CMview is a trademark of Thinking Machines Corporation. Thinking Machines (r) is a registered trademark of Thinking Machines Corporation. SPARC and SPARCstation are trademarks of SPARC International, Inc. Sun, Sun-4, and Sun Workstation are trademarks of Sun Microsystems, Inc. UNIX is a trademark of UNIX System Laboratories, Inc. The X Window System is a trademark of the Massachusetts Institute of Technology. OSF and Motif are trademarks of The Open Software Foundation, Inc. Worldview is a trademark of Interleaf, Inc. Copyright (c) 1991-1994 by Thinking Machines Corporation. All rights reserved. This file contains documentation produced by Thinking Machines Corporation. Unauthorized duplication of this documentation is prohibited. Thinking Machines Corporation 245 First Street Cambridge, Massachusetts 02142-1264 (617) 234-1000