TIBCO Adapter SDK C++ Reference
MHawkMicroAgent::sendNotification
MHawkMicroAgent
A notification is a text message posted by a TIBCO Hawk agent as a consequence of processing an action in a rulebase. The notification is detected and displayed by any listening TIBCO Hawk Display program.
Remarks
Applications usually only respond to messages they receive from TIBCO Hawk. This method allows applications to send a notification to TIBCO Hawk. Applications using this method can asynchronously send messages without previous input from TIBCO Hawk.

The notification type is one of:

  • M_HAWK_INFO

  • M_HAWK_WARNING

  • M_HAWK_ERROR
The subject for the unsolicited messages should be _HAWK.AMI> .The last field may differ based on the notification type (INFO, WARNING, ERROR, and so forth), the ">" sign

To see the notification on a Hawk display, you can either write a Hawk rulebase subscribing to the _onUnsolicitedMsg() method of the microagent or you can invoke the _onUnsolicitedMsg() method of the microagent to see the last trace message received.

See TIBCO Hawk documentation for details.

Parameters
Parameters Description
MHawkNotificationType notificationType Type of notification to be sent. One of M_HAWK_WARNING, M_HAWK_ERROR, M_HAWK_INFO.
const MString& sNotificationText Notification text to be sent. Must be an MString.
int notificationId = 0 ID of the notification to be sent. Default is 0.
Declaration
void sendNotification(MHawkNotificationType notificationType, const MString& sNotificationText, int notificationId = 0) const throw(MException);
Links
Copyright (c) 2010 TIBCO Software Inc. All rights reserved.