The WebSphere Partner Gateway system has two different types of events: document events and message events.
Document events are events directly associated with a business document. The Business Processing Engine is responsible for publishing these events to a WebSphere Partner Gateway internal queue. In the case of either a Sent or a Failed document state, the Delivery Manager also publishes business document events to this queue.
Message events, on the other hand, are published by all components of WebSphere Partner Gateway. Message events are not necessarily related to a business document, although one or more message events can be associated with a business document.
Events that are published to the internal queue are sent by the event server to WebSphere Partner Gateway's event store. You can have events delivered to an external JMS queue. Turning external delivery on and off and configuring the external queue are done in the Community Console. See the WebSphere Partner Gateway Hub Configuration Guide for help in setting up this up.
Events are delivered to the JMS queue in Common Base Event (CBE) XML format. CBE format is a part of a larger evolving IBM initiative, the Common Event Infrastructure (CEI), designed to standardize the handling of events across applications. CBE structure covers three basic types of information:
The specifics of the CBE format as it is used in external event delivery are detailed in The structure of delivered events.
If external delivery is turned on, all events are delivered to the external queue. The visibility flag, which limits which type of user can see which type of event in the Community Console Event Viewer, is not used in external delivery. Event names and descriptions in external delivery are localized in the same manner as they are in the Event Viewer.
Incorrect JMS configuration and JMS provider problems can cause errors in external event delivery. If they are not detected on startup, and an external delivery error occurs, the following happens: