|
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> |
|
2 <html> |
|
3 <head> |
|
4 <meta http-equiv="content-type" content="text/html; charset=iso-8859-1"> |
|
5 <title>Configuring triggers </title> |
|
6 <link href="../../book.css" type="text/css" rel="stylesheet"> |
|
7 </head> |
|
8 |
|
9 <body> |
|
10 <h2>Configuring triggers</h2> |
|
11 |
|
12 <p>You can create start, stop, and activation triggers to TraceViewer. </p> |
|
13 <ul> |
|
14 <li>A start trigger means that receiving traces starts only when the start |
|
15 trigger is met. </li> |
|
16 <li>A stop trigger means that the view will be paused when the stop trigger |
|
17 is met. </li> |
|
18 <li>An activation trigger means that when trace with the given trigger text |
|
19 is received, a given activation configuration is loaded from the defined |
|
20 activation configuration file, and sent to the device.</li> |
|
21 </ul> |
|
22 |
|
23 <p>To configure the triggers: </p> |
|
24 <ol> |
|
25 <li>Open the TraceViewer menu by clicking <img |
|
26 src="images/icon_menu_open.png">, and select <b>Triggers</b>. |
|
27 <p>The <b>Trigger Rules </b> dialog is displayed. </p> |
|
28 </li> |
|
29 <li>To manage the rules, do any of the following: |
|
30 <ul> |
|
31 <li>To create a new start or stop rule, click <b>Add</b>. The <b>Trigger |
|
32 Rule Definition</b> dialog is opened. </li> |
|
33 <li>To edit an existing start or stop rule, select it and click |
|
34 <b>Edit</b>. The <b>Trigger Rule Definition</b> dialog is opened. </li> |
|
35 <li>To delete a rule, select it and click <b>Remove</b>.</li> |
|
36 <li>To clear the whole tree, click <b>Clear</b>. </li> |
|
37 <li>To create groups for rules, click <b>Group</b>. </li> |
|
38 </ul> |
|
39 <p>See the following figure for an example: </p> |
|
40 <p></p> |
|
41 <p><img src="images/triggerDialog.png" alt="Trigger dialog"></p> |
|
42 </li> |
|
43 <li>In the <b>Trigger Rule Definition</b> dialog, enter a name for the |
|
44 trigger and the text to be matched with each trace. </li> |
|
45 <li>From the <strong>Type</strong> listbox, select the trigger type: <b>Start |
|
46 trigger</b>, <b>Stop trigger</b>, or <strong>Activation trigger</strong>. |
|
47 See following example: |
|
48 <p><img src="images\sample_start_trigger.png"></p> |
|
49 <p>If you selected Activation trigger, continue to step 5, otherwise skip |
|
50 to <a name="step" id="step" href="#Click">step 8</a>.</p> |
|
51 </li> |
|
52 <li>Click the <img alt="nn" src="images/browse_button.png" width="28" |
|
53 height="23"> button next to the <strong>Conf</strong> field to select the |
|
54 configuration file to be used for the Activation trigger. The Load |
|
55 Configuration dialog opens: |
|
56 <p><img src="images/LoadConfiguration_dialog.png"></p> |
|
57 </li> |
|
58 <li>Browse to the desired activation file and select the configuration from |
|
59 the <strong>Load configuration</strong> listbox. |
|
60 <p>Activation files and configurations are created by using the |
|
61 <strong>Trace Activation</strong> dialog. For more information, see <a |
|
62 href="traceactivation.htm">Activating traces</a>.</p> |
|
63 </li> |
|
64 <li>Click OK in the <strong>Load Configuration</strong> dialog.</li> |
|
65 <li><a name="Click" id="Click">Click <b>OK</b> in the <strong>Trigger Rule |
|
66 Definition</strong> dialog to either create a new rule or update an |
|
67 existing rule.</a></li> |
|
68 </ol> |
|
69 |
|
70 <h5>Related tasks</h5> |
|
71 <ul> |
|
72 <li><a href="traceactivation.htm">Activating traces</a></li> |
|
73 <li><a href="setup_rules.htm">Setting up rules and filters</a></li> |
|
74 </ul> |
|
75 |
|
76 <div id="footer"> |
|
77 Copyright © 2007-2010 Nokia Corporation and/or its subsidiary(-ies). All rights |
|
78 reserved.</div> |
|
79 </body> |
|
80 </html> |