HP-UX Reference (11i v3 07/02) - 5 Miscellaneous Topics (vol 9)

e
EvmEvent(5) EvmEvent(5)
NAME
EvmEvent - structure of an EVM event
DESCRIPTION
An EVM event is a self-contained data structure, which can be manipulated and accessed using EVM API
functions. Application code can:
• Create, duplicate and destroy an event.
• Set and retrieve the values of standard data items contained within the event.
• Add variable data items to the event, and set and retrieve their values.
• Post the event to the EVM daemon for distribution to subscribers.
• Read events from an open file descriptor.
• Write events to an open file descriptor.
Command line utilities are provided that allow users access to these capabilities.
The Contents of an Event
The event structure includes two types of data items:
1. Standard data items, with predefined names
2. Variable data items, with names and types defined at the time they are added to the event
When you create an event you can include as many data items as you like. When you post the event,
the API functions automatically add the standard items which pertain to the current environment,
such as the host name and timestamp.
Standard Data Items
Standard data items are those which are commonly required in an event, and which are understood and
may be acted upon by EVM. The following table is a list of the standard data items that may be contained
in an event. The identifier is the keyword used to post, display, or format the item.
Data Item ID Description
Names the event. Must match a name in the daemon’s
template database if the event is to be posted.
Event Name NAME
UNIX system time when the first occurrence of this event
was generated.
Time Posted TIMESTAMP
Number of instances of the same event that have been
combined into a single stored event. The Time Posted
and Last Timestamp items indicate when the first and
last instances of the event were posted.
Repeat Count REPEAT_COUNT
If Repeat Count is present and non-zero, the system time
when the latest occurrence of this event was generated.
Last Timestamp LAST_TIMESTAMP
Identifies the event. See the description following this
table.
Event Identifier EVENT_ID
If present and EvmTRUE for an event generated in the
kernel, the event is not propagated from the kernel to
user space.
Kernel Only KERNEL_ONLY
PID of the process which posted the event.Process ID PID
PID of the parent of the process which posted the event.Parent Process ID PPID
Name of the owner of the posting process.User name USER_NAME
Indicates the importance of the event. Does not affect the
order of event distribution. See the description following
this table.
Priority PRIORITY
Name of I18N catalog file for internationalized events.I18N catalog I18N_CATALOG
Identifies the message set within the I18N message cata-
log.
I18N message set ID I18N_SET_ID
150 Hewlett-Packard Company − 1 − HP-UX 11i Version 3: February 2007