Use this task to delete, from a service integration bus, a bus destination that
is not for a topic space.
You cannot delete bus destinations that are required by the system; for example, the default
exception destination for a messaging engine: _SYSTEM.Exception.Destination.me_name.
Before
you can completely delete a
bus destination, the following conditions must be satisfied:
- The destination message point must be empty of all messages.
A delete action is rejected if
there are any messages on the message point, either committed, uncommitted, indoubt or locked.
Any reliable
or durable messages 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.
Express messages are discarded if another message point of the destination is not available.
- There are no consumers or browsers attached to the destination.
A delete
action is rejected if there are consumers or browsers attached to the destination.
Any attached producers are closed asynchronously, and do not prevent the delete
action.
To delete a destination, use the administrative console to complete
the following steps.
- In the navigation pane, click
- In the content pane, click the bus on which the destination is
defined.
- Under Additional Properties, click Destinations
- Click the check box next to the destination name.
- Optional: To stop any new messages for the destination
being added to the bus, click Quiesce. Any
messages already in the bus can still be sent to, and processed by, the destination.
- Check for and resolve any locked messages. Messages
that are locked, as part of in-flight transactions or as in-doubt 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 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.
- Disconnect all consumers or browsers attached to the destination.
- To delete the empty destination, click Delete.
- To confirm that you want to delete the destination click OK.
The bus destination is
deleted.
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.