mqsideletebroker command

Supported platforms

Purpose

Use the mqsideletebroker command to delete a named broker. The command also deletes the queues on the broker's local queue manager (created when the broker was created), and its data in the broker database. You can also specify that the queue manager is to be deleted.

Even though this command deletes all the data related to this broker from the broker database tables, it does not check if the tables are empty, nor does it delete the tables.

This command:
  • On Windows platforms, stops the service that runs the broker.
  • Stops and deletes the WebSphere MQ queue manager for the broker, if requested.
  • Removes the broker's data from the database.
  • Removes the record for the component in the broker registry.

If you delete a broker that has WebSphere MQ publish/subscribe broker neighbors, also invoke the command clrmqbrk at each of these neighbors, specifying the WebSphere Event Broker broker that you are deleting with this command.

Syntax

Windows platforms, Linux, and UNIX systems

z/OS

Parameters

brokername
(Required) The name of the broker that you want to delete. This must be the first parameter.
-q
(Optional - Windows platforms, Linux, and UNIX systems) Specifies that the broker's queue manager is deleted. (If this option is not specified, only the WebSphere Event Broker queues and broker's data are deleted.)

If the queue manager hosts another component (the Configuration Manager, or the User Name Server, or both in addition to this broker) that still exists, this command fails.

-w
(Optional - Windows platforms, Linux, and UNIX systems) Deletes all files related to this broker from the workpath.
Start of change-1 End of change
(Optional - z/OS only) Deletes only the broker registry.
Start of change-2 End of change
(Optional - z/OS only) Deletes only the broker WebSphere MQ queues.
Start of change-3 End of change
(Optional - z/OS only) Deletes only the broker DB2 tables and indexes.

Responses

  • BIP8012 Unable to connect to system components
  • BIP8013 Component does not exist
  • BIP8017 Component cannot be deleted
  • BIP8018 Component running
  • BIP8040 Unable to connect to database
  • BIP8048 Unable to start queue manager
  • BIP8049 Unable to stop queue manager
  • BIP8052 Unable to delete queue
  • BIP8073 Invalid broker name
  • BIP8082 Unable to delete queue manager
  • BIP8093 Queue manager being created
  • BIP8094 Queue manager stopping
  • BIP8095 Queue manager reserved

Examples

mqsideletebroker WBRK_BROKER -q
Start of changeTo delete the broker registry on z/OS for the broker CSQ1BRK, use the following command:
mqsideletebroker CSQ1BRK -1
End of change
Related concepts
Broker domains