evmget.1 (2010 09)

e
evmget(1) evmget(1)
NAME
evmget - retrieve stored events
SYNOPSIS
evmget [-A [-t show_template]] [
-e][
-f filter_expr ][-s sort_spec ][-C channel-list ]
DESCRIPTION
The
evmget command retrieves stored events and outputs them to
stdout as EVM events. Events are
obtained from a configured set of log files and event channels, using channel-specific retrieval functions
as specified in the channel configuration file,
/etc/evmchannel.conf
.
If the
-A option is specified,
evmget automatically starts
evmsort -A and pipes the event stream into
it, producing a sorted and formatted display of events. If the show_template or sort_spec arguments are
supplied, these strings are passed to
evmsort
through its own -t and -s options. See evmsort (1) and
evmshow(1) for more information.
To review events that are available from a particular set of event channels (for example, an event channel
that retrieves events from application logfiles), use the
-C option to specify the channels to be searched.
This may reduce the overall retrieval time, as it avoids the need to search channels in which you have no
interest.
If a channel does not have an
fn_get
keyword defined in its channel configuration, then no events are
returned for that channel.
A channel-list is a list of one or more channel names, separated either by commas, or if the list is
enclosed in quotes, by space or tab characters. Supply multiple channel lists by specifying the
-C
option
more than once. Use the
evminfo -lc command to see a list of configured channels.
Because events may be retrieved from more than one source, there is no guarantee that they returned in
any particular order, unless the
-A option is used or the output event stream is piped through
evmsort.
Options
-A Automatically starts evmsort -A to produce a sorted and formatted display of the
retrieved events.
-e Terminates after validating the supplied command operands. This feature can be
used to check the syntax of a filter expression.
-f filter_expr Outputs only events that match the filter_expr . See EvmFilter (5) for the syntax of
filter_expr .
-t show_template Template string to be passed to
evmsort if the -A option is also specified. If the
-A option is not specified, this argument is ignored. See evmshow (1) for a descrip-
tion of the template string.
-s sort_spec Sort specification string to be passed to evmsort if the -A
option is also specified.
If the
-A option is not specified, this argument is ignored. See evmsort (1) for a
description of the sort specification.
-C channel-list Specifies that events should be retrieved only from channels whose names are
included in the channel-list . Refer to the DESCRIPTION section for more details of
this option and the syntax of the channel-list .
RETURN VALUES
The following exit values are returned:
0 Successful completion.
not 0 An error occurred.
EXAMPLES
• The following example uses
evmget to retrieve events, automatically piping the events through
evmsort and evmshow to produce a sorted and formatted list of events.
evmget -A
• In the following example, all available events are retrieved and piped to evmsort and evmshow for
sorting and formatting. The events are sorted into the default timestamp order, and displayed with
the timestamp at the start of each line.
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1