mqsideletebroker command

Supported platforms

  • Windows 2000, Windows XP
  • UNIX platforms
  • z/OS

Purpose

On Windows platforms and UNIX platforms, 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 Business Integration Message Broker broker that you are deleting with this command.

On z/OS, invoke the mqsideletebroker command in your INSTPATH/bin directory. This command deletes all directories and files in your component directory. The root directory is not deleted but will be empty.

On z/OS, this command must run in a C locale. Any messages that are produced are in English, regardless of the user's current locale.

Syntax

Windows platforms and UNIX platforms

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 and UNIX platforms) Specifies that the broker's queue manager is deleted. (If this option is not specified, only the WebSphere Business Integration Message 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 and UNIX platforms) Deletes all files related to this broker from the workpath.
c ComponentDirectory
(Required - z/OS) The name of the component directory. For example /var/wmqi/MQP1UNS

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
Related concepts
Broker domain