Deleting a multi-instance broker

The order of deletion of a multi-instance message broker and its associated instances is important. You should take care to use the correct command for each step in the process.

Ideally, you should remove all of the broker instances using the mqsiremovebrokerinstance command before you attempt to remove the broker itself. This command removes all local references to the broker instance, but does not affect the shared configuration for the multi-instance broker on the shared work path (which was specified with the -e option on the mqsicreatebroker and mqsiaddbrokerinstance commands).

Note that the mqsiremovebrokerinstance command cannot be issued against a standby broker instance. Stop the active broker instance before you run this command.

Now, remove the multi-instance broker using the mqsideletebroker command. This process removes all references to the broker on both the local and shared work paths.

If you make a mistake, and unintentionally remove a broker instance, it can be re-created using the mqsiaddbrokerinstance command, providing that the mqsideletebroker command has not been used to delete the broker.

If the multi-instance broker has been removed using the mqsideletebroker command before removing any associated broker instances, it will not be possible to start the broker instances.

To recover from this situation, re-create the multi-instance broker using the mqsicreatebroker command with the -e option, specifying the original shared work path location.

The following procedure gives an overview of how you delete a multi-instance broker: