Current Message Statistics workspace

The Current Message Statistics displays message statistics, such as message wait times, related to the selected queue.

Important: The data contained within this workspace is collected on-request-only, not during the standard sampling interval. Each time you open, link to, or refresh this workspace, the monitoring agent queries MQ and collects the requested data. Therefore, for performance reasons, this workspace must not be placed in a short interval automatic refresh cycle.

To view this workspace, your Tivoli® Enterprise Portal Logon user ID's MQ Security Access for the selected queue must be set to MQGET (with the browse option enabled). Additionally, user access to messages stored on the queue must be enabled. This can be adjusted using the MSGACCESS parameter in the SET GROUP and SET MANAGER monitoring options. Any value other than MSGACCESS(NONE) enables collection of message statistics. The default setting of MSGACCESS(DESC) enables all users to browse message statistics using this workspace. If you attempt to view the current message statistics workspace without the required access permission, no data is displayed.

Many of the message statistics are based on the put date and time of the message stored in the queue. If the queue contains messages with put dates and times that do not accurately reflect when they were put into the input queue, then the statistics calculated will be correspondingly inaccurate. Put dates and times might be inaccurate if the origin context of a message is preserved or set when the message is put into the queue by an application. This commonly occurs when an application is a message mover that moves messages from one queue to another, or when any application passes or sets the origin context of a message.

Predefined views

The Current Message Statistics workspace includes the following predefined views:

  • Current Message Statistics This view displays message statistics for the selected queue. If you attempt to display message the statistics of a queue with no messages, a single row is displayed containing 0 values for all message counts and times. If no rows are displayed in this view, this might indicate that an error occurred during message statistics collection. Refer to the agent log and look for KMQMI210E message code. This message provides additional information about the cause of the problem.

  • Message Count This view shows, as a bar chart, the number of delayed messages in the selected queue in comparison to the total number of messages.
  • Message Duration This view shows, as a bar chart, the length of time in seconds that messages from all applications combined have been waiting in the queue, in terms of oldest message, average message, newest message and highest priority message wait times.

For more information on the attributes listed in the tables of this workspace, see Message Statistics attributes.

Predefined links

No other workspaces can be linked to from the Current Message Statistics workspace: