Configure WebSphere® Application Server and IBM® Integration Bus so that you can
view and act on events that are emitted by a local mapping service.
Before you begin
You can configure your local
mapping service to emit events, which are useful for monitoring and
archive purposes. For more information about when the events are emitted
and the ways you can consume these events, see Event emissions when using service mapping. Follow the steps in
this task if you want to use the data capture functions in IBM Integration Bus to view and process
the events.
About this task
To configure WebSphere Application Server to
produce events that can be consumed by IBM Integration Bus, you must configure
JMS resources that connect to the WebSphere MQ queue manager of IBM Integration Bus and publish messages
to a WebSphere MQ topic.
The
following steps describe a simple case where you connect directly
to the IBM Integration Bus queue
manager, and assume that no security settings are applied. For more
information about topologies for producing messages from WebSphere Application Server to a WebSphere MQ system, see Network topologies:
Interoperating by using the WebSphere MQ messaging
provider.
Procedure
- Configure a WebSphere MQ messaging
provider unified connection factory. For more information, see Creating a connection
factory for the WebSphere MQ messaging
provider and Configuring a unified connection factory for the WebSphere MQ messaging provider.
Ensure that you provide the following details:
- If you are creating a new unified connection factory,
ensure that you choose the option that lets you enter all the required
information into the wizard.
- Ensure that you choose Client as
the WebSphere MQ transport
type.
- Specify the correct queue manager name, channel name,
host name, and port for the WebSphere MQ queue
manager of the IBM Integration Bus instance
that you are connecting to.
- Make a note of the name that you specify in the JNDI
name field. You must provide the same value for the -connectionFactory parameter
when you run the createLMServiceEventPoint command.
- To include
message data in events, you must create the WebSphere variable SM_EVENT_POLICY_PERMIT_MESSAGE_DATA and
set its value to true. For a Network Deployment
environment, the scope of the WebSphere variable
definition determines whether the policy is applied to all nodes in
the cell, or to individual clusters or servers. For information about
managing WebSphere variables,
see Creating,
editing, and deleting WebSphere variables.
- In your IBM Integration Bus installation,
create a DataCaptureSource configurable service and a DataCaptureStore
configurable service. For more information, search for "DataCaptureStore
configurable service", "DataCaptureSource configurable service", and
"creating a new configurable service" in the IBM Integration Bus information
center.
What to do next
You have now configured WebSphere Application Server to publish service
mapping events so that IBM Integration Bus can
consume them. You must also configure WebSphere Application Server to emit the events
by creating and enabling an event point. You can control the contents
of the events when you create the event point. Follow the steps in Creating an event point on a local mapping service by using the command line.