Triggering Actions on Traces

From the Memento main window, select in the Control bar, then Rules in the Memento Configuration window.

The figure on the Rules button indicates how many rules are active.

The Memento Rules dialog box opens.

●

A Memento rule includes a rule action that specifies the action to be performed, and rule settings that specify the criteria that a trace has to meet for the rule action to be triggered.

●

By default, rules 1 to 7 are predefined, but they can be modified. See Default Configuration.

●

Only enabled rules and enabled settings in a rule are taken into account.

●

The Memento application applies the rules from the smallest to the highest number.

●

When a trace meets a rule and the rule action doesn't include "Continue", the action associated to that rule is applied and the trace is not evaluated against another rule.

●

When a trace meets a rule and the rule action includes "Continue", the action defined for that rule is applied but the trace is reevaluated against the next applicable rule.

The last rule (without a "Continue" action) applicable to the trace is fully applied.

●

When a rule is based on a verbosity criterion, the rule applies to the traces having that verbosity level and less verbose levels.

Refer the section Triggering Actions on Traces in the User Guide (D603) Triggering Actions on Traces for practical applications of these principles.

Introduction

Rules with Highlight, Background, Text Color actions, and their Continue counterpart, allow you to customize the trace display.

When such a rule is applied, it affects the trace display in the Trace column of the message list.

By default, the Memento rules 2 to 7 set a predefined highlight (background and text color) based on the verbosity level.

See the sectionMemento Rules window for a detailed description of the fields.

Modify the trace display

To define or modify a rule to customize the trace display, proceed as follows:

1.

In the Memento Rules window, do one of the following actions:

□

To enable an existing rule, select the Enable check box and go to step 2.

□

To disable an existing rule, deselect the Enable check box.

□

To modify the settings and/or action of an enabled rule, go respectively to step 2 and/or 3.

□

To add a new rule, right-click the row above which you want to add a rule and select Add before from the context menu.

Other commands are available to add and move rows in the context menu.

2.

In a given rule, define the rule setting you want to use:

□

Select the check box in front of the rule setting.

□

Type or select the value to be used as filtering criterion.

3.

In the rule, define the requested action.

See Action field for more information on the various actions.

4.

If requested, invert the filter rule by selecting the Not check box:

□

When the check box is not selected, the rule action is executed only when all the enabled rule settings are met.

□

When the check box is selected, the action is always executed except when all the enabled rule settings are met.

5.

If requested, change the rule position by selecting Move up current row or Move down current row from the Edit menu.

6.

Click Apply to apply the updated rule configuration to the data displayed in the Memento application.

Using StartDump or StopDump rules in combination with Trigger Setup options set in the Dump window allows you to start or stop automatically the backup to a dump file when a trace matches the rule.

1.

Add a row by right-clicking in the table and selecting Add before or Add Top from the context menu.

If you define several StartDump or StopDump rules, the first trace that matches one of the rules will trigger the rule action.

2.

In the added row, define a rule with a StartDump or StopDump action and the settings a trace has to meet to trigger the action.

3.

Select the Enable check box to activate the defined rule.

4.

Click Apply to save the changes in the rule configuration.

5.

In the Dump window, set up the dump settings and initiate the dump file, as explained in the procedure Backing up Traces.

If you have defined a StartDump rule, the dump file is initiated when you click Start in the Dump window, but the traces start being backed up to the dump file only when a trace meets the StartDump rule settings.

In the Dump window, the Start button changes to Waiting and the message Dump is waiting for trigger is displayed at the bottom of the Dump window.

Using the StopGoBack rules in combination with the Apply StopGoBack rules option set in the Go Back window allows you to stop in a Go Back action each time a trace matches the rule.

1.

Add a row by right-clicking in the table and selecting Add before or Add Top from the context menu.

The row position does not matter. If you define several StopGoBack rules, any trace that matches one of the rules will trigger the rule action. So both rules will be applied.

2.

In the added row, define a rule with a StopGoBack action and the settings a trace has to meet to trigger the action.

3.

Select the Enable check box to activate the defined rule.

4.

Click Apply to save the changes in the rule configuration.

5.

In the Go Back window, set up the Apply StopGoBack rules option to Yes, as explained in the procedure Go back to earlier stored traces.

6.

Click OK in the Go Back window

When the Go Back stops on a trace matching the StopGoBack rule, click Run to resume the Go Back action.

If you disable a StopGoBack rule after starting a Go Back action, you need to click Continue in the Go Back window for the rule to be effectively disabled in the current Go Back action. Clicking Run in the main window is not sufficient.