EpsTemplates File Help

The EpsTemplates file contains X resources that define the format of messages to be sent to various destinations. Using the X resource database class capability, templates can vary based upon the application generating the event, the message destination, and/or the event type causing the message. Reserved application names include system, keepalive, and servernet.

File Structure

Each message template defined is a Perl-style anonymous array. Each item in the array is a line in the formatted message.

Template items contained within angle brackets (<>) are variables. When a message is formatted, the variables are replaced with appropriate values:


File Content

The default EpsTemplates file contains a default template, a template for sending messages to the console, and a template for sending messages to the GCSC. You should edit copies of these templates (within the EpsTemplates file) to create custom versions for your configuration.

The variable <Message.raw.eventTime:cftime-%y/%m/%d %H:%M:%S> in the default and console templates fits the <value:formatter-format> form. The Message.raw.eventTime value is a time in seconds provided by EPS and cftime is a program in the EPS private executables directory that formats the time in seconds into the %y/%m/%d %H:%M:%S format.

The following table lists the X resources for each of the default templates and briefly describes the template content.  
X Resource
Template Description
Appl.SendingApp.Dest.EventType.template This is the default template, using class names in its first four components. This template is used for messages that do not match the specific instances of the application, destination, or event type components in the template resources.
eNotify.SendingApp.console.EventType.template This is the console template, which uses the eNotify instance of the Appl (application processing the event) class and the console instance of the Dest (destination) class. The console template is used by all messages designated for the console unless a new console template is created for specific applications or event types.
eNotify.SendingApp.gcsc.EventType.template This is the GCSC template. The variables in the template are filled in with values from the EpsSiteAdmin file and message-specific values maintained internally by EPS.

The following table lists and describes X resource variables provided by EPS and used in the message templates.  
X Resource Variable
Description/Value
Message.raw.application The name of the application that generated the filtered event. If not specified, it defaults to system.
Message.raw.authorizedTime The time in seconds that the event notifier created the unsent message file for the daemon to read.
Message.raw.criticality The severity of the message.
Message.raw.description The summary description of the event.
Message.raw.destination The intended destination of the event.
Message.raw.detail The complete text of the event as it appears in the event stream.
Message.raw.event The event type.
Message.raw.eventTime The time of the event as it appears in the event stream.
Message.formattedDetail The complete text of the event, formatted into a human-readable form if necessary (otherwise, identical to Message.raw.detail).
Message.sendingTime The time in seconds that the message was formatted and sent by the event notifier daemon.