Delete a non-topic space bus destination
Use this task to delete, from a service integration bus, a bus destination that is not for a topic space.
We cannot delete bus destinations required by the system; for example, the default exception destination for a messaging engine: _SYSTEM.Exception.Destination.messaging_engine_name.
Before we can completely delete a bus destination, 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 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.
Any attached producers or consumers are closed asynchronously, and do not prevent the delete action. Any messages sent after the delete action, but before close of producers might not be discarded. Depending on the options set, the messages might be moved to the exception destination. See Configure exception destination processing for a bus destination and Exception destinations.
To delete a destination, use the administrative console to complete the following steps.
Tasks
- Click Service integration -> Buses -> bus_name -> [Destination resources] Destinations.
- 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. essages 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 to delete the destination click OK.
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.