To monitor items in point-to-point messaging (queues, messages, senders,
and receivers) or items in publish-and-subscribe messaging (topics, messages,
publishers, and subscribers) use the etbinfo tool. This is located in the
subfolder bin of the installation folder. See Command-line Utilities for a general description of this tool. It
displays Broker status information given by the Broker ID. You can select the
information by several criteria and format the display with profiles. In the
following, we use the delivered profiles to obtain information on items related
to JMS. You can edit copies of the delivered profiles to tailor the output to
your needs.
For point-to-point messaging you can use the System Management Hub with the Agent for the Broker to monitor queues, messages, senders and receivers. See Broker Administration using System Management Hub under UNIX | Windows for this agent.
This document covers the following topics:
Enter the command
etbinfo -b broker id -d SERVICE -c JMS -p service.pro
to display the queues currently being used. To display only the
temporary queues, add -s TMPQUEUE. To display only the
non-temporary queues, add -s QUEUE. The data retrieved is defined
in the profile service.pro.
Enter the command
etbinfo -b broker id -d PSF -e JMS -p psf.pro
to display data for all the units of work containing messages. For
transacted sessions and client-acknowledged messages, a unit of work contains
all the messages of one transaction or one acknowledgment. Otherwise, each
unit of work contains one message. The JMS message IDs are not visible. The
parameter -e JMS restricts the selected data to all
units of work sent to a JMS queue (receiver class is
JMS). The data retrieved is defined in the profile
psf.pro.
Enter the command
etbinfo -b broker id -d CLIENT -p client.pro
to display all the clients (senders) currently logged on to the Broker. The data retrieved is defined in the profile client.pro.
Enter the command
etbinfo -b broker id -d SERVER -p server.pro
to display all the servers (receivers) currently registered at the Broker. If you want to monitor receivers for one queue, use:
etbinfo -b broker id -d SERVER -c JMS -n name of queue -s QUEUE -p server.pro
The data retrieved is defined in the profile server.pro.
Enter the command
etbinfo -b broker id -d TOPIC -l FULL -p topic.pro
to display data for all the topics currently available in the Broker. The data retrieved is defined in the profile topic.pro.
Enter the command
etbinfo -b broker id -d PUBLICATION -l FULL -p public.pro
to display data for all the publications currently available in the
Broker. A publication is a transaction of a transacted session or a bundle of
messages from one acknowledgment. For acknowledge modes AUTO-ACKNOWLEDGE,
DUPS_OK_ACKNOWLEDGE each publication contains one message. The data retrieved
is defined in the profile public.pro.
Enter the command
etbinfo -b broker id -d PUBLISHER -l FULL -p pubshr.pro
to display all the publishers currently logged on to the Broker. The data retrieved is defined in the profile pubshr.pro.
Enter the command
etbinfo -b broker id -d SUBSCRIBER -p subscbr.pro
to display all the subscribers currently in the Broker. To select all of the subscribers to a topic use:
etbinfo -b broker id -d SUBSCRIBER -T topic name -p subscbr.pro
The data retrieved is defined in the profile subscbr.pro.
