ViewPoint Manual

Customizing ViewPoint
ViewPoint Manual426801-001
6-3
Basic Default Filtering Rules
Basic rules for the default filters provided with the ViewPoint application
Source code for the default primary-events filter
Source code for the default alternate-events filter
A description of how the default alternate-events filter uses dynamic filter-
configuration parameters
Basic Default Filtering Rules
The default primary-events and alternate-events filters follow certain basic rules. In
both filters, ViewPoint passes all events that are not specifically suppressed and
highlights action and critical events. The basic default filtering rules are:
1. First, the default filter checks for events that are not to be displayed on the
ViewPoint screen—events with a SUPPRESS^DISPLAY token value of TRUE.
ViewPoint always suppresses the display of messages for these events with one
exception.
The exception is for action-completion events—events that indicate that the action
requested by an action event message has been taken. If the suppressed event is an
action-completion event, an event with an ACTION^NEEDED token value of
FALSE, the filter passes the event with a pass code of 3. When ViewPoint receives
an action-completion event (an event with pass code 3), it does not display an
action-completion message, but dims the corresponding action-needed message and
decreases the event count by 1.
2. Next, the default filter checks for action events—events with an
ACTION^NEEDED token. If the ACTION^NEEDED token is present, the filter
sends ViewPoint a pass code of 1. When ViewPoint receives an action event (an
event with pass code 1), it displays the event message highlighted as an action event.
3. Then, the default filter checks for critical events—events with an EMPHASIS token
value of TRUE. If the EMPHASIS token has a value of TRUE, the filter sends
ViewPoint a pass code of 2. When ViewPoint receives a critical event (an event
with pass code 2), it displays the event message highlighted as a critical event.
4. If the event falls through the previous checks, it is an ordinary event (neither action
nor critical). In this case, the filter does not send ViewPoint a pass code. When
ViewPoint receives an event without a pass code, it displays an unhighlighted event
message for that event.
Table 6-1 lists the corresponding ViewPoint action for each PASS value that ViewPoint
receives.
Table 6-1. Pass Values and Corresponding ViewPoint Action
Pass Value ViewPoint Action
0 Displays an unhighlighted event message for that event.