Current Message Statistics by Correlation ID workspace
The Current Message Statistics by Correlation ID displays message statistics, such as message wait times, related to the selected queue. Statistics are grouped by correlation ID.
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 Correlation ID workspace includes the following predefined views:
- Current Message Statistics by Correlation ID This view displays message statistics for the selected queue, grouped by correlation ID. 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 correlation ID by which messages have been grouped.
- Message Count by Correlation ID This view shows, as a bar chart, the percentage of messages delayed for each correlation ID.
- Message Duration by Correlation ID This view shows, as a bar chart, the length of time in seconds that messages have been waiting in the queue in terms of oldest message, average message, newest message and highest priority message wait times. The chart is organized by correlation ID.
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 Correlation ID workspace.