alias c cont

#ifdef MP

pset 0

alias c "cont; wait every"

#endif

To provide this feature, the Prism environment must preprocess the .prisminit file; by default it does not do this.

Change the setting of the Prism resource Prism.cppPath, and specify the path to your C preprocessor as its setting.

Typically, this setting is /lib. Thus, you would set the resource as follows:

Prism.cppPath: /lib

See Changing Prism Environment Defaults for information on setting the Prism environment's resources.

Note, however, that the commands-only mode of the Prism environment is not aware of the settings of Prism resources such as Prism.cppPath, unless the settings are contained in the system-wide Prism app-defaults file.

---

Using the Tear-Off Region

You can place frequently used menu selections and commands in the tear-off region below the menu bar. They become buttons that you can click on to execute functions. FIGURE 8-1 shows the buttons that are in this region by default.

 FIGURE 8-1 Tear-Off Region

Putting menu selections and commands in the tear-off region lets you access them without having to pull down a menu or issue a command from the command line.

Changes you make to the tear-off region are saved when you leave the Prism environment; see Where the Prism Environment Stores Your Changes for more information.

Adding Menu Selections to the Tear-Off Region

You can add menu selections to the tear-off region from either the menu bar or the command line.

Perform one of the following:

• From the menu bar - Enter tear-off mode by choosing Tear-off from the Utilities menu. A dialog box appears that describes tear-off mode; see FIGURE 8-2.

 FIGURE 8-2 Tear-Off Region Dialog Box

While the dialog box is on the screen, choosing any selection from a menu adds a button for this selection to the tear-off region. Clicking a button in the tear-off mode removes that button.

If you fill up the region, you can resize it to accommodate more buttons. To resize the region, drag the small resize box at the bottom right of the region.

Click Close or press the Esc key while the mouse pointer is in the dialog box to close the box and leave tear-off mode.

When you are not in tear-off mode, clicking on a button in the tear-off region has the same effect as choosing the equivalent selection from a menu.

• From the command window - Use the tearoff and untearoff commands from the command window to add menu selections to and remove them from the tear-off region, respectively. Put the selection name in quotation marks. Case does not matter, and you can omit spaces and the ellipsis (...) that indicates the selection displays a window or dialog box. If the selection name is ambiguous, put the menu name in parentheses after the selection name. For example,

(prism all) tearoff "print (events)"

adds a button for the Print selection from the Events menu to the tear-off region.

Adding Prism Commands to the Tear-Off Region

Type

(prism all) pushbutton label command

The label must be a single word. The command can be any valid Prism command, along with its arguments.

For example,

(prism all) pushbutton printa print a on dedicated

adds a button labeled printa to the tear-off region. Clicking on it executes the command print a on dedicated.

---

Creating Aliases for Commands and Variables

The Prism environment provides commands that let you create alternative names for commands, variables, and expressions.

Type

(prism all) alias new-name command

For example,

(prism all) alias ni nexti

makes ni an alias for the nexti command. The Prism environment provides some default aliases for common commands. Issue alias with no arguments to display a list of the current aliases.

Type

(prism all) unalias new-name

For example,

(prism all) unalias ni

removes the alias created above.

Type

(prism all) set variable = expression

For example,

(prism all) set alan = annoyingly_long_array_name

abbreviates the annoyingly long array name to alan. You can use this abbreviation subsequently in your program to refer to this variable. Use the unset command to remove a setting. For example,

(prism all) unset alan

removes the setting created above.

Changes you make via alias and set last for your current Prism session. To make them permanent, you can add the appropriate commands to your .prisminit file, which is described in Initializing the Prism Environment.

---

Changing Prism Resource Defaults

Many aspects of the Prism environment's behavior and appearance -- for example, the colors it displays on color workstations and the fonts it uses for text -- are controlled by the settings of Prism resources. The default settings for many of these resources appear in the file Prism in the X11 app-defaults directory for your system. Your system administrator can change these system-wide defaults. You can override these defaults in two ways:

• For many defaults, you can use the Customize selection from the Utilities menu to display a window in which you can change the settings. This section describes this method.
• A more general method is to add an entry for a resource to your X resource database, as described in the next section. Using the Customize utility is much more convenient, however.

Choose Customize from the Utilities menu.

This displays the window shown in FIGURE 8-3.

 FIGURE 8-3 Customize Window

Changing a Resource Setting

On the left of the Customize window are the names of the resources. Next to each resource is a text-entry box that contains the resource's setting (if any). To the right of the fields are Help buttons. Clicking on a Help button or anywhere in the text-entry field displays help about the associated resource in the box at the top of the window.

