event history, eventhistory, kPMEventHistory — Event history.


event history structure { event ID, last triggered, last started, last finished, trigger count, perform count };
event ID : string, length 1..255
last triggered : date, optional
last started : date, optional
last finished : date, optional
trigger count : integer, optional
perform count : integer, optional


Event history.

A history of each event is kept. The history represents the behaviour of the event with a given unique ID. The history is maintained for as long as the event exists.


event ID. Unique identifier of the represented event.

The event ID is included to help clients issuing multiple event history requests track responses.

event ID is a string. event ID must be between 1 and 255 characters long, inclusive.

last triggered. Date the event was last triggered.

The most recent date the event was triggered. If an event has multiple triggers, this date refers to the most recent trigger.

If last triggered is not present, the event has not been triggered.

last triggered is a date. last triggered is optional.

last started. Date the event was last performed.

The most recent date the event started performing. The event will perform if triggered, and then only if all the conditions are met. last started represents the date the trigger and conditions were successfully met.

If last started is not present, the event has not been performed.

last started is a date. last started is optional.

last finished. Date the event last finished performing.

The most recent date the event finished performing.

last started may be more recent than last finished. This can happen when an event may be performed concurrently; one instance finished while a second started slightly later and is still running.

If last finished is not present, the event has not finished being performed.

last finished is a date. last finished is optional.

trigger count. Number of times the event has been triggered.

An event may be triggered may times before its conditions are met. This value is incremented each time an event's trigger is fired, regardless of whether any conditions are met.

trigger count is an integer. trigger count is optional.

perform count. Number of times the event has been performed.

Count of the number of times an event has been triggered, and any conditions are met.

The count is incremented when the event's performance begins.

perform count is an integer. perform count is optional.