PTP Preferences
To open the Preferences window, select Window > Preferences...
Then select 'PTP' in the list of preferences pages on the left side.
PTP Preference Page
This is the main preferences page for PTP. These preferences are used primarily to manage the external runtime systems employed by PTP.
- Runtime Systems: These preferences control how PTP interacts with the external parallel environment.
- Control System (default 'Open Runtime Environment'): Selects the external runtime system that will be used for executing and controlling parallel programs
- Monitoring System (default 'Open Runtime Environment'): Selects the type of monitoring system that will be used for monitoring machine, node and process status
- Program output setting: These preferences are used to contol certain behavior relating to the output (stdout) generated by parallel programs
- Output directory (default '/tmp') : Specifies the location of temporary files used to hold program output
- Store line number (default 0) : Not currently used
- Enable Developer
Mode (default disabled) : Enable/disable PTP developer mode. This is used to control access to additional functionality needed by developers for testing or debugging, including the PTP runtime/debug simulator.
If you enable this, you have to restart PTP before the option will take effect.
Debug Preferences Page (PTP>Debug)
This is the main parallel debugger preferences page. These are preferences that apply to any parallel debugger.
- Default setting: 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 (default 60000): this specifices the period Eclipse waits after sending a command to the external debugger. If no response is received the debug session will be terminated.
- Variable :
Indicates how variables are updated when the debugger is suspended.
The debugger allows variable values to be displayed in tooltip popups when the mouse hovers
over a process in the Parallel Debug view, as well as in the Variables View. Enabling the first option will update all the values
each time the process is suspended. Enabling the second option will update the values
when the Job or Process set is changed.
SDM (Scalable Debug Manager) Preferences (PTP > Debug > SDM)
These are
preferences for controlling the behavior of the SDM.
- Debugger lanch preferences: These preference control how the debugger behaves when it is launched.
They do not normally need to be altered.
- SDM client host (default localhost): This specifies the host on which Eclipse is running. It is used to establish communication between the SDM and Eclipse. In situations where a parallel job is being debugged remotely, this should be the host name of the "front end" on which Eclipse is running.
- 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 backend debugger (default empty): This can be used to specify the path to the backend debugger, if it is located in a non standard place. Useful on machines that do not have physical disks or network filesystems on compute nodes.
- SDM executable (default sdm location): The path to the SDM executable. This is normally installed in an Eclipse plugin and is automatically determined.
Open RTE Preferences (PTP>Open RTE)
These are preferences specific to the Open Runtime Environment (Open RTE).
- Open Runtime Environment PTP Proxy Server: Specifies the location
of the Open RTE proxy server executable. This is used to interface to Open RTE
for remote job launch and monitoring of system and job status. This is automatically determined and does not normally need to be changed.
- Launch ORTE server manually (default disabled): Overrides the automatic startup of the Open RTE proxy server. This is mainly used for testing and should not be changed.
Viewer Preferences (PTP>Viewer)
These preferences are used to change the behavior of some of the PTP views. They do not normally need to be altered.
- Tooltip timeout (default 5000): Changes the time the tooltip remains displayed when the mouse hovers over a node or process icon.
Back to Top | Back to Table of Contents