Perform one of the following:

• For Edit Geometry, Menu Threshold, Text Font, and Visualizer Color File, enter the setting in the resource's text-entry box.
• For Editor, Error Window, and Make, left-click on the button labeled with the resource's name. This displays a menu of choices for the resource. Clicking on one of these choices displays it in the resource's text-entry box. For Editor and Make, you can also enter the setting directly in the text-entry box.
• For Error Bell, Procedure Menu, Mark Stale Data, and Use Xterm, there are only two possible settings, true and false; clicking on the button labeled with the resource's name toggles the current setting.

Whenever you make a change in a text-entry box, Apply and Cancel buttons appear to the right of it. Click on Apply to save the new setting; it takes effect immediately. Click on Cancel to cancel it; the setting changes back to its previous value.

Click on Close or press the Esc key.

Resource Descriptions

The following list summarizes the X Windows system resources that can be modified through the Customize window.

• Edit Geometry - Use this resource to specify the X geometry string for the editor created by the Edit and Email selections from the Utilities menu. The geometry string specifies the number of columns and rows and, optionally, the left and right offsets from the corner of the screen. The Prism environment's default is 80x24 (that is, 80 rows and 24 columns). See your X documentation for more information on X geometries.
• Editor - Use this resource to specify the editor that the Prism environment is to invoke when you choose the Edit selection from the Utilities menu. Click on the Editor box to display a menu of possible choices. If you leave this field blank, the Prism environment uses the setting of your EDITOR environment variable to determine which editor to use.
• Error Bell - Use this resource to specify how the Prism environment is to signal errors. Choosing true tells the Prism environment to ring the bell of your workstation. Choose false to have the Prism environment flash the screen instead; this is the Prism environment's default.
• Error Window - Use this resource to tell the Prism environment where to display the Prism environment's error messages. Choose command to display them in the command window; this is the Prism environment's default. Choose dedicated to send the messages to a dedicated window; the window is updated each time a new message is received. Choose snapshot to send each message to a separate window.
• Make - Use this resource to tell the Prism environment which make utility to use when you choose the Make selection from the Utilities menu. The Prism environment's default is the standard Solaris make utility, /usr/ccs/bin/make. Click on the Make box to display a menu of possible choices.
• Mark Stale Data - Use this resource to tell the Prism environment whether to mark stale data with distinctive stripes. Choose true (the default) to have the Prism environment draw diagonal lines over the data; choose false to leave the visualizer's appearance unchanged.
• Procedure Menu - Use this resource to specify whether a menu is to be displayed when you set a breakpoint in a Fortran 90 generic procedure. If you choose true (the default), a menu of possible procedures is displayed. You can then choose the procedure(s) in which the breakpoint is to be set. Choose false if you want breakpoints to be set automatically in all the generic procedures.
• Menu Threshold - Use this resource to specify the maximum number of procedures that are to be displayed in a menu when you perform an action on a Fortran 90 generic procedure, such as setting a breakpoint. The default is 22. Enter 0 to indicate that there should be no maximum. If the number of procedures exceeds the specified threshold, you are prompted to either enter the procedure name or display the menu.
• Text Font - Use this resource to specify the name of the X font that the Prism environment is to use for histogram labels and text in visualizers. The default, 8x13, is a 12-point fixed-width font. To list the fonts available on your system, issue the Solaris command xlsfonts. Specifying a font much larger than the default can cause display problems, because the Prism environment doesn't resize windows and buttons to accommodate the larger font.
• Use Xterm - Use this resource to tell the Prism environment what to do with the program's I/O. Specify true (the Prism environment default) to tell the Prism environment to create an Xterm in which to display the I/O. Specify false to send the I/O to the Xterm from which you started the Prism environment.
• Visualizer Color File - Use this resource to tell the Prism environment the name of a file that specifies the colors to be used in colormap visualizers. If you leave this field blank, the Prism environment uses gray for elements whose values are not in the context you specify. For elements whose values are in the context, it uses black for values below the minimum, white for values above the maximum, and a smooth spectral map from blue to red for all other values.
• Default Visualizer - Use this resource to tell the Prism environment which representation you want to use as your initial representation when you display data in a visualizer. If you leave this field blank, the Prism environment uses Text for the initial representation.

If you specify a visualizer color file, that file must be in ASCII format. Each line of the file must contain three integers between 0 and 255 that specify the red, green, and blue components of a color.

