Message Statistics attributes

Use the Message Statistics attributes to create situations that are associated with message statistics for a particular queue of interest. Note that the Queue Name attribute must be provided in queries to this attribute group and it must specify an individual queue name. No wildcards are allowed. See also the description of the Grouping Mechanism attribute that follows. Because of the overhead of collecting message statistics data, it must only be collected for those queues that you want closely monitored. Message Statistics is a multiple-instance attribute group. You cannot mix these attributes with attributes of any other multiple-instance group.

Many of the message statistics are calculated using the put-date-and-time of the message in the queue. If the queue has messages with put-date-and-times that do not reflect accurately when the message is put into the input queue, the statistics are correspondingly inaccurate. Put-date-and-times are not accurate indicators when origin context is preserved or set for a message during the put by an application to the queue. 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 origin context for a message.

% Delayed The percentage of Total Messages that are Delayed Messages.

Authorization userid The user ID of the user that issues the IBM MQ request. The valid format is an alphanumeric string of up to 16 case-sensitive characters. Informational.

Average Msg(Secs) The average number of seconds (with two decimal places) that messages matching the Message Group Identifier are on the queue.

Delayed Messages The count of messages matching the Message Group Identifier for which the current date and time minus the message put date and time exceeds the Latency Threshold value. The valid format is an integer.

Grouping Mechanism An enumerated value that indicates how to ascertain the Message Group Identifier. This can be given in queries to the attribute group to tell the agent how to group the messages in the queue. The grouping mechanism can be Correlation ID, Application Name, Group ID, or Queue. Queue is the default, which results in one row being returned giving the message statistics for the whole queue. The valid format is an integer. Valid values are as follows:

  • Queue = 0,
  • Correlation_ID = 1,
  • Application_Name = 2,
  • Group_ID = 3

High Priority Msg(Secs) The number of seconds (with two decimal places) that the highest priority message that matches the Message Group Identifier is on the queue (note that if there is more than one of the highest priority, the oldest such message is used for this time value).

Host Name The name of the system on which this queue manager is running. On z/OS systems, this is the SMF ID. The valid format is an alphanumeric string of up to 48 case-sensitive characters.

Largest Message Size The size of the largest message on the queue. The message size is a return attribute when messages are browsed for other data. The valid format is an integer.

Latency Threshold The number of seconds (with two decimal places) that a message can exist on the queue before it is determined to be delayed on the queue. This can be given in queries to the attribute group to tell the agent how to calculate Delayed Messages. The default is either the threshold given for a greater-than comparison to the Oldest Message Time attribute when available in the query, or if not available, a value of 120 seconds.

Message Group Identifier A character string that identifies how messages are grouped within a workspace; this can be the correlation ID, put application name, or group ID from the MQMD. This identifier is blank when the default grouping mechanism of Queue is used. The valid format is an alphanumeric string of up to 48 case-sensitive characters.

Message Group Identifier(Hex) A hexadecimal character representation of the Message Group Identifier. It is possible to chose to group by a hexadecimal correlation ID or group ID; however this form of the identifier is not selected for display by default in the product-provided workspaces. The valid format is an alphanumeric string of up to 96 case-sensitive characters.

Newest Msg(Secs) The number of seconds (with two decimal places) that the newest, most recent message matching the Message Group Identifier has been on the queue.

Oldest Msg(Secs) The number of seconds (with two decimal places) that the oldest (or most delayed) message matching the Message Group Identifier has been on the queue.

Origin Node The IBM MQ Monitoring agent-assigned name of the node on which the data for the queue manager originates.

On z/OS systems, this name takes the form qmgr:smfid:MQESA, where qmgr is the name of the queue manager, and smfid is the z/OS system ID or SMF ID.

On distributed systems, this name takes the form qmgr::MQ. If the host ID value is specified by the SET AGENT command, this name takes the form qmgr:hostid:MQ. The valid format is an alphanumeric string of up to 128 case-sensitive characters.

Priority 0 Messages The count of messages that match the Message Group Identifier for which the message priority given in the MQMD is 0.

Priority 1 Messages The count of messages that match the Message Group Identifier for which the message priority given in the MQMD is 1.

Priority 2 Messages The count of messages that match the Message Group Identifier for which the message priority given in the MQMD is 2.

Priority 3 Messages The count of messages that match the Message Group Identifier for which the message priority given in the MQMD is 3.

Priority 4 Messages The count of messages that match the Message Group Identifier for which the message priority given in the MQMD is 4.

Priority 5 Messages The count of messages that match the Message Group Identifier for which the message priority given in the MQMD is 5.

Priority 6 Messages The count of messages that match the Message Group Identifier for which the message priority given in the MQMD is 6.

Priority 7 Messages The count of messages that match the Message Group Identifier for which the message priority given in the MQMD is 7.

Priority 8 Messages The count of messages that match the Message Group Identifier for which the message priority given in the MQMD is 8.

Priority 9 Messages The count of messages that match the Message Group Identifier for which the message priority given in the MQMD is 9.

QMgr Name The name that is assigned to this queue manager. The valid format is an alphanumeric string of up to 48 case-sensitive characters.

Queue Name The name of a queue that is managed by the selected queue manager. This attribute is required to be given in queries to this attribute group. The valid format is an alphanumeric string of up to 48 case-sensitive characters.

Request Type One of the following request types: Current or Recent History. The valid format is an integer. Valid Values are Current = 0 and Recent_History = 1.

Sample Date & Time The date and time of the sample. The valid format is the standard 16-character date/time format (CYYMMDDHHMMSSmmm), where the strings have the following meanings:

C
Century (0 for 20th, 1 for 21st)
YY
Year
MM
Month
DD
Day
HH
Hour
MM
Minute
SS
Second
mmm
Millisecond

Total Messages The count of messages that are browsed that match the Message Group Identifier on the queue during the collection sample. The valid format is an integer.