carbidecpp22devenv/configuration/org.eclipse.osgi/bundles/309/1/.cp/reference/cdt_u_run_dbg_launch_group.htm
author cawthron
Fri, 04 Dec 2009 10:01:33 -0600
changeset 5 684bf18fdedf
permissions -rw-r--r--
add files for RCL_2_2
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
5
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
     1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
     2
<html lang="en">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
     3
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
     4
<head>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
     5
<meta http-equiv="Content-Language" content="en-us">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
     6
<meta name="GENERATOR" content="Microsoft FrontPage 5.0">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
     7
<meta name="ProgId" content="FrontPage.Editor.Document">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
     8
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
     9
<title>Group Launch Configuration</title>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    10
<link rel="stylesheet" type="text/css" href="../help.css">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    11
</head>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    12
<body>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    13
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    14
<h1>Launch Group</h1>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    15
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    16
<p>The user can launch multiple applications at the same time or in sequential order. This is made possible by the launch configuration type: <i>Launch Group</i>.</p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    17
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    18
<h2>Launches tab</h2>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    19
<p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    20
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    21
The <i>Launches</i> tab lets you add and delete launch configurations to the group.
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    22
It also allows you to temporarily disable, re-order and edit properties of the elements in the group.
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    23
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    24
</p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    25
<img src="../images/run_debug_launch_group.png">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    26
<p></p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    27
<dl>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    28
<table width="580" fgcolor="#DDD" border="1" cellpadding="2" cellspacing="0" >
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    29
<tr ><th>Component</th><th>Description</th></tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    30
<tr><td width="30%"><dt>Name</dt></td><td>Displays the name of the launch configuration and a checkbox for enabling or disabling the configuration.</td></tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    31
<tr><td><dt>Mode</dt></td><td>Displays the mode the configuration will run in when the group is launched.</td></tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    32
<tr><td><dt>Action</dt></td><td>Displays the optional action that will be carried after the configuration is launched.</td></tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    33
<tr><td><dt>Up</dt></td><td>Move selected configuration(s) up</td></tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    34
<tr><td><dt>Down</dt></td><td>Move selected configuration(s) down</td></tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    35
<tr><td><dt>Add...</dt></td><td>Opens a dialog to add a new configuration.</td></tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    36
<tr><td><dt>Edit...</dt></td><td>Opens a dialog to edit values for configuration(s).</td></tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    37
<tr><td><dt>Remove</dt></td><td>Removes selected configuration(s) from the list.</td></tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    38
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    39
</table>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    40
</dl>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    41
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    42
<h2>Common tab</h2>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    43
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    44
The <i>Common</i> tab lets you select where the configuration is stored, see <a href="cdt_u_run_dbg_comm.htm">Common tab reference</a> page for details.
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    45
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    46
<h2>Add and Edit launch configuration Dialog</h2>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    47
<p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    48
<img src="../images/run_debug_launch_group_edit.png">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    49
</p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    50
<dl>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    51
<table width="580" fgcolor="#DDD" border="1" cellpadding="2" cellspacing="0" >
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    52
<tr ><th>Component</th><th>Description</th></tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    53
<tr><td width="30%"><dt>Launch Mode</dt></td>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    54
  <td>The Launch Mode combobox at the top of the dialog serves a dual purpose.<br>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    55
   1. It dictates the desired mode for the launch configuration being added,
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    56
and <br>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    57
   2. It establishes a 'mode' filter for the launch configurations that are
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    58
exposed to the user (for selection) in the area below the combobox<br>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    59
<p/>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    60
For example, when the 'debug' mode is selected, (1) only launch configurations
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    61
that support being invoked in 'debug' mode appear. Also, (2) when the launch
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    62
group is invoked, that particular child launch configuration will be invoked in
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    63
'debug' mode.
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    64
  </td></tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    65
<tr><td><dt>Filter input</dt></td><td>Type in filter input to filter list of configurations by name</td></tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    66
<tr><td><dt>Configurations tree</dt></td><td>Lists all available launch configurations for the selected Launch Mode, filtered by <i>Filter input<i>.</td></tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    67
<tr><td><dt>Use default mode when launching</dt></td>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    68
  <td>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    69
This checkbox acts as a sort of override to whatever mode is set in the Launch Mode
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    70
combobox. Checking this option indicates that the child launch configuration
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    71
should be launched in the mode used to initiate the launch group launch. This
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    72
needs some clarification. First, realize that a launch configuration can be
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    73
invoked from either the 'Debug' or the 'Run' actions (and some comparable
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    74
'profile' action in certain Eclipse configurations/products). That means, the
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    75
launch group itself can be launched either in debug or run mode. When you check
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    76
the "Use default..." checkbox, you're saying: "launch this particular child
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    77
configuration in the mode that the parent (launch group) is launched with." If
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    78
you do not have that checkbox checked, then the child configurations will be
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    79
invoked in whatever mode each individual child is configured with.
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    80
<p/>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    81
Note that "Use default..." control can allow you to create a launch group
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    82
that will not be successful. For example when one or more launch configurations
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    83
selected cannot be launched in the mode dictated by launch group mode.
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    84
  </td></tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    85
<tr><td><dt>Post launch action</dt></td><td>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    86
There are several actions available that control what should be done after each launch:
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    87
<li>Delay - Waits a specified number of second before launching the next configuration in the group</li>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    88
<li>Wait until terminated - Waits until current launch is terminated</li>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    89
<li>None - Proceeds to launch next configuration immediately</li>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    90
</td></tr>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    91
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    92
</table>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    93
</dl>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    94
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    95
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    96
<p/>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    97
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    98
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
    99
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   100
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   101
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   102
<p><img border="0" src="../images/ngconcepts.gif" ALT="Related concepts" width="143" height="21">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   103
<br>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   104
<a href="../concepts/cdt_c_over_dbg.htm">Debug overview</a><br>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   105
<a href="../concepts/cdt_c_dbg_info.htm">Debug information</a></p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   106
<p><img border="0" src="../images/ngtasks.gif" ALT="Related tasks" width="143" height="21">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   107
<br>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   108
<a href="../tasks/cdt_o_run.htm">Running and debugging</a></p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   109
<p><img border="0" src="../images/ngref.gif" ALT="Related reference" width="143" height="21">
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   110
<br>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   111
<a href="cdt_o_run_dbg_pages.htm">Run and Debug dialog box</a></p>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   112
<img src="../images/ng00_04a.gif" ALT="IBM Copyright Statement" >
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   113
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   114
</body>
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   115
684bf18fdedf add files for RCL_2_2
cawthron
parents:
diff changeset
   116
</html>