The first line of the visualizer color file must contain the color that is to be displayed for values that fall below the minimum you specify in creating the visualizer. The next-to-last line must contain the color for values that exceed the maximum. The last line must contain the color used to display the values of elements that are not in the context specified by the user in a where statement. The Prism environment uses the colors in between to display the values falling between the minimum and the maximum. See TABLE 8-1 for an example.

Like the default settings, this file specifies black for values below the minimum, white for values above the maximum, and gray for values outside the context. But the file reverses the default spectral map for other values: from lowest to highest, values are mapped red-yellow-green-cyan-blue-magenta.

Where the Prism Environment Stores Your Changes

The Prism environment maintains a file called .prism_defaults in your home directory. In it, the Prism environment keeps:

• Changes you make to the Prism environment via the Customize utility
• Changes you make to the tear-off region
• Changes you make to the size of the panes within the main Prism window

Do not attempt to edit this file; make all changes to it through the Prism environment itself. If you remove this file, you get the default configuration the next time you start the Prism environment.

---

Changing Prism Environment Defaults

As mentioned in the previous section, you can change the settings of many Prism resources either by using the Customize utility or by adding them to your X resource database. This section describes how to add a Prism resource to your X resource database.

An entry in the X resource database has the form:

resource-name: value

where resource-name is the name of the Prism resource, and value is the value to which it is set. TABLE 8-2 lists the Prism resources.

Note that the defaults mentioned in the following sections are the defaults for the Prism environment as it was shipped; your system administrator may have changed these in the Prism environment's file in your system's app-defaults directory.

Note also that the commands-only mode of the Prism environment is not aware of the settings of any Prism resources, unless they are contained in the Prism environment's app-defaults file. This matters only for the resource Prism.cppPath.

Adding Prism Resources to the X Resource Database

The X resource database keeps track of default settings for programs running under X. Use the xrdb program to add a Prism resource to this database.

Perform one of the following:

• Use the -merge option to specify the resource and its setting from the standard input. For example, type the following command to specify a default editor:

% xrdb -merge Prism.editor: emacs

• Put resource settings in a file, then merge the file into the database. For example, if your changes are in prism.defs, you could issue this command:

% xrdb -merge prism.defs

Press the Ctrl-D keys.

Consult your X documentation for more information about xrdb.

Specifying the Editor and Its Placement

Change the following:

• The setting of the Prism.editor resource

This resource specifies which editor is to be invoked when you choose Edit from the Utilities menu or issue the corresponding command.

• The setting of the Prism.editGeometry resource

This resource specifies the X geometry string to the selected editor. The geometry string specifies the number of columns and rows and the left and right offsets from the corner of the screen.

You can also change the settings of these resources using the Customize window; see Changing Prism Resource Defaults for more information.

Specifying the Window for Error Messages

Change the setting of the Prism.errorwin resource.

This resource specifies the window the Prism environment is to use for error messages. The predefined values are command, dedicated, and snapshot. You can also specify your own name for the window.

You can also change the setting of this resource via the Customize utility; see Changing Prism Resource Defaults for more information.

Changing the Text Fonts

You may need to change the fonts that the Prism environment uses. This will be necessary, for example, if the default fonts used by the Prism environment are not available on your system. Use the resources described below to make this change.

Type

% xlsfonts

You should try to substitute a font that is about the same size as the default value of the Prism environment. Substituting a font that is much larger can cause display problems, since the Prism environment does not resize windows and buttons to accommodate larger fonts.

Edit the Prism.textFont resource.

This setting specifies the resource that the Prism environment is to use in displaying the labels of histograms and text in visualizers. By default, the Prism environment uses a 12-point, fixed-width font for this text.

You can also change the setting of this resource via the Customize utility; see Changing Prism Resource Defaults for more information.

Change the setting of the Prism*XmText.fontList resource.

This setting specifies the font used for most of the running text in the Prism environment, such as code in the source window. By default, the Prism environment uses a 12-point, fixed-width font for this text.

Change the setting of the Prism*fontList resource.

This setting specifies the font used for everything else, such as menu selections, pushbuttons, and list items. By default, the Prism environment uses a 14-point Helvetica font for this text.

Changing Colors

The Prism environment provides several resources for changing the default colors it uses when running on a color workstation.

Change the setting of the Prism.vizColormap resource.

This setting specifies a file containing the colors to be used. You can also change the setting of this resource via the Customize utility; see Changing Prism Resource Defaults. See Resource Descriptions for a discussion of how to create a visualizer color file.

Change the setting of the Prism.spectralMapSize resource.

This setting specifies how large the default spectral color map is to be for colormap visualizers. The default is 100 entries. If this many entries causes problems on your workstation, use this resource to specify fewer entries. To set the default to 50, for example, set the resource in your X resource database as follows:

