Event notifications are received from the Domain Manager when the status of an event changes. The format of the notification record is shown in Notification record - NOTIFY.

Table 1. Notification record - NOTIFY

Event record entry

Description

$event[0]

Timestamp (INTEGER)

$event[1]

“NOTIFY”

$event[2]

Object class name (STRING)

$event[3]

Object instance name (STRING)

$event[4]

Event name (STRING)

$event[5]

Event certainty (FLOAT)

Normally, the Domain Manager sends a single notification message when an event becomes active and a single clear message when the event is no longer active. If an event corresponds to a root-cause problem, it is possible that the certainty of the diagnosis will change over time. If the diagnosis certainty changes, the Domain Manager generates another notification. Notifications of this type are streamed in a slightly different manner. This difference in behavior is a feature of the front-end Perl API, not the Domain Manager. The Domain Manager sends NOTIFY messages in both cases. The API keeps internal notes about active events, and changes the event type accordingly, as shown in Notification record - CERTAINTY_CHANGE.

Table 2. Notification record - CERTAINTY_CHANGE

Event record entry

Description

$event[0]

Timestamp (INTEGER)

$event[1]

“CERTAINTY_CHANGE”

$event[2]

Object class name (STRING)

$event[3]

Object instance name (STRING)

$event[4]

Event name (STRING)

$event[5]

Event certainty (FLOAT)

Notification record - CLEAR describes the format of the record when an event is cleared by the Domain Manager.

Table 3. Notification record - CLEAR

Event record entry

Description

$event[0]

Timestamp (INTEGER)

$event[1]

“CLEAR”

$event[2]

Object class name (STRING)

$event[3]

Object instance name (STRING)

$event[4]

Event name (STRING)