IBM Integration Bus, Version 9.0.0.8 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

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

Purpose

The mqsideletebroker command:
  • 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.

Select the appropriate link for details of this command on the platform, or platforms, that your enterprise uses:

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 IBM® Integration Explorer session is currently connected to a broker, you cannot delete that broker until you disconnect it.

Authorization

For information about platform-specific authorizations, see the following topics: If you have enabled broker administration security, you must also set up the authority detailed in Tasks and authorizations for administration security.
Related tasks:
Deleting a broker
Related reference:
mqsicreatebroker command
mqsichangebroker command
an07100_.htm | Last updated Friday, 21 July 2017