Prism.spectralMapSize: 50

Change the setting of the Prism.dialogColor resource.

This setting specifies the background color of dialog boxes.

Change the setting of the Prism.textBgColor resource.

This setting specifies the background color for text in buttons, dialog boxes, and so on. Note that this setting overrides the setting of the X toolkit -bg option.

Change the setting of the Prism.textMasterColor resource.

This setting specifies the color used to highlight the master pane when the source window is split.

Change the setting of the Prism.graphFillColor resource.

This setting specifies the interior fill color for objects in graphics windows that have 3-D shadow borders.

Change the setting of the Prism.graphBGColor resource.

This setting specifies the background color of all graphics windows, such as the structure browser, Where graph, and visualizer.

Change the setting of the Prism.mainColor resource.

This setting specfies the color used for just about everything else.

The defaults are:

Prism.dialogColor: Thistle Prism.textBgColor: snow2 Prism.textMasterColor: black Prism.graphFillColor: grey Prism.graphBGColor: light grey Prism.mainColor: light sea green

Changing the Colors of MPI Communicators in the MPI Queue Visualizer

Change the setting of the Prism.comm1Color resource.

This setting specfies the color of the first communicator displayed in the MPI queue visualizer.

Change the setting of the Prism.comm2Color resource.

This setting specifies the color of the second communicator displayed in the MPI queue visualizer.

Change the setting of the Prism.comm3Color resource.

This setting specifies the color of the third communicator displayed in the MPI queue visualizer.

Change the setting of the Prism.commOtherColor resource.

This setting specifies the color of the fourth communicator displayed in the MPI queue visualizer.

The defaults are:

Prism.comm1Color: chartreuse2 Prism.comm2Color: cyan2 Prism.comm3Color: magenta2 Prism.commOtherColor: purple

Changing Keyboard Translations

You can change the keys and key combinations that the Prism environment translates into various actions. In general, doing this requires an understanding of X and Motif programming. You may be able to make some changes, however, by reading this section and studying the defaults in the Prism environment's file in your system's app-defaults directory.

Changing Keyboard Translations in Text Widgets

To Change Keyboard Translations for Dialog Boxes With a Single Text Field

Change the settings of the Prism.textOneFieldTranslations resource.

This controls default keyboard translations for dialog boxes that contain only one text field. Its default definition is:

Prism.textOneFieldTranslations: <Key>osfDelete: delete-previous-character() <Key>osfBackSpace: delete-previous-character() Ctrl<Key>u: erase_to_beginning() Ctrl<Key>k: erase_to_end() Ctrl<Key>d: delete_char_at_cursor_position() ctrl<Key>f: move_cursor_to_next_char() Ctrl<Key>h: move_cursor_to_prev_char() Ctrl<Key>b: move_cursor_to_prev_char() Ctrl<Key>a: move_cursor_to_beginning_of_text() Ctrl<Key>e: move_cursor_to_end_of_text()

The definitions with osf in them are special Motif keyboard symbols.

To Change Keyboard Translations for Dialog Boxes With Several Text Fields

Change the settings in the Prism.textManyFieldTranslations resource.

Its default definition is:

Prism.textManyFieldTranslations: <Key>osfDelete: delete-previous-character() <Key>osfBackSpace: delete-previous-character() <Key>Return: next-tab-group() <Key>KP_Enter: next-tab-group() Ctrl<Key>u: erase_to_beginning() Ctrl<Key>k: erase_to_end() Ctrl<Key>d: delete_char_at_cursor_position() Ctrl<Key>f: move_cursor_to_next_char() Ctrl<Key>h: move_cursor_to_prev_char() Ctrl<Key>b: move_cursor_to_prev_char() Ctrl<Key>a: move_cursor_to_beginning_of_text() Ctrl<Key>e: move_cursor_to_end_of_text()

If you make a change to any field in one of these resources, you must copy all the definitions.

Changing General Motif Keyboard Translations

The Prism environment uses the standard Motif translations that define the general mappings of functions to keys. They are shown below.

*defaultVirtualBindings: osfActivate : <Key>Return osfAddMode : Shift <Key>F8 osfBackSpace : <Key>BackSpace osfBeginLine : <Key>Home osfClear : <Key>Clear osfDelete : <Key>Delete osfDown : <Key>Down osfEndLine : <Key>End osfCancel : <Key>Escape osfHelp : <Key>F1 osfInsert : <Key>Insert osfLeft : <Key>Left osfMenu : <Key>F4 osfMenuBar : <Key>F10 osfPageDown : <Key>Next osfPageUp : <Key>Prior osfRight : <Key>Right osfSelect : <Key>Select osfUndo: <Key>Undo osfUp : <Key>Up

