Home

 

dltmqbrk (Delete broker)

Purpose

Use the dltmqbrk command to delete the broker. On iSeries, the command name is DLTMQMBRK. The broker must be stopped when this command is issued, and the queue manager running. If the broker is already started, issue the endmqbrk before issuing this command. To delete more than one broker in the hierarchy, it is essential that you stop (using the endmqbrk command) and delete each broker one at a time. Do not attempt to stop all the brokers in the hierarchy that you want to delete first and then try to delete them.

The broker must not have children when this command is issued, because they might be cut off from the rest of the network as a result. If the broker has children and this command is issued, an error message naming at least one child broker is received. Delete any children before you delete the broker or, in exceptional circumstances, before you clear the broker using the clrmqbrk command.

The broker performs the following actions:

  1. Put-inhibits its input queues (SYSTEM.BROKER.CONTROL.QUEUE and all stream queues).

  2. Deregisters all its subscribers and publishers.

  3. Sends Delete Publication commands to its parent for its metatopics.

  4. Deregisters all its subscriptions with the parent.

  5. Processes any messages on its input queues according to their report options.
    Note:
    You must have a dead-letter queue, because any input messages are processed according to their report options. If there is no dead-letter queue, commands might fail.

  6. Deletes internal queues (purging any messages on the queues).

  7. Deletes any empty input queues. that were created by the broker in question.

  8. Terminates.

If the queue manager terminates before the broker has finished deleting itself (the finish is indicated by a message to the operator), the operator must issue dltmqbrk again when the queue manager has been restarted.

Syntax

AIX, HP-UX, Linux, Solaris, and Windows 






>>-dltmqbrk-- -m QMgrName--------------------------------------><

Required parameters

AIX, HP-UX, Linux, Solaris, and Windows

-m QMgrName

The name of the queue manager for which the broker function is to be deleted.

Syntax

iSeries 






>>-DLTMQMBRK-- MQMNAME(QMgrName)-------------------------------><

Required parameters

iSeries

MQMNAME(QMgrName)

The name of the queue manager for which the broker function is to be deleted.

Return codes

0

Command completed normally

10

Command completed with unexpected results

20

An error occurred during processing

Examples

dltmqbrk -m exampleQM

Deletes the broker on exampleQM.



 

Home