# Preferences

Topics include:

- Opening Preferences
- Parallel Tools Preferences

- Debug Preferences
- External Tools Framework (ETFw) Preferences
- GEM Preferences
- Launch Preferences
- Monitoring Preferences
- PLDT Preferences
- Target Configurations Preferences

- Remote Development Preferences

- Connections
- Remote Shell
- Remote Tools
- Service Configurations
- Synchronized Projects

Please see the online documentation for additional preferences information for other features.

## Opening Preferences

To open the Preferences dialog, select:

- Window > Preferences... for Windows and Linux

- Eclipse > Preferences... for MacOS X

Next, expand Parallel Tools and Remote Development in the list of preferences pages on the left side and choose the component's preferences you wish to change. (You may see different items depending on which optional features you have installed.)

## Parallel Tools Preference Page

This is the main preferences parent page for PTP. Available preferences are in the items beneath it. Expand the tree to view these.

## Debug Preferences Page (Parallel Tools > Debug)

This is the main parallel debugger preferences page. These are preferences that apply to any parallel debugger.

#### Default settings

These preferences control some debugger default behavior

Show full paths on breakpoint (default disabled)
  Use the full path to the source file when displayed in the debugger Breakpoint view
Register process 0 by default (default enabled)
  Will register process 0 with the Debug view when the parallel debugger starts. This is required to enable Eclipse to switch automatically to the PTP Debug perspective when a debugger breakpoint is hit.

#### Communication

These are preferences relating to the communication between Eclipse and the external parallel debugger. They do not normally need to be changed.

Command timeout (ms) (default 60000)
  This specifies the period Eclipse waits after sending a command to the external debugger. If no response is received the debug session will be terminated.

#### Variable

These variables control the action of the debugger to update variable information.

The debugger is suspended (default enabled)
  The debugger allows variable values to be displayed in tooltip popups when the mouse hovers over a process in the Parallel Debug view. Enabling this option will update all the values each time the process is suspended. When this option is disabled, the value will be updated when the tooltip popup is displayed.
Job or Set is changed (default disabled)
  Variable values will be updated when the current job or set is changed.

### SDM (Scalable Debug Manager) Preferences (Parallel Tools > Debug > SDM)

These are preferences for controlling the behavior of the scalable debug manager, which is the server component of the parallel debugger. They do not normally need to be changed.

### Debugger launch preferences

These preferences control how the debugger behaves when it is launched. They do not normally need to be altered.

Backend debugger (default gdb-mi)
  The name of the backend debugger to use when debugging the application. This is an internal name known by the SDM, not the name of the debugger itself. Currently only gdb using the MI mode is supported.
Path to gdb executable (default empty)
  If the backend debugger (e.g. gdb) is not located in a standard directory then this field can be used to specify an alternate location.
Path to SDM executable (default empty)
  Sets the preferred path to the SDM executable. This will be used to populate the Debug tab on the launch configuration.

### SDM tracing options

These preference allow the SDM operation to be traced. They are normally only used by PTP developers.

Enable SDM tracing
  This turns on tracing of the SDM. Additional options can be set to control the type and amount of tracing information that is generated.

## External Tools Preferences Page (Parallel Tools > External Tools)

This is a category for configuring external tools that are provided using the ETFw extensions. The contents may vary based on which (optional) ETFw features you have installed For more information see the ETFw wiki page.

### External Tool Configuration

These preferences are used to configure ETFw

External Tool Parser (default jaxb-parser)
  This option selects between the SAX workflow parser and the JAXB workflow parser which supports newer xml tool definitions.
Tool Definition File (default empty)
  The name of a file containing the ETFw XML configuration.

## Feedback View (Parallel Tools > External Tools > Feedback View)

The Feedback view preferences page handles cases where extensions are installed that utilize the Feedback view.

### Preferences for Feedback View

These preferences are used to configure the feedback view. See Feedback view for more information.

## Graphical Environment for MPI (GEM)

GEM is an optional feature of PTP. See the help for GEM including information about GEM Preferences

## Launch

Allows configuration of perspective that automatically opens on a run and debug launch of a parallel application.

## Monitoring

Provides some options for the System Monitoring Perspective

## Target Configurations

## Parallel Language Development Tools (PLDT) Preferences

See the help for PLDT

## Remote Development Preferences

The main page for Remote Development preferences allows specification of a default Remote Services provider. The default provider is used whenever new services are created - for example, new connections to remote machines.

The choices are:

- None - in this case, a choice of Remote Services provider is requested in each case where it is needed (e.g. specifying a new connection)
- Built-in SSH (default, recommended)
- Remote System Environment (RSE)
- Remote Tools

### Connections

On the Connections page, connections can be added (created), edited (changed), removed, opened (started) and closed (stopped). Current connections for the selected Remote Service Provider (Built-in SSH, Remote Tools, or RSE) are shown. Note that a connection cannot be edited or removed when it is open. To edit or remove a connection, stop it first.

### Remote Shell Preferences

### Remote Tools Preferences

Default values for remote hosts created using Remote Tools.

### Service Configurations Preferences

Service configurations are used to persist information about RDT remote projects. The service configuration preference page is only intended for developers and should only be used if you understand what you are doing.

### Synchronized Projects Preferences

### File Filtering

The preferences page for Synchronized projects > File Filtering includes setting defaults for file filtering. This allows files matching certain patterns to be excluded (or included) from the file synchronization. For example, you may want to add "*.o" as an exclude filter to not have object files sync'd back to the local file system after a compile creates them on the remote target. You may also want to add the executable that your project creates to be excluded. Besides changing the default filtering here, you can modify File Filtering on each project as well.

Git is used in synchronized projects implementation. If Git is not available in your path on the remote machine, it can be specified here. Specify the connection for each Git Binary Location you want to change.

Back to Top | Back to Table of Contents