To Change a General Motif Keyboard Translation

Change its entry in the *defaultVirtualBindings resource.

For example, if your keyboard does not have an F10 key, you could edit the osfMenuBar line and substitute another function key.

Note the following points in changing this resource:

• All entries in the resource must be included in your resource database if you want to change any of them. Otherwise, the omitted entries are undefined.
• The entries in this resource apply to all Motif-based applications. If you want your changes to apply only to the Prism environment, change the first line of the resource to Prism*defaultVirtualBindings.

Changing Xterm Use With I/O

By default, the Prism environment creates a new Xterm for input to and output from a program.

To Prevent the Prism Environment From Creating New I/O Windows

Set the Prism.useXterm resource to false.

This setting causes I/O to go to the Xterm from which you invoked the Prism environment. You can also change the setting of this resource via the Customize utility; see Changing Prism Resource Defaults.

Changing the Way the Prism Environment Signals an Error

By default, the Prism environment flashes the command window when there is an error. You can, instead, use the bell for signaling errors.

To Force the Prism Environment to Ring the Bell on Errors

Perform one of the following:

• Set the resource Prism.errorBell to true.
• Change the setting of the Prism.errorBell resource using the Customize utility; see Changing Prism Resource Defaults.

Changing the make Utility to Use

By default, the Prism environment uses the standard Solaris /usr/ccs/bin/make utility. You can use a different make utility by changing the setting of the Prism.make resource.

To Specify an Alternative Make Utility

Perform one of the following:

• Change the setting of the resource Prism.make.

This resource specifies the path name of another version of make to use.

• Change the setting of the Prism.make resource using the Customize utility; see Changing Prism Resource Defaults.

Changing How the Prism Environment Treats Stale Data in Visualizers

By default, the Prism environment prints diagonal lines over stale data in visualizers. Data are considered stale when the program has continued execution beyond the spot where the data were collected.

To Prevent the Prism Environment From Depicting Stale Data With Diagonal Lines

Perform one of the following:

• Change the setting of the resource Prism.markStaleData to false.
• Change the setting of the Prism.markStaleData resource using the Customize utility; see Changing Prism Resource Defaults.

Specifying a Different Browser for Displaying Help

There are several resources you can use to affect the way help is displayed.

By default, the graphical mode of the Prism environment uses the Netscape browser to display help information; see Using the Browser-Based Help System.

To Specify an Alternative HTML Browser for Displaying Online Help

Set the Prism.helpBrowser resource to the executable name of the other browser.

The name of the browser must be on your path. The graphical mode of the Prism environment supports HTML browsers, such as Netscape. You can include in the setting any browser-specific options that you want passed to the browser when the Prism environment starts it up.

These options do not take effect if the Prism environment uses an existing browser. If you already have a browser running when you request help from the Prism environment, the Prism environment displays the help information in this browser.

To Force the Prism Environment to Start a New Help Browser

Set the resource Prism.helpUseExisting to false.

This forces the Prism environment to start a new browser.

To restore the default behavior, set Prism.helpUseExisting to true.

Changing the Way the Prism Environment Handles Fortran 90 Generic Procedures

There are two resources you can use to change the way the Prism environment handles Fortran 90 generic procedures.

By default, the Prism environment displays a menu (in the commands-only mode of the Prism environment) or a dialog box when you attempt to set a breakpoint in a Fortran 90 generic procedure.

To Suppress the Display of Menus or Dialog Boxes When Setting Breakpoints in Fortran 90 Generic Procedures

Perform one of the following:

• Change the setting of the Prism resource Prism.procMenu to false.

This setting specifies that the Prism environment is to set the breakpoint in every one of these procedures, without displaying a menu or dialog box.

• Change the setting of the resource Prism.procMenu using the Customize utility; see Changing Prism Resource Defaults.

By default, the commands-only interface of the Prism environment displays a maximum of 22 procedures on a menu when you attempt to perform an action (like setting a breakpoint) on a Fortran 90 generic procedure. If there are more than this number of specific procedures, the Prism environment asks you whether you want to specify the name of a specific procedure or to view a menu.

To Display a Different Maximum Number of Fortran 90 Generic Procedures

Change the setting of the Prism.procThresh resource.

This specifies a different maximum number of procedures. Set the resource to 0 (zero) to specify that there is to be no maximum.

Prism 7.0 Software User's Guide

817-0088-10

Copyright © 2002, Sun Microsystems, Inc. All rights reserved.