evmwatch(1)						      General Commands Manual						       evmwatch(1)

NAME

       evmwatch - monitor EVM events

SYNOPSIS

       show_template]] filter_expr] channel-list] timeout] reconnect-timeout]

DESCRIPTION

       The  command subscribes to the events specified by the option and passes all events to its stream as they arrive.  Output is in the form of
       raw EVM events.

       If the option is specified, automatically starts and pipes the event stream into it,  producing	a  formatted  display  of  events.   If  a
       show_template  argument	is  supplied, the specified template string is passed to through its own option.  See evmshow(1) for more informa-
       tion.

       If cannot connect to the EVM daemon, it terminates immediately with an error message.  If it succeeds in connecting but subsequently  loses
       the  connection,  it attempts to reconnect periodically until the reconnect-timeout period expires.  The retry period is one second for the
       first minute, and five seconds thereafter.

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

       Subscribes for notification of events matching
		 filter_expr.  See EvmFilter(5) for the syntax of filter_expr.	By default, the command subscribes for all events.

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

       Terminates if no event is processed in the time specified by
		 timeout.   The format of timeout is [[[dayshoursminutesseconds, where days, hours, and minutes can be any integer up to 9999, and
		 seconds can be any integer up to 9999999.  Omitted values are interpreted as zero.  If the converted  value  exceeds  100,000,000
		 seconds,  it  is  automatically reduced to that value with no error being reported.  The timer is restarted each time an event is
		 received.

       Retrieves copies of all of the registered event templates from the EVM
		 daemon that match the supplied filter string and for which the user has access authorization.	It writes the templates to as  EVM
		 events and terminates.

       Terminates with a zero exit value as soon as the first event matching
		 filter_expr is processed.

       Specifies the period for which
		 should  continue  to  attempt	to  reconnect  if  the	connection  to the EVM daemon is lost.	The format of reconnect-timeout is
		 [[[dayshoursminutesseconds, where days, hours, and minutes can be any integer up to 9999, and seconds can be any  integer  up	to
		 9999999.   Omitted  values  are  interpreted  as  zero.   If the converted value exceeds 100,000,000 seconds, it is automatically
		 reduced to that value with no error being reported.

		 If reconnect-timeout is zero, terminates immediately if a disconnection occurs.  If this option is not specified,  the  reconnec-
		 tion timeout is set to five minutes.

RETURN VALUES

       The following exit values are returned:

       Successful completion
       An error occurred, including timeout.

EXAMPLES

       o  The following example watches for all events with a priority of at least 200 and displays them on Events are piped automatically through
	  to produce a formatted event display.

       o  The following example shows how waits until another process posts a particular event and  then  continues.   Redirection  of	output	to
	  implies that the content of the event is of no concern.

	      The  following  script builds on the prior example.  It waits for five minutes (300 seconds) for the event to occur or exits as soon
	      as the event happens.

       o  The following shell script waits for up to five minutes (300 seconds) for a pulse event to be received.  Each time  the  pulse  arrives,
	  the  timer  is  reset and waits for the next pulse.  If the timer expires, terminates with an error code, a warning is displayed, a high
	  priority event is posted, and the script exits.

       o  The following example lists the names of all registered events that the user is authorized to access.

WARNINGS

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

       The command receives events only for which the user has access authorization.  See evm.auth(4) for details of access authorization.

FILES

       Definition of the sockets and protocols used for Internet Services

SEE ALSO

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

   Files
       evmfilterfile(4), services(4).

   Event Management
       EVM(5).

   EVM Events
       EvmEvent(5).

   Event Filter
       EvmFilter(5).

																       evmwatch(1)