EMS Manual

Filter Tables and Burst Filters
EMS Manual—426909-005
6-6
Multiple Filters
Directive SUPPRESS missing = -59
Incompatible directives = -60
Object file purge error 48 = -100
Object file create error = -101
Object file open error = -102
Object file write error = -103
Multiple Filters
Alternate collectors and distributors accept specification of multiple filters in the startup
line of the EMSACOLL and EMSDIST program, respectively. Multiple filters are run in
sequential order for each event. Assuming PASS filters only, an event is disqualified if
all filters return a fail condition. Execution of filters stops with the first PASS condition
encountered. Conversely, assuming FAIL filters, execution stops with the first FAIL
condition encountered. Events that pass are sent to the next filter.
You can use a combination of PASS and FAIL filters when specific events are to be
excluded from or included in a set; for example, to pass all events for subsystem XYZ
except event #n. In this example, a FAIL filter would exclude event #n and pass all
other events to a following PASS filter that makes the selection by subsystem.
Compiled filters, filter tables, and one burst filter can be mixed. Typically, a filter table
precedes the compiled filter for performance reasons. If a burst filter is used, it should
follow the other filters.
For information about adding and deleting filters, see Loading Filter Tables on
page 6-6. For a summary of procedures available for configuring and loading burst
tables and filter tables, see Implementing BDS on page 7-6 and Implementing Specific-
Event Suppression on page 7-7.
For descriptions of distributor commands that accept an object token, see Section 17,
Distributor Commands and Responses. For descriptions of collector commands that
accept object tokens, see Section 19, Collector Commands and Responses
Recovery Actions
When you encounter an error while adding or deleting a set of filters, the collector or
distributor reports the filter in error but does not back out the successful operations.
Use the STATUS command to determine the current valid set of filters in the collector
or distributor.
Loading Filter Tables
You can load a single filter or multiple filters into a collector or distributor in several
ways:

If an alternate collector or distributor is not yet started, use the EMSACOLL or
EMSDIST program with the FILTER option to specify one or more filters.

To load one or more filters into a running primary or alternate collector, use the
EMSCCTRL program with the FILTER option.