evmtemplate.4 (2010 09)

e
evmtemplate(4) evmtemplate(4)
Posted Name Template Name Match?
myco.myprod.env myco.myprod.env Yes
myco.myprod.env.temp.high.70 myco.myprod.env Yes
myco.myotherprod myco.myprod No
myco.myotherprod myco.myotherprod.start No
The syntax of an event template file is identical to the syntax of a file given as input to the
evmpost
command. The following keywords may be specified in a template file:
event This keyword introduces an event group. The body of the group is delimited by braces.
name event_name
Names the template event. The name must be made up of two or more components containing
only alphanumeric and underscore (_) characters, and separated by dot (
.) characters.
format format_specifier
Event format text. The format_specifier is a string that will be used to produce a formatted
message for display if the event is passed through the
evmshow command, or the
EvmEventFormat()
library function. See the evmshow(1) and EvmEventFormat (3) man-
pages.
If a format_specifier contains no special characters, it is displayed unchanged as the event’s
message text. For example, if
evmshow encounters an event containing the following simple
format_specifier , it displays the string exactly as specified:
EVM logger: Logger started
If the format_speci fier contains variable-specifier in the form
$variable_name and either the
posted event or the template event contains a variable with that name, the variable_value will
be included in the formatted output in place of the variable-specifier. If no such variable is
present, the variable-specifier is included in the output. For example, if an event contains a
variable called
logname and the format_speci fier:
EVM logger: Started eventlog $logname
then evmshow might display the event as:
EVM logger: Started eventlog /var/evm/evmlog/evmlog.20000228
If the format_speci fier contains a data-item-specifier in the form
@item_name, the data-item-
specifier is replaced with the value of the corresponding data item from the event. For exam-
ple, if an event contains a variable called
message and the format_speci fier is:
EVM user msg (@user_name): $message
then evmshow might display the event as:
EVM user msg (steve): Engineering group is off-site today
If the data item is not present in the event, a hyphen character (-) is output in its place. An
@
character that is not associated with a valid item name is unchanged in the output.
Any characters in the format_specifier that are not part of a variable_name or data-item-
specifier are output unchanged.
If no format_speci fier is supplied in either the template file or the posted event, a default event
message is used when the event is formatted for display.
priority priority
Indicates the importance of the event, but does not affect the order of event distribution. The
priority must be an integer value in the range 0 (lowest) to 700. See the EvmEvent (5) man-
page for the meanings of specific priority values.
i18n_catalog i18n_cat
The name of an I18N catalog file holding text strings to be displayed in place of the strings
contained in the event. This item is used for internationalizing events. If it is omitted, the
strings contained in the event will be used when the event is formatted for display. Refer to
the EVM Programmer’s Guide for more information.
i18n_set_id i18n_set
Identifies the message set within the i18n_cat to be used for translation of all internationalized
strings in the event. This item is ignored if no i18n_cat is supplied.
2 Hewlett-Packard Company − 2 − HP-UX 11i Version 3: September 2010