Filter actions define what action is taken when a filter pattern is found in step output. Each filter pattern you create is associated with a single filter action. Both filter actions and patterns are defined in log filters.
To create a log filter, select Creating a Log Filter.
. For details, seeFilter Action | Definition | Step Results |
---|---|---|
Set Fail (the default) | When the system finds the filter pattern, it sets the step results status to Fail and continues searching the current line for filter patterns in the set. | Fail |
Set Fail/Halt | When the system finds the filter pattern, it sets the step results status to Fail, stops searching the current line for the filter patterns in the set, skips to the next line, and starts the pattern search again. | Fail |
Clear Fail | When the system finds the filter pattern, it sets the step results status to Pass and continues searching the current line for the filter patterns in the set. | Pass |
Clear Fail/Halt | When the system finds the filter pattern, it sets the step results status to Pass, stops searching the current line for the filter patterns in the set, skips to the next line, and starts the pattern search again. | Pass |
Halt | When the system finds the filter pattern, it stops searching the current line for the filter patterns in the set, skips to the next line, and starts the pattern search again. It does not change the step results status. | not applicable |
Include | Include allows you to reference one or more log filters in another log filter. You specify the log filter you want to include in the Pattern field and select Include in the Action field. | not applicable |
Warning | When the system finds the filter pattern, it sets the step results status to Warn and continues searching the current line for the filter patterns in the set. | Warning |
Clear Warning | When the system finds the filter pattern, it sets the step results status to Pass and continues searching the current line for filter patterns in the set. | Pass |
Clear Warning/Halt | When the system finds the filter pattern, it sets the step results status to Pass, stops searching the current line for the filter patterns in the set, skips to the next line, and starts the pattern search again. | Pass |
Notify Changers | To use Notify Changers, an adaptor that creates a relationship list must be included in the project and the adaptor step must run before the step that contains the Notify Changers log filter. The adaptor relationship list pairs users and objects (such as changed files). For details, see the Adaptor XML Reference. After the adaptor runs and creates the relationship list, if a log filter with the Notify Changers action matches its filter pattern in a step output line, the line is scanned again to try to match objects in the relationship list. If an object match is found, the users paired with the object are sent e-mail notification. For example in the following line of step output, the object match for the filter pattern Error is MyFile.c. So, the users paired with the MyFile.c object in the relationship list are sent e-mail notification of the error. Error: Invalid token on line 55 of MyFile.c |
not applicable |