Prism Options

This section describes several aspects of using Prism's commands from the Solaris command line.

Loading Programs

If you specify the name of an executable (single process) program on the command line, that program is automatically loaded into Prism. For example,

% prism primes.x 

When you execute the program, it will execute on the node on which Prism is running.

If you are loading a message-passing program, you must specify a number of processes to run, even when the message-passing program runs on a single process. Use the -n option to specify the number of processes. For example,

% prism -n 4 primes.x

See " Methods of Specifying MP Prism Options", for more information about launching MP Prism. See " Loading a Program", for more information about loading a program.

Attaching to a Process

You can also attach to a process or message-passing job that is currently running. However, Prism must run on the same system on which the process is running (or the same cluster on which the job is running).

See " Attaching to a Running Process" for more information about attaching to and detaching from a running serial process or a message-passing job.

Working With a Core File

You can associate a core file with a program. Add the name of the core file after the name of the executable program.

See " Associating a Core File With a Loaded Program" for more information about core files.

Specifying Commands-Only Prism

Use the -C option to bring up Prism in commands-only mode. This allows you to run Prism on a terminal with no graphics capability.

Use the -CX option to bring up a commands-only Prism that lets you redirect the output of certain Prism commands to X windows.

See Appendix A, Commands-Only Prism for information about commands-only Prism.

Specifying X Toolkit Options

You can include most standard X toolkit command-line options when you issue the prism command; for example, you can use the -geometry option to change the size of the main Prism window. See your X documentation for information on these options. Also, note these limitations:

• The -font, -title, and -rv options have no effect.

• The -bg option is overridden in part by the setting of the Prism.textBgColor resource, which specifies the background color for text in Prism; see " Changing Colors".

X toolkit options are ignored if you use -C to run Prism in commands-only mode.

Specifying Input and Output Files

You can use the form

% prism < input-file

to specify a file from which Prism is to read and execute commands upon startup. Similarly, use the form

% prism > log-file

to specify a file to which Prism commands and their output are to be logged.

If you have created a .prisminit initialization file, Prism automatically executes the commands in the file when it starts up. See " Initializing Prism" for information on .prisminit.

To enter MP Prism, issue the prism command with the -n option, specifying the number of client MP Prism processes you want to start. Use the value 0 to specify that you want to run on all available nodes, one process per node.