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.me_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, 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.
Note: 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 may be moved to the exception destination. For more information
see
Specifying an exception bus destination and
Exception destination.
Why and when to perform this task
To delete a destination, use the administrative console to complete
the following steps.
Steps for this task
- In the navigation pane, click .
- In the content pane, click the bus on which the destination is
defined.
- In the content pane, under Destination resources, click Destinations
- Click 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 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.