Event flow

IBM® Business Process Manager emits monitoring events, which are sent to a Java Messaging Service (JMS) queue and then used by Business Monitor. The JMS queue and a corresponding JMS queue connection factory are created automatically during installation of Business Monitor. When IBM BPM detects the presence of the JMS queue and the JMS queue connection factory, IBM BPM begins to emit events while executing a process application that has been enabled for business monitoring.

The flow of a monitoring event from IBM Business Process Manager to Business Monitor is illustrated in the following diagram.

When Business Monitor and IBM Business Process Manager are installed and configured into the same stand-alone server or network deployment environment, the JMS resources required to enable the flow of events from IBM Business Process Manager to Business Monitor are automatically configured. The configuration occurs during profile creation in the case of a stand-alone server profile. In a network deployment environment, the configuration occurs after configuring and generating a deployment environment. In both cases, the JMS resources are configured to use the default messaging provider. You can manually reconfigure the JMS resources to point to a different messaging provider, such as WebSphere MQ.

Default JMS queue in IBM Business Process Manager

IBM Business Process Manager looks for a JMS queue and JMS queue connection factory with the following JNDI names:

jms/com.ibm.lombardi/EventEmissionQueue
jms/com.ibm.lombardi/EventEmissionQueueFactory

Events are emitted only when the JMS queue and connection factory are present and available to IBM Business Process Manager.

Default JMS queue configured as an input queue in Business Monitor

Business Monitor includes an application called IBM_BPM_EMITTER_SERVICE, which reads events from a JMS queue and submits them to Business Monitor. To ensure that events in the JMS queue can flow to Business Monitor, the following queue, queue connection factory, and activation specification must point to the same JMS queue (jms/com.ibm.lombardi/EventEmissionQueue) that is the destination for events emitted by IBM Business Process Manager:

jms/com.ibm.lombardi/JMSEmitterInput
jms/com.ibm.lombardi/JMSEmitterInputQueueFactory
jms/com.ibm.lombardi/JMSEmitterInputActivationSpec

For more information about configuring the IBM_BPM_EMITTER_SERVICE, refer to the related topic "Configuring the environment using wsadmin commands."

Event flow configuration

When IBM Business Process Manager Standard and Business Monitor are deployed in separate WebSphere® Application Server cells, advanced configuration of the JMS resources is required so that the queue with the events is accessible from both cells. You can create this configuration using either an external messaging provider, such as WebSphere MQ, or using the default messaging provider and an SI bus link. For more information about this advanced configuration, refer to the related topic "Configuring event flow to a remote server."

When IBM Business Process Manager Advanced and Business Monitor are deployed in separate WebSphere Application Server cells, you can use the techniques described for IBM Business Process Manager Standard. However, you have an additional configuration option, which is to have events emitted to the Comment Event Infrastructure (CEI) event service that is already configured within the IBM Business Process Manager Advanced cell. You then configure your Business Monitor model to receive the events that were emitted to the CEI event service by way of table-based event delivery. For more information about this advanced configuration, refer to the related topic "Configuring event flow to a remote server."

Disabling event flow

You can prevent IBM BPM from emitting events for a specific process application, or you can prevent the server from emitting events. By default, events are emitted if any of the following conditions are true for the process application:

The option Enable for Business Monitoring is selected on the Process Apps Settings page.
The process application includes a custom monitor model.
Auto-tracking is enabled for at least one business process definition in the process application.
A business process definition includes one or more intermediate tracking events.
The JMS queue named jms/com.ibm.lombardi/EventEmissionQueue exists. This queue is created automatically when the IBM BPM profile is augmented with Business Monitor in a single-cell environment.
Business Monitor is installed.

To disable event emission for a process application, you must clear the Enable for Business Monitoring check box in the Process Apps Settings page, turn off auto-tracking in the process application, and remove any auto-tracking events from the business process definition. Also, if a custom monitor model exists, use IBM Integration Designer to disassociate it from the process application.

To disable event emission for the server, update the 100Custom.xml configuration file, as described in the following steps:

Locate the 100Custom.xml file in the following directory:
PROFILE_HOME\config\cells\cell_name\nodes\node_name\servers\server_name\profile-type\config
where profile-type is one of the following values:
- process-center
- process-server

Copy the following configuration property and paste it into the 100Custom.xml file as a child of the <common> element:

<monitor-event-emission>
  <enabled merge="replace">false</enabled>
</monitor-event-emission>

Note: If the <common> element is not already in the file, add it. The following is an example of the file:

<properties>
 <common merge="mergeChildren">
  <monitor-event-emission>
    <enabled merge="replace">false</enabled>
  </monitor-event-emission>
 </common>
</properties>

Restart the server so that the changes will take effect.