Sun Java System Message Queue 3.7 UR1 Administration Guide

Broker Management

The Command utility cannot be used to start a broker; use the Broker utility (imqbrokerd) instead. Once the broker is started, you can use the imqcmd subcommands listed in Table 13–2 to manage and control it.

Table 13–2 Command Utility Subcommands for Broker Management

Syntax 

Description 

shutdown bkr [-b hostName:portNumber]

Shut down broker

restart bkr [-b hostName:portNumber]

Restart broker

Shuts down the broker and then restarts it using the same options specified when it was originally started.  

pause bkr [-b hostName:portNumber]

Pause broker

See Pausing a Broker for more information.

resume bkr [-b hostName:portNumber]

Resume broker

update bkr [-b hostName:portNumber]

    -o property1=value1


    [ [-o property2=value2] … ]


Set broker properties 

See Chapter 14, Broker Properties Reference for information on broker properties.

reload cls

Reload cluster configuration [Applies only to broker clusters]

Forces all persistent information to be brought up to date.  

query bkr -b hostName:portNumber

List broker property values 

Also lists all running brokers connected to the specified broker in a cluster.  

metrics bkr [-b hostName:portNumber]

    [-m metricType]


    [-int interval]


    [-msp numSamples]


Display broker metrics 

The -m option specifies the type of metrics to display:

    ttl: Messages and packets flowing into and out of the broker


    rts: Rate of flow of messages and packets into and out of the broker per second


    cxn: Connections, virtual memory heap, and threads


Default value: ttl.

The -int option specifies the interval, in seconds, at which to display metrics. Default value: 5.

The -msp option specifies the number of samples to display. Default value: Unlimited (infinite).