core/org.eclipse.ptp.doc.user/html/07ptpPrefs.html - ptp/org.eclipse.ptp - Git at Google

 <html>
 <head>
 <title>Preferences</title>
 <link rel="stylesheet" type="text/css" href="help.css">
 <script type="text/javascript" src="thumb.js"> </script>
 </head>
 <body>

 <h1>Preferences</h1>
 <p>Topics include:</p>
 <ul>
 	<li><a href="#open">Opening PTP Preferences</li>
 	<li><a href="#main">Main Parallel Tools Preferences </li>
 	<li><a href="#debug">Debug Preferences  </li>
 	<ul>
 		<li><a href="#sdm">SDM (Scalable Debug Manager) Preferences</a></li>
 	</ul>
 	<li><a href="#external">External Tools Framework (ETFw) Preferences</a></li>
 	<li><a href="#pldt">PLDT</a></li>

 	<li><a href="#rm">Resource Manager Preferences</a></li>
 	<li><a href="#viewer">PTP Viewer Preferences</a></li>
 	<li><a href="#service">Service Configurations Preferences </a></li>
 </ul>
 <h2 id="open">Opening the PTP Preferences</h2>
 <p>To open the <b>Preferences dialog</b>, select:</p>
 <ul>
 	<li>
 	<p><b>Window &gt; Preferences...</b> for Windows and Linux</p>
 	</li>
 	<li>
 	<p><b>Eclipse &gt; Preferences...</b> for MacOS X</p>
 	</li>
 </ul>

 <p>Next, expand <b>Parallel Tools</b> in the list of preferences
 pages on the left side and choose the component's preferences you wish
 to change. The following image shows all available components:</p>

 <p><img src="images/07prefsAll.png"></p>

 <h2 id="main"><a name="run"></a>Parallel Tools Preference Page</h2>
 <p>This is the main preferences page for PTP. Available preferences
 are:</p>
 <dl>
 	<dt><b>Temporary output directory</b></dt>
 	<dd>Temporary directory to use to save process output</dd>
 	<dt><b>Console buffer size (lines)</b></dt>
 	<dd>Number of lines of output from each process to save (0 means
 	infinite)</dd>
 </dl>

 <h2 id="debug">Debug Preferences Page (Parallel Tools &gt; Debug)</h2>
 <p>This is the main parallel debugger preferences page. These are
 preferences that apply to any parallel debugger.</p>
 <p><img src="images/07prefsDebug.png"></p>

 <h3>Default setting</h3>
 <p>These preferences control some debugger default behavior</p>
 <dl>
 	<dt><b>Show full paths on breakpoint</b> (default disabled)</dt>
 	<dd>Use the full path to the source file when displayed in the
 	debugger <b>Breakpoint view</b></dd>
 	<dt><b>Register process 0 by default</b> (default enabled)</dt>
 	<dd>Will register process 0 with the <b>Debug view</b> when the
 	parallel debugger starts. This is required to enable Eclipse to switch
 	automatically to the <b>PTP Debug perspective</b> when a debugger
 	breakpoint is hit.</dd>
 </dl>

 <h3>Communication</h3>
 <p>These are preferences relating to the communication between
 Eclipse and the external parallel debugger. They do not normally need to
 be changed.</p>
 <dl>
 	<dt><b>Command timeout (ms)</b> (default 60000)</dt>
 	<dd>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.</dd>
 </dl>

 <h3>Variable</h3>
 <p>These variables control the action of the debugger to update
 variable information.</p>
 <dl>
 	<dt><b>The debugger is suspended</b> (default enabled)</dt>
 	<dd>The debugger allows variable values to be displayed in tooltip
 	popups when the mouse hovers over a process in the <b>Parallel
 	Debug view</b>. 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.</dd>
 	<dt><b>Job or Set is changed</b> (default disabled)</dt>
 	<dd>Variable values will be updated when the current job or set is
 	changed.</dd>
 </dl>

 <h2 id="sdm">SDM (Scalable Debug Manager) Preferences (Parallel Tools &gt;
 Debug &gt; SDM)</h2>
 <p>These are preferences for controlling the behavior of the
 scalable debug manager, which is server component of the parallel
 debugger. They do not normally need to be changed.</p>

 <p><img src="images/07prefsDebugSDM.png"></p>

 <h3>Debugger launch preferences</h3>
 <p>These preferences control how the debugger behaves when it is
 launched. They do not normally need to be altered.</p>

 <dl>
 	<dt><b>Backend debugger</b> (default gdb-mi)</dt>
 	<dd>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.</dd>
 	<dt><b>Path to backend debugger</b> (default empty)</dt>
 	<dd>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.</dd>
 	<dt><b>Extra SDM arguments</b> (default empty)</dt>
 	<dd>Any extra arguments that need to be supplied to the sdm (e.g.
 	for debugging purposes)</dd>
 </dl>

 <h3>SDM debugging options</h3>
 <p>These preference allow the SDM operation to be debugged. They are
 normally only used by PTP developers.</p>

 <dl>
 	<dt><b>Enable SDM debugging</b></dt>
 	<dd>This turns on debugging of the SDM. Additional options can be
 	set to control the type and amount of debugging information that is
 	generated.</dd>
 	<dt><b>Enable SDM client debugging</b></dt>
 	<dd>Enables debugging of the SDM Eclipse client. Additional
 	options can be set to control the type and amount of debugging
 	information that is generated.</dd>
 </dl>

 <h2 id="external">External Tools Preferences Page (Parallel Tools &gt; External Tools)</h2>
 <p>This is a category for configuring external tools that are
 provided using the ETFw extensions.
 For more information see <a href="http://wiki.eclipse.org/PTP/ETFw/PTP_External_Tools_Framework">the ETFw wiki page</a>.
 </p>
 <p><img src="images/07prefsExternal.png"></p>
 <a name="feedback"></a>
 <p>The Feedback view preferences page handles cases where extensions are installed that utilize the
 Feedback view.  Here a checkbox controls whether or not the items in the Feedback tree table view
 are left expanded/contracted or not.
 See <a href="PLUGINS_ROOT/org.eclipse.ptp.etfw.feedback/html/toc.html">
 Feedback view</a> for more information.
 </p>
 <p><img src="images/07prefsExternal2.png"></p>
 <p>The Tool Configuration Location page allows the user to enter information about where to find
 tools that utilize the ETFw extensions.  In this case PPW and TAU tools can have their bin directories specified.

 </p>
 <p><img src="images/07prefsExternal3.png"></p>

 <h2 id="pldt">Parallel Language Development Tools (PLDT) Preferences</h2>
 <p>See the help for <a
 	href="PLUGINS_ROOT/org.eclipse.ptp.pldt.help/html/toc.html">PLDT</a></p>

 <h2 id="rm">Resource Manager Preferences (Parallel Tools &gt;
 Resource Managers )</h2>
 <p>These are preferences for controlling the behavior of resource managers.</p>

 <p><img src="images/07prefsRM.png"></p>

 <h3>General settings for resource managers</h3>
 <p>These are general preferences that apply to all resource managers.</p>
 <dl>
 	<dt><b>Start resource managers when Eclipse launches</b> (default enabled)</dt>
 	<dd>When this option is selection, any resource managers
 	that were running from a previous session will be restarted automatically.</dd>
 </dl>

 <p>See the help for <a
 	href="PLUGINS_ROOT/org.eclipse.ptp.ibmll.help/html/IBMLLMainHelp.html">Loadleveler</a>
 and <a
 	href="PLUGINS_ROOT/org.eclipse.ptp.ibmpe.help/html/PEMainHelp.html">Parallel
 Environment</a> for details on their preference pages.</p>

 <h2 id="viewer">Viewer (Parallel Tools &gt; Viewer)</h2>
 <p>These preferences are used to change the behavior of some of the
 PTP views. They do not normally need to be altered.</p>
 <p><img src="images/07prefsViewer.png"></p>

 <h3>Tooltip</h3>
 <p>Controls the way tooltips for PTP variables are displayed.</p>
 <dl>
 	<dt><b>Show all the time</b></dt>
 	<dd>Always show tooltips</dd>
 	<dt><b>Timeout (ms)</b> (default 5000)</dt>
 	<dd>Changes the time the tooltip remains displayed when the mouse
 	hovers over a node or process icon.</dd>
 	<dt><b>Wrap text</b> (default enabled)</dt>
 	<dd>Wrap the text to fit into the tooltip</dd>
 </dl>

 <h2 id="service">Service Configurations Preferences (Parallel Tools
 &gt; Service Configurations)</h2>

 <p>This preference page allows you to add, remove, or edit service
 configurations.</p>
 <p><img src="images/07prefsServiceConfig.png"></p>

 <p><a href="#top">Back to Top</a> | <a href="toc.html">Back to
 Table of Contents</a>
 </body>
 </html>
	<html>
	<head>
	<title>Preferences</title>
	<link rel="stylesheet" type="text/css" href="help.css">
	<script type="text/javascript" src="thumb.js"> </script>
	</head>
	<body>

	<h1>Preferences</h1>
	<p>Topics include:</p>
	<ul>
	<li><a href="#open">Opening PTP Preferences</li>
	<li><a href="#main">Main Parallel Tools Preferences </li>
	<li><a href="#debug">Debug Preferences </li>
	<ul>
	<li><a href="#sdm">SDM (Scalable Debug Manager) Preferences</a></li>
	</ul>
	<li><a href="#external">External Tools Framework (ETFw) Preferences</a></li>
	<li><a href="#pldt">PLDT</a></li>

	<li><a href="#rm">Resource Manager Preferences</a></li>
	<li><a href="#viewer">PTP Viewer Preferences</a></li>
	<li><a href="#service">Service Configurations Preferences </a></li>
	</ul>
	<h2 id="open">Opening the PTP Preferences</h2>
	<p>To open the <b>Preferences dialog</b>, select:</p>
	<ul>
	<li>
	<p><b>Window > Preferences...</b> for Windows and Linux</p>
	</li>
	<li>
	<p><b>Eclipse > Preferences...</b> for MacOS X</p>
	</li>
	</ul>

	<p>Next, expand <b>Parallel Tools</b> in the list of preferences
	pages on the left side and choose the component's preferences you wish
	to change. The following image shows all available components:</p>

	<p><img src="images/07prefsAll.png"></p>

	<h2 id="main"><a name="run"></a>Parallel Tools Preference Page</h2>
	<p>This is the main preferences page for PTP. Available preferences
	are:</p>
	<dl>
	<dt><b>Temporary output directory</b></dt>
	<dd>Temporary directory to use to save process output</dd>
	<dt><b>Console buffer size (lines)</b></dt>
	<dd>Number of lines of output from each process to save (0 means
	infinite)</dd>
	</dl>

	<h2 id="debug">Debug Preferences Page (Parallel Tools > Debug)</h2>
	<p>This is the main parallel debugger preferences page. These are
	preferences that apply to any parallel debugger.</p>
	<p><img src="images/07prefsDebug.png"></p>

	<h3>Default setting</h3>
	<p>These preferences control some debugger default behavior</p>
	<dl>
	<dt><b>Show full paths on breakpoint</b> (default disabled)</dt>
	<dd>Use the full path to the source file when displayed in the
	debugger <b>Breakpoint view</b></dd>
	<dt><b>Register process 0 by default</b> (default enabled)</dt>
	<dd>Will register process 0 with the <b>Debug view</b> when the
	parallel debugger starts. This is required to enable Eclipse to switch
	automatically to the <b>PTP Debug perspective</b> when a debugger
	breakpoint is hit.</dd>
	</dl>

	<h3>Communication</h3>
	<p>These are preferences relating to the communication between
	Eclipse and the external parallel debugger. They do not normally need to
	be changed.</p>
	<dl>
	<dt><b>Command timeout (ms)</b> (default 60000)</dt>
	<dd>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.</dd>
	</dl>

	<h3>Variable</h3>
	<p>These variables control the action of the debugger to update
	variable information.</p>
	<dl>
	<dt><b>The debugger is suspended</b> (default enabled)</dt>
	<dd>The debugger allows variable values to be displayed in tooltip
	popups when the mouse hovers over a process in the <b>Parallel
	Debug view</b>. 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.</dd>
	<dt><b>Job or Set is changed</b> (default disabled)</dt>
	<dd>Variable values will be updated when the current job or set is
	changed.</dd>
	</dl>

	<h2 id="sdm">SDM (Scalable Debug Manager) Preferences (Parallel Tools >
	Debug > SDM)</h2>
	<p>These are preferences for controlling the behavior of the
	scalable debug manager, which is server component of the parallel
	debugger. They do not normally need to be changed.</p>

	<p><img src="images/07prefsDebugSDM.png"></p>

	<h3>Debugger launch preferences</h3>
	<p>These preferences control how the debugger behaves when it is
	launched. They do not normally need to be altered.</p>

	<dl>
	<dt><b>Backend debugger</b> (default gdb-mi)</dt>
	<dd>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.</dd>
	<dt><b>Path to backend debugger</b> (default empty)</dt>
	<dd>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.</dd>
	<dt><b>Extra SDM arguments</b> (default empty)</dt>
	<dd>Any extra arguments that need to be supplied to the sdm (e.g.
	for debugging purposes)</dd>
	</dl>

	<h3>SDM debugging options</h3>
	<p>These preference allow the SDM operation to be debugged. They are
	normally only used by PTP developers.</p>

	<dl>
	<dt><b>Enable SDM debugging</b></dt>
	<dd>This turns on debugging of the SDM. Additional options can be
	set to control the type and amount of debugging information that is
	generated.</dd>
	<dt><b>Enable SDM client debugging</b></dt>
	<dd>Enables debugging of the SDM Eclipse client. Additional
	options can be set to control the type and amount of debugging
	information that is generated.</dd>
	</dl>

	<h2 id="external">External Tools Preferences Page (Parallel Tools > External Tools)</h2>
	<p>This is a category for configuring external tools that are
	provided using the ETFw extensions.
	For more information see <a href="http://wiki.eclipse.org/PTP/ETFw/PTP_External_Tools_Framework">the ETFw wiki page</a>.
	</p>
	<p><img src="images/07prefsExternal.png"></p>
	<a name="feedback"></a>
	<p>The Feedback view preferences page handles cases where extensions are installed that utilize the
	Feedback view. Here a checkbox controls whether or not the items in the Feedback tree table view
	are left expanded/contracted or not.
	See <a href="PLUGINS_ROOT/org.eclipse.ptp.etfw.feedback/html/toc.html">
	Feedback view</a> for more information.
	</p>
	<p><img src="images/07prefsExternal2.png"></p>
	<p>The Tool Configuration Location page allows the user to enter information about where to find
	tools that utilize the ETFw extensions. In this case PPW and TAU tools can have their bin directories specified.

	</p>
	<p><img src="images/07prefsExternal3.png"></p>

	<h2 id="pldt">Parallel Language Development Tools (PLDT) Preferences</h2>
	<p>See the help for <a
	href="PLUGINS_ROOT/org.eclipse.ptp.pldt.help/html/toc.html">PLDT</a></p>

	<h2 id="rm">Resource Manager Preferences (Parallel Tools >
	Resource Managers )</h2>
	<p>These are preferences for controlling the behavior of resource managers.</p>

	<p><img src="images/07prefsRM.png"></p>

	<h3>General settings for resource managers</h3>
	<p>These are general preferences that apply to all resource managers.</p>
	<dl>
	<dt><b>Start resource managers when Eclipse launches</b> (default enabled)</dt>
	<dd>When this option is selection, any resource managers
	that were running from a previous session will be restarted automatically.</dd>
	</dl>

	<p>See the help for <a
	href="PLUGINS_ROOT/org.eclipse.ptp.ibmll.help/html/IBMLLMainHelp.html">Loadleveler</a>
	and <a
	href="PLUGINS_ROOT/org.eclipse.ptp.ibmpe.help/html/PEMainHelp.html">Parallel
	Environment</a> for details on their preference pages.</p>

	<h2 id="viewer">Viewer (Parallel Tools > Viewer)</h2>
	<p>These preferences are used to change the behavior of some of the
	PTP views. They do not normally need to be altered.</p>
	<p><img src="images/07prefsViewer.png"></p>

	<h3>Tooltip</h3>
	<p>Controls the way tooltips for PTP variables are displayed.</p>
	<dl>
	<dt><b>Show all the time</b></dt>
	<dd>Always show tooltips</dd>
	<dt><b>Timeout (ms)</b> (default 5000)</dt>
	<dd>Changes the time the tooltip remains displayed when the mouse
	hovers over a node or process icon.</dd>
	<dt><b>Wrap text</b> (default enabled)</dt>
	<dd>Wrap the text to fit into the tooltip</dd>
	</dl>

	<h2 id="service">Service Configurations Preferences (Parallel Tools
	> Service Configurations)</h2>

	<p>This preference page allows you to add, remove, or edit service
	configurations.</p>
	<p><img src="images/07prefsServiceConfig.png"></p>

	<p><a href="#top">Back to Top</a> \| <a href="toc.html">Back to
	Table of Contents</a>
	</body>
	</html>