See information about the latest product version
mqsideletebroker command
Use the mqsideletebroker command to delete a named broker. The command also deletes the queues on the associated queue manager (created when the broker was created). You can also specify that the queue manager is to be deleted.
Supported platforms
- Windows
- Linux and UNIX systems
- z/OS®. Run this command by customizing and submitting BIPDLBK; see Contents of the broker PDSE
Purpose
- On Windows platforms, stops the service that runs the broker.
- Stops and deletes the WebSphere® MQ queue manager for the broker, if requested.
- Deletes the administrative security queues that are associated with the broker, if requested.
- Removes the record for the component in the registry.
If you delete a broker that has WebSphere MQ publish/subscribe broker neighbors, you must also run the clrmqbrk on each of these neighbors. You must identify the broker that you are deleting on this command.
Usage notes
If you run the command against a component that does not exist (for example, the component has already been deleted, or you have mistyped the component name), the command returns with a successful completion message. The command does not inform you that the component does not exist.
You cannot delete a broker to which you have an open connection; the command fails. For example, if your WebSphere Message Broker Explorer session is currently connected to a broker, you cannot delete that broker until you disconnect it.
Authorization
- Security requirements for Linux and UNIX platforms
- Security requirements for Windows systems
- Security requirements for z/OS