|
1 <!--Arbortext, Inc., 1988-2004, v.4002--> |
|
2 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> |
|
3 <html> |
|
4 <head> |
|
5 <meta http-equiv="content-type" content="text/html; charset=iso-8859-1"> |
|
6 <title>Creating tracing rules</title> |
|
7 <link href="../../book.css" type="text/css" rel="stylesheet"></head> |
|
8 <body><h2>Creating tracing rules</h2> <h5>Before you start</h5><p>Before you |
|
9 can create tracing rules, check that you have: </p><ul> |
|
10 <li>compiled your code, </li> |
|
11 <li>and loaded the generated dictionary file to TraceViewer. </li> |
|
12 </ul><p>See <a href="../gettingstarted/traceanalyser_basic_walkthrough.htm"> |
|
13 TraceAnalyser basic walk-through</a> for the complete steps. </p><p>To create |
|
14 tracing rules, do the following: </p><ol> |
|
15 <li>Start TraceAnalyser from the <b>Carbide > TraceAnalyser</b> menu item. |
|
16 </li> |
|
17 <li>Click <b>Create new rule</b>. <p>The <b>Edit Rule</b> dialog is displayed. |
|
18 </p></li> |
|
19 <li>From the <b>Rule Type</b> list box, select which kind of rule you are |
|
20 creating: <ul> |
|
21 <li><b>Timing rule</b> for detecting if an operation can be executed within |
|
22 a specified time limit. </li> |
|
23 <li><b>Trace parameter rule</b> for detecting if parameters are beyond a desireable |
|
24 value range. </li> |
|
25 </ul></li> |
|
26 <li>In the <b>Rule Name</b> field, type in a name for the rule. <p>For example: <i> |
|
27 Camera Test</i>. </p></li> |
|
28 <li>(Optional) In the <b>Description</b> field, type in a free-form description |
|
29 of what the rule is about. <p> For example, for a timing rule: <i>Test that |
|
30 the Camera application is able to capture a picture within 1000ms time limit. |
|
31 </i></p></li> |
|
32 <li>Configure the rule-specific settings. <p>For instructions, see either <a |
|
33 href="#timing">To define timing rules</a> or <a href="#parameter">To define |
|
34 parameter rules</a> below. </p></li> |
|
35 <li>Connect your PC to the device by using the connection settings defined |
|
36 in TraceViewer (USB or XTI). </li> |
|
37 <li>In TraceViewer, activate the traces you want to receive. </li> |
|
38 <li>Run your application on the device. <p>During execution, TraceAnalyser |
|
39 lists both passed and failed events to the main view, along with other information |
|
40 such as the pass rate. See the following example: </p><p><img src="images\dg_mainview.png" |
|
41 alt="Sample of the main view, showing rules and activated/deactivated cases."></p></li> |
|
42 </ol><p>After the rules have been executed, you can do either of the following: |
|
43 </p><ul> |
|
44 <li><a href="viewing_failed_cases.htm">View the log of failed rules</a>, and |
|
45 together with TraceViewer determine which codeline caused the rule violation. |
|
46 </li> |
|
47 <li><a href="viewing_the_history.htm">View the rule history graph</a> to see |
|
48 how the performance of the application has changed over time. </li> |
|
49 </ul><p></p><h3><a name="timing"></a>To define timing rules:</h3><ol> |
|
50 <li>To select which trace should be monitored as the first part of this rule |
|
51 (Trace A), click <b>Select Trace</b>. <p>The <b>Select Trace for Rule</b> dialog |
|
52 is opened, showing the trace dictionaries that you loaded in TraceViewer earlier. |
|
53 </p></li> |
|
54 <li>Select the traces you want to use and click <b>OK. </b> </li> |
|
55 <li>Repeat the above steps for Trace B. </li> |
|
56 <li>In the <b>Time Limit</b> fields, enter the range the values in milliseconds |
|
57 for Trace A and Trace B. <ul> |
|
58 <li>For <b>Time Limit A</b>, the value means that Trace B must arrive after |
|
59 this. </li> |
|
60 <li>For <b>Time Limit B</b>, the value means that Trace B must arrive before |
|
61 this. </li> |
|
62 </ul><p>The following figure shows an example of how a tracing rule could |
|
63 look like: </p><p><img src="images\dg_timingRule.png" alt="Sample of the Edit Rule dialog with the sample values filled in."></p></li> |
|
64 <li>To finish, click <b>OK</b>. </li> |
|
65 </ol><h3><a name="parameter"></a>To define parameter rules:</h3><ol> |
|
66 <li>To select which trace should be monitored as the first part of this rule, |
|
67 click <b>Select Trace</b>. <p>The <b>Select Trace for Rule</b> dialog is opened, |
|
68 showing the trace dictionaries that you loaded in TraceViewer earlier. </p></li> |
|
69 <li>Select the traces you want to use and click <b>OK. </b> </li> |
|
70 <li>From the <b>Trace parameter should be</b> list box, select the behavior |
|
71 what you want the parameter and values to be: <?Pub Caret><ul> |
|
72 <li><b>Greater than/Equal to</b> </li> |
|
73 <li><b>Less than/Equal to</b> </li> |
|
74 <li><b>Between</b> </li> |
|
75 <li><b>Equal to</b> </li> |
|
76 </ul><p>The following figure shows an example of how a tracing rule could |
|
77 look like: </p><p><img src="images\ParameterRuleDialog.png" alt="Sample of the UI showing values for parameter rule type"></p></li> |
|
78 <li>To finish, click <b>OK</b>. </li> |
|
79 </ol><h5>Related tasks</h5><ul> |
|
80 <li><a href="modifying_rules.htm">Modifying rules</a></li> |
|
81 <li><a href="viewing_failed_cases.htm">Viewing the log of failed rules</a></li> |
|
82 <li><a href="viewing_the_history.htm">Viewing the rule history</a></li> |
|
83 </ul> <div id="footer">Copyright © 2010 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. |
|
84 License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a>.</div> </body></html> |
|
85 <?Pub *0000004916> |