Cache File - IBM Enterprise Console Manual

An adapter uses the TIVOLI_COMM_DIR Tivoli Management Framework
environment variable, if set, to determine which directory to use for its lock and
pipe files. If the variable is not set, /tmp/.tivoli is used instead. For more
information about this environment variable, see the Tivoli Management Framework
Release Notes.

Cache File

Events are written to the cache file using a "circular" method; when the cache file
has reached the size limit set by BufEvtMaxSize, the next new event is written to
the beginning of the cache file (thus overwriting the existing data at that location).
Subsequent events continue being written in order until the end of the file is
reached again, and the process starts over from the beginning of the file. A small
header at the beginning of the file tracks where the next new event will be written
and where the next old event will be removed.
The format of the cache file is as follows:
The first three lines in the cache file all have a fixed size of 18 bytes and contain
the following data:
maxsz The maximum size of the cache file.
head
tail
8
IBM Tivoli Enterprise Console: Adapters Guide
File Type
Configuration
Error
Format
Installation script
Object identifier
Registration
Rules
The byte offset from the beginning of the file to the next event to send. A
value of zero ( ) indicates an empty cache file.
The byte offset from the beginning of the file to the first byte of free space
in the file.
Description
Defines configuration options for adapters.
Defines error logging and tracing options for the
adapter.
Defines the format of messages and matches them to
event classes for the UNIX log file, NetWare log file,
OS/2, and Windows and Windows NT event log
adapters.
Configures the adapter to start when the operating
system starts.
Defines object-identifier-to-name mappings for the
®
NetView /6000, OpenView, and SNMP adapters.
The registration file generated by the installation
script for NetView/6000 and OpenView.
Defines rules to the event server; must be part of the
rule base.