|HP-UX Reference > E
evmget(1)HP-UX 11i Version 3: February 2007
evmget — retrieve stored events
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.
The following exit values are returned:
evmget -A -C my_log -f "[name *.evmdaemon]" -t "@timestamp @@"
evmget -f "[priority >= 500]" \ | evmsort -s @timestamp- > my_eventfile
evmget -f "@sys:evm" | evmsort | evmshow -t "@timestamp @@"
export EVM_SORT_SPEC="@priority" export EVM_SHOW_TEMPLATE="@timestamp @@" evmget | evmsort -A
The evmget command retrieves only events for which the user has access authorization. See evm.auth(4) for details of access authorization.
The evmget command rejects attempts to output raw events to a terminal device.
evminfo(1), evmpost(1), evmshow(1), evmsort(1), evmwatch(1).