Broker Administration Enhancements

In Message Queue 4.0, a new subcommand and several command options were
added to the Command utility (imqcmd) to allow administrators
to quiesce a broker, to shutdown a broker after a specified interval, to destroy
a connection, or to set java system properties (for example, connection related
properties).

Quiescing a broker moves it into a quiet state, which allows
messages to be drained before the broker is shut down or restarted. No new
connections can be created to a broker that is being quiesced. To quiesce
the broker, enter a command like the following.

imqcmd
quiesce bkr -b Wolfgang:1756

To shut down the broker after a specified interval, enter
a command like the following. (The time interval specifies the number of seconds
to wait before the broker is shut down.)

imqcmd shutdown
bkr -b Hastings:1066 -time 90

If you specify a time
interval, the broker will log a message indicating when shutdown will occur.
For example,

Shutting down the broker in 29 seconds (29996
milliseconds)

While the broker is waiting to shut down,
its behavior is affected in the following ways.

Administrative jms connections will continue to be accepted.

No new jms connections will be accepted.

Existing jms connections will continue to work.

The broker will not be able to take over for any other broker
in an enhanced broker
cluster.

The imqcmd utility will not block, it will send the request
to shut down to the broker and return right away.

To destroy a connection, enter a command like the following.

imqcmd destroy cxn -n 2691475382197166336

Use
the command imqcmd list cxn or imqcmd query cxn to
obtain the connection ID.

To set a system property using imqcmd,
use the new –D option. This is useful for setting or overriding JMS
connection factory properties or connection-related java system properties.
For example: