blob: 59b6896e8ef1a6f35d7c99450edcceed97722fea [file] [log] [blame]
<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="en-us" xml:lang="en-us">
<head>
<meta content="text/html; charset=utf-8" http-equiv="Content-Type" />
<meta name="copyright" content="Copyright (c) 2000, 2006 IBM Corporation and others. All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: IBM Corporation - initial API and implementation" />
<meta name="DC.rights.owner" content="(C) Copyright 2000, 2006" />
<meta content="public" name="security" />
<meta content="index,follow" name="Robots" />
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<meta content="task" name="DC.Type" />
<meta name="DC.Title" content="Defining the launching preferences" />
<meta name="abstract" content="Using the Preferences page, you can define the preferences that the servers use when starting or switching server modes. Switching server modes occurs when you use the Run on Server or Debug on Server commands." />
<meta name="description" content="Using the Preferences page, you can define the preferences that the servers use when starting or switching server modes. Switching server modes occurs when you use the Run on Server or Debug on Server commands." />
<meta content="preferences, launching for servers, servers, launching, workbench, defining launching preferences for servers" name="DC.subject" />
<meta content="preferences, launching for servers, servers, launching, workbench, defining launching preferences for servers" name="keywords" />
<meta content="XHTML" name="DC.Format" />
<meta content="twlaunchpref_wst" name="DC.Identifier" />
<meta content="en-us" name="DC.Language" />
<link href="../../org.eclipse.wst.doc.user/common.css" type="text/css" rel="stylesheet" />
<title>Defining the launching preferences</title>
</head>
<body id="twlaunchpref_wst"><a name="twlaunchpref_wst"><!-- --></a>
<h1 class="topictitle1">Defining the launching preferences</h1>
<div><p><span id="shortdesc_ph1"><a name="shortdesc_ph1"><!-- --></a>Using the Preferences page,
you can define the preferences that the servers use when starting or switching
server modes. Switching server modes occurs when you use the <span class="uicontrol">Run
on Server</span></span><span id="shortdesc_ph2"><a name="shortdesc_ph2"><!-- --></a> or <span class="uicontrol">Debug on Server</span> commands.</span></p>
<div class="p" />
<div class="section" id="twlaunchpref_wst__context"><a name="twlaunchpref_wst__context"><!-- --></a>To define these preferences, complete the following:</div>
<ol>
<li id="twlaunchpref_wst__step1"><a name="twlaunchpref_wst__step1"><!-- --></a><span>In the toolbar, select <span class="menucascade"><span class="uicontrol">Window</span>
&gt; <span class="uicontrol">Preferences</span></span>.</span></li>
<li id="twlaunchpref_wst__step2"><a name="twlaunchpref_wst__step2"><!-- --></a><span>In the Preferences window, expand <span class="uicontrol">Server</span> and
then select <span class="uicontrol">Launching</span>.</span></li>
<li><span id="twlaunchpref_wst__step3"><a name="twlaunchpref_wst__step3"><!-- --></a>Specify one or more of the following settings:</span>
<table class="choicetableborder" summary="" cellspacing="0" cellpadding="4" rules="rows" frame="hsides" border="1">
<thead><tr><th valign="bottom" id="N100B4-option" align="left">Option</th>
<th valign="bottom" id="N100B4-desc" align="left">Description</th></tr></thead>
<tbody>
<tr><td valign="top" headers="N100B4-option" id="N100BF"><strong>Automatically publish when starting servers</strong></td>
<td valign="top" headers="N100B4-desc N100BF">Specifies that all the files should automatically be published before
starting the server.</td>
</tr>
<tr><td valign="top" headers="N100B4-option" id="N100D0"><strong>Automatically restart servers when necessary</strong></td>
<td valign="top" headers="N100B4-desc N100D0">Specifies that the server tools can automatically restart the server
when it detects that the server must be restarted to handle resource changes
in the workspace.</td>
</tr>
<tr><td valign="top" headers="N100B4-option" id="N100E1"><strong>Save dirty editors before starting server</strong></td>
<td valign="top" headers="N100B4-desc N100E1">Specify the preference for saving the changes in any open server editors
before starting the server by selecting one of the following options:<ul>
<li>Always - specifies the workbench will automatically save any changes in
an open server editor before starting the server</li>
<li>Never - specifies the workbench will not save the changes in any open
editors before starting the server</li>
<li>Prompt - specifies the workbench to prompt you before saving any changes
in an open server editor</li>
</ul>
</td>
</tr>
<tr><td valign="top" headers="N100B4-option" id="choption1"><strong>When switching to a different server mode</strong></td>
<td valign="top" headers="N100B4-desc choption1"><span id="twlaunchpref_wst__chdesc1_ph1"><a name="twlaunchpref_wst__chdesc1_ph1"><!-- --></a>When switching the server to run in a different
mode, for example using the <span class="menucascade"><span class="uicontrol">Run As</span> &gt; <span class="uicontrol">Run
on Server</span></span></span> <span id="twlaunchpref_wst__chdesc1_ph2"><a name="twlaunchpref_wst__chdesc1_ph2"><!-- --></a>or <span class="menucascade">
<span class="uicontrol">Debug As</span> &gt; <span class="uicontrol">Debug on Server</span></span>,
specify the next action of the server by selecting one of the following options:</span><a name="twlaunchpref_wst__chdesc1_ul1"><!-- --></a><ul id="twlaunchpref_wst__chdesc1_ul1">
<li>Restart - specifies the workbench to stop and restart the server</li>
<li>Continue - specifies to continue running the server in previous mode and
ignore the change request of running in a different server mode</li>
<li>Prompt - specifies the workbench to prompt you for the next server action
when you switch the server to run in a different mode</li>
</ul>
</td>
</tr>
<tr><td valign="top" headers="N100B4-option" id="choption2"><strong>When switching the server out of debug mode</strong></td>
<td valign="top" headers="N100B4-desc choption2"><span id="twlaunchpref_wst__chdesc2_ph1"><a name="twlaunchpref_wst__chdesc2_ph1"><!-- --></a>When you finish running the server in debug mode
and switch out, for example using the <span class="menucascade"><span class="uicontrol">Run As</span>
&gt; <span class="uicontrol">Run on Server</span></span></span><span id="twlaunchpref_wst__chdesc2_ph2"><a name="twlaunchpref_wst__chdesc2_ph2"><!-- --></a> command,
specify the next action of the server by selecting one of the following options:</span><a name="twlaunchpref_wst__chdesc2_ul1"><!-- --></a><ul id="twlaunchpref_wst__chdesc2_ul1">
<li>Restart - specifies the workbench to stop and restart the server</li>
<li>Disable breakpoints - specifies to clear all previously set breakpoints
from the application and continue running the application in the newly selected
server mode</li>
<li>Continue - specifies to continue running the server in debug mode and
ignore the change request of running in a different server mode</li>
<li>Prompt - specifies the workbench to prompt you for the next server action
when switching the server out of debug mode</li>
</ul>
</td>
</tr>
<tr><td valign="top" headers="N100B4-option" id="N101A5"><strong>When switching the server into debug mode, re-enable
breakpoints</strong></td>
<td valign="top" headers="N100B4-desc N101A5">When you change
the server mode into debug mode, for example using the <span class="menucascade"><span class="uicontrol">Debug
As</span> &gt; <span class="uicontrol">Debug on Server</span></span> command,
specify how to handle the breakpoints currently set in your application by
selecting one of the following options:<ul>
<li>Always - specifies to enable all the currently set breakpoints in your
application and break at them</li>
<li>Never - specifies the workbench to ignore all the breakpoints previously
set in your application and continue running the application on the server
in debug mode. When the workbench ignores all the breakpoints in your application,
the behavior of the server mode is similar to using the <strong>Run on Server</strong> command.
However, because the server is running in debug mode, you have the opportunity
to enable or re-enable breakpoints in your application.</li>
<li>Prompt - specifies the workbench will prompt you on how to handle the
breakpoints set in your applications</li>
</ul>
</td>
</tr>
</tbody></table>
</li>
</ol>
</div>
</body>
</html>