Activating the cache

By default, the cache that ensures recovery after system failures stores events. You control the configuration of the cache with keywords in the configuration file.

About this task

You can use the following keywords to configure the cache.

Table 1. Keywords for configuring the cache
Configuration of the Cache	Keywords
Activation of the cache	BufferEvents
Rate to send events	BufferFlushRate MaxPacketSize
Size of the cache	BufEvtMaxSize

You can configure the cache in the following way:

Store events in memory only with the BufferEvents keyword.
Save these buffered events to a permanent file with the BufferEvents keyword set to YES. Also, the BufEvtPath keyword specifies the location of the permanent file.

The second configuration ensures that no events are lost during a system failure.

The following example from a configuration file demonstrates the use of cache keywords:

BufferEvents=YES
BufEvtPath=./buffer
MaxPacketSize=130
BufferFlushRate=96
ConnectionMode=CO

When connections to the event server fail, events wait in the cache. The Event Integration Facilityattempts to reconnect to each of the backup servers in turn. If no servers are available after all retries, the API caches the events until a connection is made.

When enabling recovery features, it is important to determine the importance of performance and reliability. In some environments, the use of the cache can degrade performance depending on its configuration. Therefore you can bypass event caching by setting the BufferEvents keyword to NO.