WAS v8.5 > Administer applications and their environment > Welcome to administering Service integration > Administer bus destinations > Configure bus destinations > Delete a bus destination

Delete a non-topic space bus destination

Use this task to delete, from a service integration bus, a bus destination 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 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:

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. For more information see Configure exception destination processing for a bus destination and Exception destinations. To delete a destination, use the dmgr console to complete the following steps.

  1. Click Service integration -> Buses -> bus_name -> [Destination resources] Destinations.

  2. Select the check box next to the destination name.
  3. Check for and resolve any locked messages. Messages that are locked, as part of in-flight transactions or as indoubt messages, are not deleted.
  4. 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.
  5. To delete the empty destination, click Delete.
  6. To confirm to delete the destination click OK.


Results

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.


+

Search Tips   |   Advanced Search