Command Line Tools

activemq.bat, activemq

activemq [options] [config] or java -jar run.jar start [options] [config]

Script to run an activemq broker either by specifying a broker configuration file or through a broker URI configuration.

System Define Option

-D<key>=<value>

-Dactivemq.home=c:/ActiveMQ

Sets a systems property. i.e Systems.getProperty("activemq.home"); will return c:/ActiveMQ

Help Option

-h or -? or --help

activemq --help

Display the help messages for the activemq script.

Version Option

--version

activemq --version

Display the activemq version information.

activemq

Runs a broker using the default 'xbean:activemq.xml' as the broker configuration file.

activemq xbean:myconfig.xml

Runs a broker using the file myconfig.xml as the broker configuration file that is located in the classpath.

activemq xbean:file:./conf/broker1.xml

Runs a broker using the file broker1.xml as the broker configuration file that is located in the relative file path ./conf/broker1.xml

activemq xbean:file:C:/ActiveMQ/conf/broker2.xml

Runs a broker using the file broker2.xml as the broker configuration file that is located in the absolute file path C:/ActiveMQ/conf/broker2.xml

activemq broker:(tcp://localhost:61616, tcp://localhost:5000)?useJmx=true

Runs a broker with two transport connectors and JMX enabled.¹

activemq broker:(tcp://localhost:61616, network:tcp://localhost:5000)?persistent=false

Runs a broker with 1 transport connector and 1 network connector with persistence disabled.¹

stop

activemq-admin stop [options] [broker names]

Script to stop a running activemq broker. This task requires that JMX is enabled.

Stop All Option

--all

stop --all

Stops all registered brokers in the specified JMX context

JMX URL Option

--jmxurl <url>

--jmxurl service:jmx:rmi:///jndi/rmi://localhost:1099/jmxrmi

Change the JMX service url to connect to. By default it connects to: service:jmx:rmi:///jndi/rmi://localhost:1099/jmxrmi

JMX Authentication Option

--jmxuser user --jmxpassword password

--jmxuser smx --jmxpassword smx

For cases where username/password based authentication of the JMX client is required. Not set by default.

System Define Option

-D<key>=<value>

-Dactivemq.home=c:/ActiveMQ

Sets a systems property. i.e Systems.getProperty("activemq.home"); will return c:/ActiveMQ

Help Option

-h or -? or --help

--help

Display the help messages for the stop script.

Version Option

--version

activemq --version

Display the activemq version information.

activemq-admin stop

Stops the only running broker in the default JMX context. It assumes that there is only one running broker.

activemq-admin stop --jmxurl service:jmx:rmi:///jndi/rmi://remotehost:1099/jmxrmi --all

Stops all the running broker in the specified JMX context.

activemq-admin stop localhost

Stops the broker named 'localhost' in the default JMX context.

activemq-admin stop localhost remotehost

Stops the brokers 'localhost' and 'remotehost' in the default JMX context.

list

activemq-admin list [options]

Script to list the names of all running brokers in the specified JMX context. This task requires that JMX is enabled.

JMX URL Option

--jmxurl <url>

--jmxurl service:jmx:rmi:///jndi/rmi://remotehost:1099/jmxrmi

Change the JMX service url to connect to. By default it connects to: service:jmx:rmi:///jndi/rmi://localhost:1099/jmxrmi

JMX Authentication Option

--jmxuser user --jmxpassword password

--jmxuser smx --jmxpassword smx

For cases where username/password based authentication of the JMX client is required. Not set by default.

System Define Option

-D<key>=<value>

-Dactivemq.home=c:/ActiveMQ

Sets a systems property. i.e Systems.getProperty("activemq.home"); will return c:/ActiveMQ

Help Option

-h or -? or --help

--help

Display the help messages for the list script.

Version Option

--version

activemq --version

Display the activemq version information.

activemq-admin list

Lists the names of all running brokers in the default JMX context.

activemq-admin list --jmxurl service:jmx:rmi:///jndi/rmi://remotehost:1099/jmxrmi

List the names of all running brokers in the specified JMX context.

query

activemq-admin query [options]

Script to query the specified JMX context for mbean attributes and information. This script requires that JMX is enabled.

Predefined Query Option

-Q<type>=<name>

-QTopic=TEST.FOO, -QBroker=*host

Predefined object name query option that queries a specific type of mbean object based on its type and selected identifier. Refer to the mbean reference table below for details.

-xQ<type>=<name>

-xQTopic=ActiveMQ.Advisory.*, -xQNetworkConnector=*

Predefined object name query option that removes all mbeans that matches the query from the search result. Refer to the mbean reference table below for details.

Object Name Query Option

--objname <object name query>

--objname Type=Connect,BrokerName=local*

Query option loosely based on the JMX object name format, which lets you filter mbeans based on their object name information. Refer to the mbean reference table below for details.

--xobjname <object name query>

--xobjname Type=Topic,Destination=ActiveMQ.Advisory.*

Object name query that removes all mbeans that matches the query from the search result. Refer to the mbean reference table below for details.

View Option

--view <view list>

--view Type,BrokerName,Destination,EnqueueCount,DequeueCount

Lets you specify the attributes and object name information to view. If the view is omitted, all attributes and information will be displayed.

JMX URL Option

--jmxurl <url>

--jmxurl service:jmx:rmi:///jndi/rmi://remotehost:1099/jmxrmi

Change the JMX service url to connect to. By default it connects to: service:jmx:rmi:///jndi/rmi://localhost:1099/jmxrmi

JMX Authentication Option

--jmxuser user --jmxpassword password

--jmxuser smx --jmxpassword smx

For cases where username/password based authentication of the JMX client is required. Not set by default.

System Define Option

-D<key>=<value>

-Dactivemq.home=c:/ActiveMQ

Sets a systems property. i.e Systems.getProperty("activemq.home"); will return c:/ActiveMQ

Help Option

-h or -? or --help

--help

Display the help messages for the query script.

Version Option

--version

activemq --version

Display the activemq version information.

activemq-admin query

Display all attributes and object name information of all registered mbeans in the default JMX context.

activemq-admin query -QTopic=TEST.FOO

Display all the attributes and object name information of the destination topic 'TEST.FOO'

activemq-admin query -QQueue=*

Display all the attributes and object name information of all registered queues.

activemq-admin query -QTopic=*.FOO -xQTopic=ActiveMQ.Advisory.*

Display all the attributes and object name information of all topics that ends with '.FOO' except those that also begins with 'ActiveMQ.Advisory.'.

activemq-admin query -QBroker=local???? --view Type,BrokerName,EnqueueCount,DequeueCount

Display the object type, broker name, enqueue count, and dequeue count information for all 9-letter brokers that begins with 'local'.

activemq-admin query --objname Type=Connect,BrokerName=localhost -xQNetworkConnector=*

Display all the attributes and object name information for all connections and connectors for broker 'localhost' except its network connectors.

activemq-admin query --objname Type=Connection --xobjname Type=Connection,BrokerName=localhost

Display all the attributes and object name information for all registered connections except those belonging to broker 'localhost'.

activemq-admin query -QQueue=???? --objname Type=Connection --xobjname BrokerName=remote*

Display all the attributes and object name information for all 4-letter queues and connections except those belonging to a broker that begins with 'remote'.

Broker

• Type=Broker
• BrokerName=<broker identifier>

• BrokerId
• TotalEnqueueCount
• TotalDequeueCount
• TotalConsumerCount
• TotalMessages
• TotalMessagesCached
• MemoryLimit
• MemoryPercentageUsed

Destination

• Type=Queue|Topic
• Destination=<destination identifier>
• BrokerName=<name of broker>

• EnqueueCount
• DequeueCount
• ConsumerCount
• Messages
• MessagesCached

NetworkConnector

• Type=NetworkConnector
• BrokerName=<connector identifierr>

Connector

• Type=Connector
• ConnectorName=<connector identifier>
• BrokerName=<name of broker>

• EnqueueCount
• DequeueCount

Connection

• Type=Connection
• Connection=<connection identifier>
• BrokerName=<name of broker>

• EnqueueCount
• DequeueCount
• DispatchQueueSize
• Active
• Blocked
• Connected
• Slow

bstat

activemq-admin bstat [broker name]

Predefined query script that displays useful statistics regarding a broker and its components.

activemq-admin bstat

Display useful statistics for all registered brokers in the default JMX context.

activemq-admin bstat localhost

Display useful statistics for the registered broker 'localhost'.

browse

activemq-admin browse --amqurl <broker url> [options] <destinations> or java -jar run.jar browse --amqurl <broker url> [options] <destinations>

Script to browse selected destinations' messages.  The browse operation may not return all messages due to limitations of broker configuration and system resources.

Broker URL Option

--amqurl <url>

--amqurl tcp://localhost:61616

Specify the broker URL to connect to.

Message Selector Option

--msgsel "<msgsel1,msgsel2,...>"

--msgsel "JMSMessageID='*:10',JMSPriority>5"

Allows you to filter the specific messages to view. Place the entire selector criteria in double quotes " ". You can use wildcard queries by enclosing the string message property in ' '. Other than using wildcard queries to filter string properties, other queries follows the message selector format.

Group View Option

-V[header | custom | body]

-Vheader, -Vcustom, -Vbody

Let's you specify a specific group of message attributes to view. The header view shows all the standard JMS message headers. The custom view shows all the custom fields added to each JMS message. The body view shows the message body of the JMS message.

Specific View Option

--view <attr1>,[header:|custom:]<attr2>,...

--view JMSMessageID='*:10',custom:MyCustomField

Let's you specifically select a specific message attribute. It allows you to select specific attributes from the JMS and custom headers. You could add the tags header: and custom: to explicitly specify where the attribute belongs to. Refer to the message header table below for details.

System Define Option

-D<key>=<value>

-Dactivemq.home=c:/ActiveMQ

Sets a systems property. i.e Systems.getProperty("activemq.home"); will return c:/ActiveMQ

Help Option

-h or -? or --help

--help

Display the help messages for the browse script.

Version Option

--version

activemq --version

Display the activemq version information.

activemq-admin browse --amqurl tcp://localhost:61616 TEST.FOO

Prints the JMS message header, custom message header, and message body of the messages in the queue 'TEST.FOO'

activemq-admin browse --amqurl tcp://localhost:61616 -Vheader,body TEST.FOO

Prints the JMS message header and message body of the messages in the queue 'TEST.FOO'

activemq-admin browse --amqurl tcp://localhost:61616 -Vheader --view custom:MyCustomField TEST.FOO TEST.BAR

Prints all the JMS message header and the custom field 'MyCustomField' of the messages in the queue 'TEST.FOO' and 'TEST.BAR'.

activemq-admin browse --amqurl tcp://localhost:61616 --msgsel "JMSMessageID='*:10',JMSPriority>5" TEST.FOO

Prints all the attributes of the messages in the queue 'TEST.FOO' that has a JMSMessageID that matches the wildcard query *:10 and has a JMSPriority greater than 5.

JMSCorrelation ID

String

JMSDelivery Mode

int (1-Non-Persistent, 2-Persistent)

JMSDestination

javax.jms.Destination

JMSExpiration

long

JMSMessageID

String

JMSPriority

int

JMSRedelivered

boolean

JMSReplyTo

javax.jms.Destination

JMSTimestamp

long

JMSType

String

purge

activemq-admin purge [purge-options] <destinations>

Delete selected destination's messages that matches the message selector.

JMX URL Option

--jmxurl <url>

--jmxurl service:jmx:rmi:///jndi/rmi://localhost:1099/jmxrmi

Change the JMX service url to connect to. By default it connects to: service:jmx:rmi:///jndi/rmi://localhost:1099/jmxrmi

JMX Authentication Option

--jmxuser user --jmxpassword password

--jmxuser smx --jmxpassword smx

For cases where username/password based authentication of the JMX client is required. Not set by default.

Message Selector Option

--msgsel "<msgsel1,msgsel2,...>"

--msgsel "JMSMessageID='*:10',JMSPriority>5"

Allows you to filter the specific messages to view. Place the entire selector criteria in double quotes " ". You can use wildcard queries by enclosing the string message property in ' '. Other than using wildcard queries to filter string properties, other queries follows the message selector format.

System Define Option

-D<key>=<value>

-Dactivemq.home=c:/ActiveMQ

Sets a systems property. i.e Systems.getProperty("activemq.home"); will return c:/ActiveMQ

Help Option

-h or -? or --help

--help

Display the help messages for the browse script.

Version Option

--version

activemq --version

Display the activemq version information.

activemq-admin purge FOO.BAR

Delete all the messages in queue FOO.BAR

activemq-admin purge --msgsel "JMSMessageID='*:10',JMSPriority>5" FOO.*

Delete all the messages in the destinations that matches FOO.* and has a JMSMessageID in", the header field that matches the wildcard *:10, and has a JMSPriority field > 5 in the", queue FOO.BAR
To use wildcard queries, the field must be a string and the query enclosed in ''

dstat

activemq-admin dstat [destination type]

Predefined query script that displays useful statistics regarding destinations on a broker.

activemq-admin dstat

Display useful statistics for all destinations on the broker in the default JMX context.

activemq-admin dstat topics

Display useful statistics for the Topics that currently exist on the Broker.