Network Deployment (Distributed operating systems), v8.0 > Administer applications and their environment > Administer Messaging resources > Manage messaging with the default messaging provider > Interoperating with a WebSphere MQ network > Use WebSphere MQ links to connect a bus to a WebSphere MQ network > Administer an existing WebSphere MQ link > Modify a WebSphere MQ link > Set a publish/subscribe broker on the WebSphere MQ link
Set topic mappings on the WebSphere MQ link publish/subscribe broker
Overview
Define topic mappings on a publish/subscribe broker profile, part of the publish/subscribe bridge on a WebSphere MQ link. A topic mapping is a mapping between a topic on a service integration bus and a stream queue and subscription point provided by a WebSphere MQ broker.
You have to know...
- Bus name
- Messaging engine name
- WebSphere MQ link name
- Broker profile name
Topic mappings are associated with a WebSphere MQ link publish/subscribe broker profile.
Together, the profile and topic mappings enable publication and subscription with a broker in a WebSphere MQ network.
Publication messages forwarded to a message broker in the WebSphere MQ network are republished on the same topic as they were originally published to in the service integration bus topic space, and vice versa.
Define topic mappings
- In the navigation pane, click Service integration -> Buses -> bus_name -> [Topology] Messaging engines -> engine_name -> [Additional properties] WebSphere MQ links -> link_name -> [Additional Properties] Publish/subscribe broker profiles -> profile_name -> [Additional Properties] Topic mappings
- In the content pane, either click New to add a new topic mapping, or click the name of a existing topic mapping to modify. The Topic Mapping [Settings] form is displayed.
- Type the topic name.
The name of the topic on the service integration bus. The name must be the same as the topic name on the message broker in a WebSphere MQ network.
The topic name can contain wild cards that are in the service integration bus syntax. See Wild cards in topic mapping.
- Select the name of the topic space that contains the topic. If you don't select a name the default is used.
- Select the direction of publication flow. The direction of publication flow can be:
- Bi-directional
- Messages flow in both directions between the bus and WebSphere MQ.
- To WebSphere MQ
- Messages flow only from the bus to WebSphere MQ. That is, from WAS to a message broker in the WebSphere MQ network.
- From WebSphere MQ
- Messages flow only to the bus from WebSphere MQ. That is, from a message broker in the WebSphere MQ network to WAS.
- Select the broker stream queue to use. If the queue you require is not on the list, click other, please specify then enter the name of the broker stream queue.
The broker stream queue in this instance is a queue on the WebSphere MQ queue manager to which the message broker is connected. This queue is being used as the input node for a message flow containing a publication node. Messages sent to this queue are processed by the message broker, then published to applications that have subscribed on the topic specified in the message.
Stream names are case sensitive.
After you type a new name, then save your changes, the name becomes available for selection in the drop-down list.
- Select the WebSphere MQ message broker subscription point from which the service integration bus receives messages. If the subscription point you require is not on the list, click other, please specify then enter the name of the subscription point.
The default subscription point is used if no value is specified.
After you type a new name, then save your changes, the name becomes available for selection in the drop-down list.
- Click OK.
- Save your changes to the master configuration.
- Optional: If we have enabled dynamic configuration updates, the changes take effect immediately. Otherwise, restart the application server.
Wild cards in topic mapping
Create topic space mappings
Configure topic space mappings between service integration buses
Connect a bus and a WebSphere MQ network to use publish/subscribe messaging
Related
Topic names and use of wildcard characters in topic expressions
Topic Mapping [Collection]
Topic Mapping [Settings]