Home

 

endmqbrk (End broker function)

Purpose

Use the endmqbrk command to stop a broker. On iSeries, the command name is ENDMQMBRK

Control information is retained and registrations for publishers and subscribers remain in force. Messages are queued by the queue manager until the broker is restarted using the strmqbrk command.

Syntax

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

             .- -c -.
>>-endmqbrk--+------+--+--------------+------------------------><
             '- -i -'  '- -m QMgrName-'

Optional parameters

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

-c

Requests a controlled shutdown. This is the default value.

-i

Requests an immediate shutdown. The broker does not attempt any further gets or puts, and backs out any in-flight units-of-work. This might mean that a nonpersistent input message is published only to a subset of subscribers, or lost, depending on the broker configuration parameters. (See the description of SyncPointIfPersistent in Broker configuration parameters.)

-m QMgrName

The name of the queue manager for which the broker function is to be ended. If you do not specify this parameter, the command is routed to the default queue manager.

Syntax

iSeries

              .- OPTION(*CNTRLD) -.
>>-ENDMQMBRK--+-------------------+--+--------------------+----><
              '- OPTION(*IMMED) --'  '- MQMNAME(QMgrName)-'

Optional parameters

iSeries

OPTION(*CNTRLD)

Requests a controlled shutdown. This is the default value.

OPTION(*IMMED)

Requests an immediate shutdown. The broker does not attempt any further gets or puts, and backs out any in-flight units-of-work. This might mean that a nonpersistent input message is published only to a subset of subscribers, or lost, depending on the broker configuration parameters. (See the description of SyncPointIfPersistent in Broker configuration parameters.)

MQMNAME(QMgrName)

The name of the queue manager for which the broker function is to be ended. If you do not specify this parameter, the command is routed to the default queue manager.

Return codes

0

Command completed normally

10

Command completed with unexpected results

20

An error occurred during processing

Examples

endmqbrk	Stops the broker on the default queue manager with a controlled shutdown.
endmqbrk -i -m exampleQM	Stops the broker on exampleQM immediately.

 

Home