Current Message Statistics by Application Name workspace
The Current Message Statistic by Application Name displays message statistics, such as message wait times, related to the selected queue. Statistics are grouped by application name.
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 mode.
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 by Application Name workspace includes the following predefined views:
- Current Message Statistics by Application Name This view displays message statistics for the selected queue, grouped by application name. If you attempt to display 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 workspace, this might indicate that an error occurred during message statistics collection. Refer to the agent log and look for message code KMQMI210E. This message provides additional information about the cause of the problem. In this view the Message Group Identifier column contains the application name by which messages have been grouped.
- Message Count by Application Name This view shows, as a bar chart, the percentage of messages delayed for each application.
- Message Duration by Application Name This view shows, as a bar chart, the length of time in seconds that messages from a particular application have been waiting in the queue in terms of oldest message, average message, newest message and highest priority message wait times. The data is repeated for each application using the queue.
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 by Application Name workspace.