EpsEvents File Help

The EpsEvents file contains two basic types of X resources: Each event definition and message retry X resource record is defined with a Perl-style anonymous hash.

There are several event definition records in EpsEvents. The generic record named eNotify.Application.Status is used for all events that do not have a more specific record. The other event definition records, such as eNotify.keepalive.restart, are specific to an application (keepalive) and its status (restart).

There is one message retry record in EpsEvents: eNotify.EventType. This is a generic record used for all events until record(s) for specific event types are created.

All of these X resource records, particularly the two generic records, can be copied and revised to create custom records for your installation.


Event Definition Resource Record Parameters

The following table describes the parameters contained in each event definition resource record:
Event Definition Parameter
Parameter Description
criticality The severity of the event. Its value is one of Critical, Major, Minor, Warning or Informational. If not specified, it defaults to Major.
event An optional user-defined string used to identify the event during further notification processing. This event type string can appear in a message retry record resource name to designate event-specific parameters used for retrying message send attempts. The event type can also be used in an EpsTemplates file resource name to designate an event-specific template used for the notification message.
description A required string that summarizes the event causing the notification.
destination One or more required space-separated keywords used to indicate the destination(s) of the notification. The keyword(s) must be defined in the EpsDestinations file.
converter This parameter is optional. It names a script or other external program that accepts the matched message on its standard input and produces output on its standard output. This output is required to be in X resource database (xrdb) format in order to override the other parameters of the record if desired.

Message Retry Resource Record Parameters

The following table describes the parameters contained in each message retry resource record:
Message Retry Parameter
Parameter Description
maxAttempts The maximum number of times to attempt to send a message regarding this event type to its destination. If this value is zero, no attempt is made to send messages regarding this event. If this value is -1, the message is retried until delivered.
warnThreshold The number of failed send attempts that cause a message to be logged to the console (default problem notification device). If this value is zero, no message is logged as a result of failed send attempts.
waitTime The approximate amount of time, in seconds, to wait between retry attempts at sending messages regarding events of this type. waitTime must be an integer.
retainTime The amount of time, in hours, which undeliverable messages should be retained until being purged from the system. If this value is set to zero, undeliverable messages are retained indefinitely. retainTime must be an integer.