test

Prism 6.0 User's Guide

Before Entering Prism

This section describes the programming conditions under which you can make use of Prism's features.

Supported Languages and Compilers

You can work on Sun Fortran, C, and C++ programs within Prism. However, support for debugging Fortran 90 and C++ programs is limited. For information on the specifics of Prism support for Fortran 90 and C++, see "C++ Support in Prism 6.0".

Prism supports these compilers in Sun(TM) HPC ClusterTools 3.0:

Compiling and Linking Your Program

To use Prism's debugging features, compile and link each program module with the -g compiler option to produce the necessary debugging information.

Note -

The -g option overrides certain optimizations. For example, in C++ the -g option turns on debugging and turns off inlining of functions. The -g0 (zero) option turns on debugging and does not affect inlining of functions. You cannot debug inline functions with this option. For another example, in Fortran 77 the -g conflicts with the -auto-inlining and -depend options.

Combining Compiler Options

If you compile programs with both the debugging option -g and an optimization option such as -xO[1,2,3,4,5], the combined options change the behavior of several Prism commands. For information about the effects of combining the debug option with optimization options, see "Combining Debug and Optimization Options".

Setting Up Your Environment

To enter the Prism programming environment, you must be logged in to a terminal or workstation running OpenWindows or the Common Desktop Environment (CDE).

DISPLAY Variable

Make sure that your DISPLAY environment variable is set for the terminal or workstation from which you are running OpenWindows or CDE. For example, if your workstation is named valhalla, you can issue this command (if you are running the C shell):

% setenv DISPLAY valhalla:0

PATH Variable

Sun HPC ClusterTools 3.0 requires that two directories be set in your PATH variable. The default locations of the two directories are:

/opt/SUNWhpc/bin
/opt/SUNWlsf/bin

PRISM_BROWSER_SCRIPT Variable

Prism uses the default HTML browser on your system to display Prism online help. If launching a browser at a prompt in your local environment calls up a script rather than invoking the browser directly, you must set the environment variable PRISM_BROWSER_SCRIPT to yes before starting Prism:

% setenv PRISM_BROWSER_SCRIPT yes

If you do not set this variable in this situation, once the Prism help system responds the browser may be brought up but may halt without displaying any help entries.

For information about the configuration of Sun HPC ClusterTools 3.0 at your location, see your Sun HPC ClusterTools 3.0 system administrator.