Setting up rules and filters
Before you start
You can work with generated traces in various ways, by setting rules and filters
for them. The settings are saved into a configuration file named userConf.xml
, and can be exported from TraceViewer or imported back in by using Carbide's
import and export functions available under the File menu.
You can configure rules and filters in a separate dialog that lists its contents
like a tree.
To set up rules for traces, do the following:
- On the TraceViewer toolbar, click the item for which you want to create
a rule or a rule definition:
Button |
Use it to open: |
 |
Basic filter settings. |
 |
Trace coloring settings, including definitions for foreground and background
colors. |
 |
Trace counting settings |
 |
Variable value tracing settings, including definitions for the number
of steps stored in variable tracing history. |
 |
Trigger settings, including definitions for start and stop triggers.
For instructions, see Configuring triggers. |
The Rules dialog for the selected item is displayed.
- To manage the rules, do any of the following:
- To create a new rule, click Add. The Definition dialog is
opened.
- To edit an existing rule, select it and click Edit. The Definition
dialog is opened.
- To delete a rule, select it and click Remove.
- To clear the whole tree, click Clear.
- To create groups for rules, click Group.
- Note: For filtering, there are more configuration settings available.
See Setting filtering options.
- (Optional) In the Definition dialog, do any of the following modifications
and click OK to return to the Rules dialog.
- Enter a name for the rule.
- Select rule type, either Text rule and Component / Group rule
.
- Text rule: type in the text to be matched with each trace.
- Component / Group rule: type in the component name and/or group
IDs from where you want traces to be found. You can use the asterisk * as
a wildcard character for any component or group.
- For text rules, select Match case to make the trace text be in
the same case as with the rule.
Example: The following figure shows the Color Definition dialog.

- When rules are created and they are listed in the dialog, select the ones
you want to enable.

- To save your changes, click OK.
Tip: If you close TraceViewer when you have any
of the rules (color, filter, line count, variable tracing) enabled, they will
get automatically enabled the next time you start TraceViewer.
Related tasks