Quick tour of the IBM MQ Console - CD only

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 just 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 connect remote queue managers.

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.

From the queue manager dashboard you can complete the following actions:

On the Overview tab, view the following information:

CPU

Percentage estimate of CPU usage by the queue manager. (Not applicable on z/OS®.)

Memory

Percentage estimate of memory usage by the queue manager. (Not applicable on z/OS or Windows.)

Storage

Percentage estimate of the free space of the disk on which the queue manager resides. (Not applicable on z/OS.)

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. (Not applicable on z/OS.)

Subscriptions

Displays a count of subscriptions. Only visible on z/OS and on other platforms where monitoring of system topics is inhibited (see setmqweb properties).

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.

The information displayed on the Overview tab is derived from the monitoring of system topics (see Metrics published on the system topics). z/OS does not support system topic monitoring, and the monitoring for console display purposes can be disabled on other platforms (see setmqweb properties). In these cases the Overview tab displays more limited information and its appearance is similar to the following example:

On the Applications tab:

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.

Applications

View information about applications that are connected to the queue manager.

Channels

View activity on channels connected to applications.

App channels

• Start, stop, ping, and configure channels
• Create new channels
• Reset channels

App channel instances

• View status of application channel instances
• Resolve in-doubt messages on channels

On the MQ Network tab:

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

Queue manager channel instances

• View status of queue manager channel instances
• Resolve in-doubt messages on channels