ObjectEventNotification(3tlib)

ObjectEventNotification -- register notification function

Synopsis

ObjectEventNotification callbackFunction eventType

Description

ObjectEventNotification is used to register a function that will be called by the SCOadmin framework if an OSA sends any events while it is processing an object request. The function is called with one parameter, which is a BMIP response which can be examined using the Bmip(3tlib) routines.

Arguments

callbackFunction: function which is called if an OSA sends an event of the specified type.
eventType: type of event which will be handled by the callback. The value of eventType can be either ``warning'' or ``notification''.

The significant fields are:

the action type, which can be either ``notification'' or ``warning'' depending on what type of event was sent.
the action data, which is the message sent by the event
the error stack, which is sent if an error was caught by the OSA by OFCatchBmipEvent.

Examples

proc warningEventHandler event {
       echo "An event was sent of type " [BmipResponseActionType event]
       echo "The message was " [BmipResponseActionData event]
       echo "The error stack (if any) was " [BmipResponseErrorStack event]
}

ObjectEventNotification warningEventHandler warning

References

OFEvent(3tlib), Bmip(3tlib)