evmpost(1)						      General Commands Manual							evmpost(1)

NAME

       evmpost - post events to the EVM daemon

SYNOPSIS

       msg priority]] | [filename|

DESCRIPTION

       The  command  takes  a  file or stream of text event sources as input and converts them to binary EVM events.  By default, the command then
       posts them to the EVM daemon for distribution.

       If the option is specified, writes the EVM events to its stream instead of posting them to the daemon.  By default,  attempts  to  retrieve
       event  template	information  from the EVM daemon and merges the template items and environmental items such as and into the output events.
       If the option is used, the output events contain only the items specified in the source.

       An event source may contain any number of events.  Each event is specified in the manner shown.	See the EvmEvent(5)  manpage  for  a  more
       detailed explanation.

       The command recognizes the following data items in an event source:

	      o
	      o
	      o
	      o
	      o
	      o
	      o
	      o
		 o
		 o

       All EVM variable types may be specified except for Refer to EvmEvent(5) for details on data items and variables.

       In  the	event  source,	each keyword must be accompanied by a corresponding value.  The value must be enclosed in double quotes ("") if it
       contains white space.  The data item keywords that are specified outside the event body are taken as global values.  The data item keywords
       are included in each of the following events which do not have an explicit value defined for that keyword.

       Comments are indicated by a leading character.  Blank lines are ignored.

       The  command builds an EVM event containing the items that are explicitly specified in the source.  If the event is posted or if the option
       is specified without additional environmental items such as the and template items are inserted into the event automatically.

       The rules for posting an event are more stringent than those for an event simply to exist.  Therefore, may display an error when trying	to
       post an an event that cannot be posted, even though the same source is accepted when using the option.

       For  example,  do  not  post an event if it does not contain a name with at least three components because the daemon rejects it.  However,
       such an event can exist, and can create it and pass it to The following example fails because it does not contain a name:

       The following example is successful, even though it does not display any useful information:

       The option can verify event source and template files by piping the output into See evmshow(1).

   Options
       Does not post the events, but instead passes them directly to
		 as raw EVM events.

		 An error occurs if is directed to a terminal device.

       When used with the
		 option, causes event template items and environmental values to be merged with the items included in the  source.   This  is  the
		 default mode.

       When used with the
		 option, inhibits the merging of template items and environmental values.

       Posts an administrator's quick message event with the name
		 and  the string msg in a variable data item.  If a message contains spaces, the message must be enclosed in quotation marks ("").
		 The event is used to add a message entry in the event log.  This option may be used only by privileged users.

       Posts a user's quick message event with the name
		 and the string msg in a variable data item.  If a message contains spaces, the message must be enclosed in quotation marks  ("").
		 The event is used to add a message entry in the event log.

       Assigns	 priority  as  the  for an administrator's or user's quick message.  The priority value must be an integer in the range 0-700.	If
		 the priority is not specified, the default of 200 is used.

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

RETURN VALUES

       The following exit values are returned:

       Successful completion.
       An error occurred.

EXAMPLES

       o  The following example posts an event, provided that a template file containing an event with a matching name has  been  registered  with
	  the EVM daemon.

       o  The  following  example interprets an event template file, and displays a dump of the contents of each event.  Environmental items, such
	  as a timestamp, are not merged into the event.  This command checks the syntax and contents of the file.

       o  The following example shows how is used in a shell script to signal completion of some operation:

       o  The following example must be run as to post an administrator's message event.

       o  The following example posts a quick user's message.

       o  This example posts an event that includes a variable.

	  If the template for this event contains the following format data item:

	  then displays this event as:

WARNINGS

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

       Post only events for which you have posting authorization, and for which a template exists.

FILES

       Definition of the sockets and protocols used for Internet services

       Location of the EVM authorization file

SEE ALSO

   Commands
       evmget(1), evminfo(1), evmshow(1), evmsort(1), evmwatch(1).

   Routines
       EvmEventPost(3).

   Files
       evmdaemon.conf(4), evmtemplate(4), services(4).

   Event Management
       EVM(5).

   EVM Events
       EvmEvent(5).

																	evmpost(1)