Quick tour of the IBM MQ Console
When you first log in to the IBM® MQ Console you are taken to the landing page. From here you can choose to manage existing queue managers, create a queue manager or a queue, navigate to some education topics, or open the IBM MQ product information in IBM Documentation. You can also launch the application quick start, which guides you through the process of quickly and easily setting up messaging between new or existing queue managers and applications.
Alternatively, you can click the manage icon to start managing IBM MQ objects straightaway.
The manage view initially shows queue managers and their current state. You can also create new queue managers, and configure high availability and disaster recovery.
Each queue manager has a menu that lets you stop or configure a running queue manager, or start or delete a stopped queue manager.
Authority Records, Authentication Information objects, and Channel Authentication records for the queue manager can be found on the Security tab of the queue manager's Configuration page, where you can create and add new ones.
Click on the name of a running queue manager to open its dashboard.
- CPU
- Percentage estimate of CPU usage by the queue manager.
- Memory
- Percentage estimate of memory usage by the queue manager.
- Storage
- Percentage estimate of the free space of the disk on which the queue manager resides.
- Active queues
- Count of queues that either have messages, or are open for input or output.
- Connected queue managers
- Count of currently connected queue managers as derived from active channels.
- Connected applications
- Count of currently connected applications.
- Messages in the last minute
- Displays a summary of the PUT/GET system topics that show message throughput every 10 seconds.
- Subscriptions
- Displays a count of subscriptions. Only visible where monitoring of system topics is inhibited (see setmqweb (set mqweb server configuration)).
- Deepest queues
- Lists queues in order of depth. Shows current queue depth and maximum queue depth.
- Most recently used
- Lists currently connected queue managers, ordered by last message date.
- Most recently connected
- Lists currently connected applications as derived from active server-connection channels, ordered by channel start date and time.
- Oldest messages
- Lists queues ordered by the oldest message date and time.
From the queue manager dashboard you can complete the following actions:
- Create new queues
- Click on a queue name to view existing messages and create new ones, and to configure the queue.
- Topics
-
- Create new topics
- Configure existing topics
- Click on a topic name to view matching subscriptions
- Subscriptions
-
- Create new managed or unmanaged subscriptions
- Configure existing subscriptions
- Overview
- Contains tiles which gives overviews of the following statistics:
- Connected applications
- Displays a count of the number of connected applications. Provides links to the following tabs:
- Application instances
- Connections
- Running channel instances
- Displays a count of the number of SVRCONN channel instances and from that links to those that are defined or stopped on the App Channel tab.
- Connections
- Displays a count of the number of connections. Provides links to the following information on
the Connections tab:
- Local connections (those without a channel name)
- Remote connections (those with a channel name)
- Most common applications
- Displays a list of frequent applications, ordered by the number of connections they are using.
- Most common channels
- Displays a list of frequent channels, ordered by the number of instances that are active.
- Oldest transactions
- Displays a list of oldest transactions by application name. These transactions have connections with open units of work and are ordered by the UOW start date and time.
- Remote connected versions
- Displays a list of common connected IBM MQ versions, that is, those channel instances that have a specified REMOTE_VERSION.
- Application channel security
- Displays a list of common connected channel security protocols, that is, those channel instances that have a specified SECURITY_PROTOCOL.
- Channel transfer rates
- Displays a list of common channels ordered by the transfer rates of messages and bytes. Uses the channel start date and time to calculate the duration and uses MSGS and MQIACH_BYTES_SENT/ MQIACH_BYTES_RCVD to calculate the rate.
- Channels
- View activity on channels connected to applications.
- App channels
-
- Start, stop, ping, and configure channels
- Create new channels
- Reset channels
- Start, stop, ping, and configure channels
- App channel instances
-
- View status of application channel instances
- Resolve in-doubt messages on channels
- Overview
- Contains tiles which gives overviews of the following statistics:
- Running queue manager channel instances
- Displays a count of the number of non-SVRCONN channel instances. Displays links to the following
types of channel instances on the Queue managers connected tab:
- Defined channels
- Stopped channels
- Connected queue managers
- Displays a count of the queue managers connected by MQCA_REMOTE_Q_MGR_NAME. Also provides a count of queue managers returned by MQCMD_INQUIRE_CLUSTER_Q_MGR.
- Cluster membership
- If there is only one queue manager cluster, displays the name of the cluster and whether the queue manager is a full or partial repository. Displays how many queue managers are visible in the cluster. If there is more than one cluster, then displays the number of clusters plus a count of full and partial repository queue managers in each cluster.
- Failing queue manager channels
- Displays a list of channels that are in a retrying state (non stopped/running). Calculates the
number of retries remaining if in the retry state. The list contains channels with the following
status types:
- MQCHS_PAUSED
- MQCHS_RETRYING
- Longest message delays
- Displays a list of channels that have an XMIT time indicator (long period).
- Unattended transmission queues
- Displays a list of transmission queues that have a non-zero queue depth and no associated handles.
- Remote connection versions
- Displays a list of common connected IBM MQ versions, that is, those channel instances that have a specified REMOTE_VERSION.
- Queue manager channel security
- Displays a list of common connected channel security protocols, that is, those channel instances that have a specified SECURITY_PROTOCOL.
- Cluster health
-
Displays a number of independent statistics related to the health of the cluster. The status includes:
- The number of cluster objects (queues, topics, queue managers).
- The number of suspended queue managers (MQIACF_SUSPEND set to YES).
- The depth of the SYSTEM.CLUSTER.COMMAND.QUEUE queue.
- The number of cluster queue manager entries starting with SYSTEM.TEMP.
If all of these values are zero then this tile is not displayed and the Listeners tile is shown instead..
- Listeners
- Displays a list of listeners and whether they are in a running state. Only shown if the Cluster health tile is not displayed.
- Queue managers connected
- View details of queue managers currently connected to this queue manager.
- Queue manager channels
-
- Start, stop, ping, and configure channels
- Create new channels
- Reset channels
- Start, stop, ping, and configure channels
- Queue manager channel instances
-
- View status of queue manager channel instances
- Resolve in-doubt messages on channels
Customizing columns
You can simplify the view of an IBM MQ object by customizing the columns that are displayed.
Where a view has many columns, you can click the column button in the toolbar to open the Customize columns window. Select the columns that you want displayed and click Confirm.
You can create different column views and switch between them. The default view is always available to revert to.
- Open the Customize columns window.
- Click the add view button in the toolbar
. A blank view appears. It is
automatically given the name New View n. - Select the columns that you want to display, you can move to the top of the list by using the
move button
.
Click Confirm when you are satisfied.
You can switch between views by selecting them from the Name list. Note that the columns view is saved in your browser. If you use a different browser, the views that you previously defined will not be available.