Use this task to delete, from a service integration bus,
a bus destination that is not for a topic space.
Before you begin
You cannot delete bus destinations that are required by
the system; for example, the default exception destination for a messaging
engine: _SYSTEM.Exception.Destination.messaging_engine_name.
Before
you can completely delete a bus destination, you must ensure that
the destination message point is empty of all messages. A delete action
is rejected if there are any messages on the message point that are
committed, uncommitted, indoubt, or locked.
Any reliable or
durable messages that are sent after the delete action, but before
the close of producers, are sent to one of the following destinations:
- Another message point of the destination, if possible.
- The exception destination for the deleted destination.
About this task
To delete a destination, use the administrative console
to complete the following steps.
Procedure
- Click .
- Select the check box next to the destination name.
- Check for and resolve any locked messages. Messages
that are locked, as part of in-flight transactions or as indoubt messages,
are not deleted.
- To clear all messages from the destination, click Clear.
This action deletes all of the messages that it can access.
Messages that are locked, part of in-flight transactions or are in
doubt are not deleted. If there are messages that cannot be deleted,
they are skipped and the operation indicates that it was partially
successful.
- To delete the empty destination, click Delete.
- To confirm that you want to delete the destination click OK.
Results
The bus destination is deleted.
What to do next
Monitor the exception queue for the messaging engine to which
the destination was assigned, to see if there are any in-transit messages
that were not handled by clearing the destination before it was deleted.