This describes how you delete a broker profile and all topic mappings
on a WebSphere® MQ
link, which forms a publish/subscribe bridge between
WebSphere Application Server and
a
WebSphere MQ network.
Before you begin
Before you start you have to know the names of the bus, messaging
engine, and WebSphere MQ
link that has the broker profile that you intend to delete. You should also
consider informing the
WebSphere MQ administrator
that you are about to delete the connection to the message broker in the
WebSphere MQ network.
If you also
intend to delete the associated WebSphere MQ link, you need not complete this
task. Refer instead to Removing a foreign bus connection from a bus.
About this task
Deleting a broker profile is a three-stage operation to ensure
both the application server and the
WebSphere MQ network
and its message brokers are synchronized after the deletion:
- Remove the subscriptions by unsubscribing the topic mappings on the broker
profile.
- When the Runtime view is empty, delete the broker profile.
- If you have enabled dynamic configuration updates, the changes take effect
immediately, otherwise restart the application server.
Note: If you remove the subscriptions but do not delete the broker profile,
then the subscriptions are recreated when the server is restarted (because
they are still present in the static configuration information for the WebSphere MQ
link). These subscriptions are unrelated to the original subscriptions so
this can lead to some messages in a publication flow being missing for subscribers
on the target side of the bridge. For example, any messages published on an
unsubscribed topic between the time the unsubscribe took place and the application
server was restarted are not republished to the target side of the WebSphere MQ
link.
Procedure
-
Start the administrative console.
-
In the navigation pane, click
.
-
Remove the subscriptions:
-
Click the Runtime tab.
-
Click Subscriptions.
-
Click Unsubscribe to remove all the subscriptions
listed.
When an unsubscribe command is sent to the message broker
in the
WebSphere MQ network, the
relevant topic mapping is put into an indoubt state until the unsubscribe
is confirmed when the topic mapping is deleted. After the unsubscribe is confirmed
the topic mapping is no longer shown in the runtime view. You might have to
refresh the runtime view for all subscriptions to be shown as removed.
-
Delete the broker profile:
-
Return to the Publish/subscribe broker profiles page.
-
Select the check box next to the broker profile you want to
delete.
-
Click Delete.
-
Save your changes to the master configuration.
-
If you have enabled dynamic configuration
updates, the changes take effect immediately. Otherwise, restart the application
server.