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