EMS Manual

Filter Tables and Burst Filters
EMS Manual—426909-005
6-3
Filter Table Keywords
first column are interpreted as directives. The filter must contain a ?PASS or ?FAIL
directive. The ?COMMENT directive skips lines until another directive is encountered.
The owner name in the filter table (up to 8 characters) starts in position 1, the
subsystem name or number in position 10, and the event number in position 20. Event
number ranges are permitted (a..b), as well as wild cards in the owner, subsystem, or
event column.
For instance, if a wild card appears in the event column, all events for the SSID listed
in the subsystem column pass (or fail). Numbers need not be in any specific order.
Negative event numbers are permitted. Event number 0 is not allowed. An error results
if one is specified. Owners, and subsystems within an owner, can appear only once. A
duplication results in an error.
The event number column can be replaced by either event standard type or event user
type. To do so, include either directive ?STYPE or directive ?UTYPE without a value.
The two types are mutually exclusive. The same rules and restrictions as for event
numbers apply.
Pass values can be specified in column 40. These are identical to the compiled filter's
pass values and are returned to the consumer application. Pass values can be in the
range from -32768 to +32767. However, a zero pass value is not permitted. The
difference between the largest pass value and the smallest cannot exceed 32767 for a
given subsystem. Because pass values increase the size of the filter table, HP
recommends that you keep the relative range small and specify one pass value per
subsystem where possible. For instance, pass values in the range from 1 through 7 (or
101 through 107) would require 3 bits for each event listed in the table. Pass values
are allowed only for PASS filters.
Filter Table Keywords
These filter table directives must precede the actual filter table.
:
Table 6-1. Filter Table Keywords (page 1 of 2)
Keyword Description
?PROCESS name
name is the ID of the process that generated the event. The
comparison is not case sensitive, but the match must be for exactly
the number of characters given (maximum of six for Cxx-based
events) except when the asterisk (*) wild-card character appears as a
last character (example: $SP*).
?NODE n
n is the node number of the system that generated the event. The
value for n must be smaller than 255 for Cxx-based events.
?CPU n
n is number of the CPU in which the event generator runs. The value
for n must be smaller than 16.
?PIN n
n is the PIN number of the process that generated the event. The
value for n must be smaller than 255 for Cxx-based events.