Start Trace and Stop Trace

This section describes the tags to start and stop Unified Trace (UTrace) for tasks running on the Symbian device hardware or emulator.

In the TestDriver XML file, the <startTrace> element and the <stopTrace> element are children of the <task> element. Each <task> includes at most one pair of <startTrace> and <stopTrace>. They are used together to enable UTrace for one or more tasks.

<startTrace> and <stopTrace>


<startTrace> and <stopTrace>

A trace file is generated when the test suite executes. A hyperlink for the trace file is provided in the test execution HTML report. You can click the link and select a trace viewer to view the trace file.

The <startTrace> element has the following attributes:

Name

Description

configFilePath

Optional. The path of the user configuration file for UTrace. If not present, the UTrace default configuration file is used.

enablePrimaryFilter

Optional. A comma-separated list of integers to indicate which primary filters must be enabled.

disablePrimaryFilter

Optional. A comma-separated list of integers to indicate which primary filters must be disabled.

enableSecondaryFilter

Optional. A comma-separated list of integers to indicate which secondary filters must be enabled.

disableSecondaryFilter

Optional. A comma-separated list of integers to indicate which secondary filters must be disabled.

Note: For information about UTrace, the user configuration file and filters, refer to Symbian Developer Library > Symbian OS Tools And Utilities > Unified Trace Solution > Overview of Unified Trace Solution.

Example

An example XML code snippet with <startTrace>and <stopTrace> is as follows:

<task name="demo" timeout="100000">
      <startTrace enablePrimaryFilters=”20,21”/>
      <executeOnSymbian>
        <testExecuteScript PCPath="TefProjectSuite.script" SymbianPath="c:\scripts\TefProjectSuite.script"/>
      </executeOnSymbian>
      <stopTrace/>
    </task>