To list the connection services available on a broker, use the imqcmd list svc subcommand:
imqcmd list svc [-b hostName:portNumber]
For example, the following command lists all services on the default broker (host localhost at port 7676):
imqcmd list svc -u admin
Example 6–1 shows an example of the resulting output.
|
The imqcmd query svc subcommand displays information about a single connection service:
imqcmd query svc -n serviceName [-b hostName:portNumber]
For example, the following command displays information about the jms connection service on the default broker (host localhost at port 7676):
imqcmd query svc -n jms -u admin
Example 6–2 shows an example of the resulting output.
|
To display metrics information about a connection service, use the imqcmd metrics svc subcommand:
imqcmd metrics svc -n serviceName [-b hostName:portNumber] [-m metricType] [-int interval] [-msp numSamples]
The -m option specifies the type of metric information to display:
ttl (default): Messages and packets flowing into and out of the broker by way of the specified connection service
rts: Rate of flow of messages and packets into and out of the broker per second by way of the specified connection service
cxn: Connections, virtual memory heap, and threads
The -int and -msp options specify, respectively, the interval (in seconds) at which to display the metrics and the number of samples to display in the output. The default values are 5 seconds and an unlimited number of samples.
For example, the following command displays cumulative totals for messages and packets handled by the default broker (host localhost at port 7676) by way of the jms connection service:
imqcmd metrics svc -n jms -m ttl -u admin
Example 6–3 shows an example of the resulting output.
|
For a more detailed description of the use of the Command utility to report connection service metrics, see Connection Service Metrics.