|
|
Posting as Anshaa
|
|
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)
