HP-UX Reference (11i v3 07/02) - 1 User Commands A-M (vol 1)

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 description 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 descrip-
tion 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: February 2007 − 1 − Hewlett-Packard Company 301