WebSphere WebSphere Application Server Express, Version 6.0.x Operating Systems: AIX, HP-UX, Linux, Solaris, Windows

Deleting 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.

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, 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.

Why and when to perform this task

To delete a destination, use the administrative console to complete the following steps.

Steps for this task

  1. In the navigation pane, click Service integration > Buses
  2. In the content pane, click the bus on which the destination is defined.
  3. Under Additional Properties, click Destinations
  4. Click the check box next to the destination name.
  5. 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.
  6. 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.
  7. 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.
  8. Disconnect all consumers or browsers attached to the destination.
  9. To delete the empty destination, click Delete.
  10. 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.

Task topic

Terms of Use | Feedback

Last updated: 2 Aug 2005
http://publib.boulder.ibm.com/infocenter/ws60help/index.jsp?topic=/com.ibm.websphere.pmc.express.doc\tasks\tjo0009_.html

© Copyright IBM Corporation 2004, 2005. All Rights Reserved.
This information center is powered by Eclipse technology. (http://www.eclipse.org)