evmsort(1)						      General Commands Manual							evmsort(1)

NAME

       evmsort - sort events

SYNOPSIS

       show_template]] sport_spec] [filename |

DESCRIPTION

       The  command  reads  and  sorts	a  stream  of EVM events.  By default, events are read from and are sorted into ascending timestamp order.
       Sorted events are written to the command's stream in the form of raw EVM events.

       The sort order can be specified by supplying a sort_spec, either through the option or by setting the environment variable to the  required
       specification.  The specification is a character string of the form:

       key_item[

       The key_item is the name of any EVM standard data item and the character is optional.

       If the special key_item is specified, the event's data item is expanded as described in the evmshow(1) manpage, and the resulting string is
       used as the sort key.

       The optional trailing or character indicates ascending or descending sort.  By default, items are sorted in ascending order.

       Multiple items in the string are separated by colon characters The left-most key_item in the specification is the most significant key.

       If a key_item that is included in the sort specification is not present in an event read from the input stream, the item is  considered	to
       have  a	low value for that event.  For example, if input events are being sorted in ascending order according to their data items, and one
       event does not contain a name, that event appears first in the output stream.

       If the option is specified, automatically starts and pipes the sorted event stream into it, producing a sorted  and  formatted  display	of
       events.	If a argument is also specified with the specified template string is passed to through its own option.

       See the evmshow(1) manpage for more information.

   Options
       Automatically starts
		 to produce a formatted display of the sorted events.

       The specification to be used in sorting events.
		 See the section for the syntax of the sort_spec, and for details of the default sort order.

       Template string to be passed to
		 if  the  option  is also specified.  If the option is not specified, this argument is ignored.  See the  evmshow(1) manpage for a
		 description of the template string.

   Operands
       filename  Reads event sources from filename.  If filename is omitted, or is specified as event sources are read from

EXTERNAL INFLUENCES

   Environment Variables
       The following environment variables affect the execution of

       This variable contains a string formatted as described for a
			   sort_spec.  If the option is omitted, the string is used as the sort_spec.

RETURN VALUES

       The following exit values are returned:

       Successful completion.
       An error occurred.

EXAMPLES

       o  The following example retrieves all events with a priority of 300 or greater, sorts them into descending order of priority (most  urgent
	  event first) and then ascending order of time (oldest event first), and automatically runs to display them.

       o  The following example yields a list of all events, sorted with the latest event first within

       o  The  following example yields a list of all events, sorted first in order of their formatted messages and then sorted in ascending order
	  of time.  Events are passed to for display and subsequently to the command for viewing.

WARNINGS

       The command rejects attempts to output raw events to a terminal device.

SEE ALSO

   Commands
       evmget(1), evmpost(1), evmshow(1), evmwatch(1).

   Files
       evmchannel.conf(4).

   Event Management
       EVM(5).

   EVM Events
       EvmEvent(5).

   Event Filter
       EvmFilter(5).

																	evmsort(1)