Historical Message Statistics workspace
The Historical Message Statistics workspace displays message statistics, such as message wait times, related to the selected queue over the specified period of time for which historical records are available.
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 on the queue must be enabled. This can be adjusted using the MSGACCESS parameter of the SET GROUP and SET MANAGER monitoring options. Any value other than MSGACCESS(NONE) allows 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 proper access, no data is returned.
Many of the message statistics are using the put date and time of the message 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 are inaccurate if the origin context is preserved or set for a message when it is put into the queue by an application. This commonly occurs when the application putting the message into the queue 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.
The IBM® MQ Monitoring agent also provides current and recent versions of this workspace, which you can use to view the latest available report data or a recent snapshot of data taken at a particular point in time.
Predefined views
The Historical Message Statistics workspace includes the following predefined views:
- Historical Message Statistics This view displays message statistics for the selected queue. If you attempt to display message statistics for 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 KMQMI210E message code. This message provides additional information about the cause of the problem.
- Historical Message Count This view shows, as a bar chart, the number of delayed messages in comparison to the total number of messages, over the selected period of time for which historical records are available.
- Historical Message Duration This view shows, as a bar chart, the length of time in seconds that messages have been waiting in the queue in term of oldest message, average message, newest message and highest priority message wait times, over the selected period of time for which historical records are available.
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 Historical Message Statistics workspace.