XYGATE Merged Audit Reference Manual

Table Of Contents
XYPRO Technology Corporation 39 Proprietary and Confidential
Chapter 3. Configuring Filters and the
FILTERS File
The Filter is XMAs unit of control. Filters perform two functions:
They determine what goes in the XMA database.
They trigger one or more ACTIONS when an event matching the Filters selection
criteria occurs.
Note: Appendix D: contains a number of Sample Filters.
Filters reside in the FILTERS file, which is an EDIT file in the XYGATEMA subvolume.
There is one FILTERS file per XMA Pathway. All the MOVER Serverclasses read a
pre-compiled version of the FILTERS file called MACONFB. A copy of MACONFB is
created on each node. The macro XMA_COMPILE_FILTERS is used to compile the
FILTERS file and create MACONFB.
Each MOVER loads the MACONFB file into memory and then compares every audit
event it reads against the selection criteria of each Filter that designates it as the
MOVER. If MACONFB is unavailable, the MOVER Serverclasses will load the
FILTERS file into memory.
The MOVERs all periodically check to see if MACONFB has been changed. If it has
been changed, each MOVER will reload the MACONFB file into memory. They each
generate a CHECKSUM EMS message when they load a new version of the file. This
allows you to use XMA to monitor the MOVERs loading a new MACONFB file. The
MOVERS also compare the timestamp of the FILTERS file to the timestamp of the
MACONFB. If the FILTERS file is newer, a warning message #169 will be sent to
EMS.
The MOVERs format the audit record for insertion into the XMA database before
comparing the record against the FILTERS file. This is what makes it possible to select
audit records based on the contents of columns in the Audit Detail and Audit Session
tables in your Filters.
Note: By default, Filters are processed in the order in which they are encountered in
the FILTERS file. Once a Filter Definition is found that matches all the criteria for
the current record, it stops searching. If you wish to have records processed by
more than one Filter Definition, this can be accomplished via the
EVALUATE_MSG keyword. Refer to section 3.3.3 on page 45 (and the
Glossary) for more information.