evmpost.1 (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

evmpost(1) evmpost(1)

NAME

evmpost - post events to the EVM daemon

SYNOPSIS

evmpost [-r [-m|

-M]] [[-a|-u msg [-p priority ]] | [ﬁlename|

-]]

DESCRIPTION

The

evmpost command takes a ﬁle or stream of text event sources as input and converts them to binary

EVM events. By default, the command then posts them to the EVM daemon for distribution.

If the

-r option is speciﬁed,

evmpost writes the EVM events to its stdout stream instead of posting

them to the daemon. By default,

evmpost

attempts to retrieve event template information from the

EVM daemon and merges the template items and environmental items such as user name

and times-

tamp into the output events. If the -M

option is used, the output events contain only the items speciﬁed

in the source.

An event source may contain any number of events. Each event is speciﬁed in the manner shown. See

the EvmEvent (5) manpage for a more detailed explanation.

event {

name event_name

format format_specifier

priority priority

var {

name variable_name

type variable_type

value variable_value

}

The evmpost command recognizes the following data items in an event source:

•

NAME

• PRIORITY

• FORMAT

• REF

• I18N_CATALOG

• I18N_SET_ID

• I18N_MSG_ID

• VAR

• TYPE

• VALUE

All EVM variable types may be speciﬁed except for OPAQUE. Refer to EvmEvent (5) for details on data

items and variables.

In the event source, each keyword must be accompanied by a corresponding value. The value must be

enclosed in double quotes ("") if it contains white space. The data item keywords that are speciﬁed out-

side the event body are taken as global values. The data item keywords are included in each of the fol-

lowing events which do not have an explicit value deﬁned for that keyword.

Comments are indicated by a leading

# character. Blank lines are ignored.

The

evmpost command builds an EVM event containing the items that are explicitly speciﬁed in the

source. If the event is posted or if the -r option is speciﬁed without -M, additional environmental items

such as the timestamp, process id, and template items are inserted into the event automatically.

The rules for posting an event are more stringent than those for an event simply to exist. Therefore,

evmpost may display an error when trying to post an an event that cannot be posted, even though the

same source is accepted when using the -r option.

For example, do not post an event if it does not contain a name with at least three components because

the daemon rejects it. However, such an event can exist, and

evmpost can create it and pass it to

stdout. The following example fails because it does not contain a name:

echo ’event { }’ | evmpost

evmpost: Error in input file "standard input", line 1

evmpost: Error: Event name is missing

HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (4 pages)

PAGE 1
evmpost(1) evmpost(1) NAME evmpost - post events to the EVM daemon SYNOPSIS evmpost [-r [-m|-M]] [[-a|-u msg [-p priority ]] | [filename| -]] DESCRIPTION The evmpost command takes a file or stream of text event sources as input and converts them to binary EVM events. By default, the command then posts them to the EVM daemon for distribution. If the -r option is specified, evmpost writes the EVM events to its stdout stream instead of posting them to the daemon.
PAGE 2
evmpost(1) evmpost(1) The following example is successful, even though it does not display any useful information: echo ’event { }’ | evmpost -r | evmshow Unformatted event "(no name)"; The -r option can verify event source and template files by piping the output into evmshow. See evmshow (1). Options Does not post the events, but instead passes them directly to stdout as raw EVM events. -r An error occurs if stdout is directed to a terminal device.
PAGE 3
evmpost(1) evmpost(1) evmpost -a "Power outage recovery completed" -p 250 • The following example posts a quick user’s message. evmpost -u "Leaving for lunch." • This example posts an event that includes a variable. evmpost << EOF event { name myco.ops.backup.ok var { name backup.
PAGE 4
(Notes) A (Notes) eA 4 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2010