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:

  1. 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.

  2. To manage the rules, do any of the following:
  3. (Optional) In the Definition dialog, do any of the following modifications and click OK to return to the Rules dialog.
    1. Enter a name for the rule.
    2. 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.

    Color Definitions

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

    Sample of rules selected in the dialog.

  5. 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