Channel Summary attributes

Use the Channel Summary attributes to create situations for detecting problems of application client connections and channels. The Channel Summary attributes provide the summarized data on a channel level or on a connection level. By default, historical data collection is disabled for this attribute group. You can enable historical data collection for the summarized data only on a channel level. Channel Summary is a multiple-instance attribute group. You cannot mix these attributes with attributes of any other multiple-instance group.

% Max Instances The total number of instances of a server-connection channel as a percentage of the maximum number of instances of a server-connection channel that can be started. This attribute is valid only for server-connection channels of WebSphere® MQ 7.0.1 and later versions.

% Max Instances per Client The highest number of instances of a given channel that are grouped by clients as a percentage of the maximum number of instances of a channel that can be started from a single client. This attribute is valid only for server-connection channels of WebSphere MQ 7.0.1 and later versions.

% Max Sharing Conversations The highest number of current conversations of a server-connection channel as a percentage of the maximum number of conversations that can run over each instance. The valid format is a decimal (formatted to 1 decimal place) in the range 0.0 - 100.0. This attribute is valid only for server-connection channels of WebSphere MQ 7.0.1 and later versions.

In the Channel Summary by Connection Name workspace, this attribute is summarized for a given connection.

Average Buffers Received The average of the Buffers Received attribute values from all instances of a multi-instance channel. For single-instance channels, this attribute is the same as the Buffers Received value.

In the Channel Summary by Connection Name workspace, this attribute is summarized for a given connection.

Average Buffers Sent The average of the Buffers Sent attribute values from all instances of a multi-instance channel. For single-instance channels, this attribute is the same as the Buffers Sent value.

In the Channel Summary by Connection Name workspace, this attribute is summarized for a given connection.

Average Bytes Received The average of the Bytes Received attribute values from all instances of a multi-instance channel. For single-instance channels, this attribute is the same as the Bytes Received value.

In the Channel Summary by Connection Name workspace, this attribute is summarized for a given connection.

Average Bytes Received (Deprecated) The average of the Bytes Received attribute values from all instances of a multi-instance channel. For single-instance channels, this attribute is the same as the Bytes Received value.

In the Channel Summary by Connection Name workspace, this attribute is summarized for a given connection.

Average Bytes Sent The average of the Bytes Sent attribute values from all instances of a multi-instance channel. For single-instance channels, this attribute is the same as the Bytes Sent value.

In the Channel Summary by Connection Name workspace, this attribute is summarized for a given connection.

Average Bytes Sent (Deprecated) The average of the Bytes Sent attribute values from all instances of a multi-instance channel. For single-instance channels, this attribute is the same as the Bytes Sent value.

In the Channel Summary by Connection Name workspace, this attribute is summarized for a given connection.

Average Message Count The average of the Message Count attribute values from all instances of a multi-instance channel. For single-instance channels, this attribute is the same as the Message Count attribute value.

In the Channel Summary by Connection Name workspace, this attribute is summarized for a given connection.

Average Transmit KB/Sec The average of the Transmit KB per Sec attribute values from all instances of a multi-instance channel. For single-instance channels, this attribute is the same as the Transmit KB per Sec attribute value.

In the Channel Summary by Connection Name workspace, this attribute is summarized for a given connection.

Channel Name The name of this channel. The valid format is an alphanumeric string of up to 20 case-sensitive characters.

Channel Type The type that is assigned to the channel when it is created. Valid values are as follows:

  • n/a
  • SDR = 1 (for sender)
  • SVR = 2 (for server)
  • RCVR = 3 (for receiver)
  • RQSTR = 4 (for requester)
  • CLNTCONN = 6 (for client connection)
  • SVRCONN = 7 (for server connection)
  • CLUSRCVR = 8 (for cluster receiver)
  • CLUSSDR = 9 (for cluster sender)
  • MQCHT_MQTT=10 (for telemetry channel)

Client Count The number of clients that have different network addresses. The total number of individual clients with different network addresses, from which client applications are connecting a given channel respectively with a channel instance. This attribute is always 1 and will not be displayed in the Channel Summary by Connection Name workspace.

Connection Name The name of the connection. This attribute is available only in the Channel Summary by Connection Name workspace.

Earliest Start Date & Time The earliest time stamp among the Start Date & Time time stamps from all instances of a multi-instance channel. For single-instance channels, this attribute value is the same as the Start Date & Time time stamp.

In the Channel Summary by Connection Name workspace, this attribute is summarized for a given connection.

Highest Buffers Received The highest attribute value among the Buffers Received attribute values from all instances of a multi-instance channel. For single-instance channels, this attribute is the same as the Buffers Received attribute value.

In the Channel Summary by Connection Name workspace, this attribute is summarized for a given connection.

Highest Buffers Sent The highest attribute value among the Buffers Sent attribute values from all instances of a multi-instance channel. For single-instance channels, this attribute is the same as the Buffers Sent attribute value.

In the Channel Summary by Connection Name workspace, this attribute is summarized for a given connection.

Highest Bytes Received The highest attribute value among the Bytes Received attribute values from all instances of a multi-instance channel. For single-instance channels, this attribute is the same as the Bytes Received attribute value.

In the Channel Summary by Connection Name workspace, this attribute is summarized for a given connection.

Highest Bytes Received (Deprecated) The highest attribute value among the Bytes Received attribute values from all instances of a multi-instance channel. For single-instance channels, this attribute is the same as the Bytes Received attribute value.

In the Channel Summary by Connection Name workspace, this attribute is summarized for a given connection.

Highest Bytes Sent The highest attribute value among the Bytes Sent attribute values from all instances of a multi-instance channel. For single-instance channels, this attribute is the same as the Bytes Sent attribute value.

In the Channel Summary by Connection Name workspace, this attribute is summarized for a given connection.

Highest Bytes Sent (Deprecated) The highest attribute value among the Bytes Sent attribute values from all instances of a multi-instance channel. For single-instance channels, this attribute is the same as the Bytes Sent attribute value.

In the Channel Summary by Connection Name workspace, this attribute is summarized for a given connection.

Highest Compression Time The highest attribute value among the Short Term Compression Time attribute values from all instances of a multi-instance channel. For a single-instance channel, the attribute value is the same as the Short Term Compression Time attribute value. Although IBM MQ provides both a short-term value and a long-term value, the short-term value is selected and displayed by default.

In the Channel Summary by Connection Name workspace, this attribute is summarized for a given connection.

Highest Conversations per Client The highest value among the numbers of conversations of a server-connection channel that are grouped by clients. This attribute is valid only for server-connection channels of WebSphere MQ 7.0.1 and later versions.

Highest Current Conversations The highest value among the numbers of conversations that are running over each instance of a server-connection channel. This attribute is valid only for server-connection channels of WebSphere MQ 7.0.1 and later versions. A value of 0 indicates that the channel is running in a mode earlier than that of WebSphere MQ version 7.0 with respect to the following behaviors:

  • Administrator stop-quiesce
  • Heartbeating
  • Read ahead
  • Sharing conversations
  • Client Asynchronous Consume

In the Channel Summary by Connection Name workspace, this attribute is summarized for a given connection.

Highest Exit Time The highest attribute value among the Short Term Exit Time attribute values from all instances of a multi-instance channel. For single-instance channels, the attribute value is the same as the Short Term Exit Time value. Although IBM MQ provides both a short-term value and a long-term value, the short-term value is selected and displayed by default.

In the Channel Summary by Connection Name workspace, this attribute is summarized for a given connection.

Highest In-Doubt Samples The highest value among the numbers of consecutive samples from all instances of a channel that are found in-doubt. This attribute is not applicable to server-connection channels. Besides sender-type channels, it is applicable to receiver-type channels that can have multiple instances. This attribute is set to 0 for the channels that are not applicable.

In the Channel Summary by Connection Name workspace, this attribute is summarized for a given connection.

Highest Instances per Client The highest value among the numbers of instances of a given channel that are grouped by clients.

Highest Message Count The highest attribute value among the Message Count attribute values from all instances of a server-connection channel. For single-instance channels, this attribute is the same as the Message Count value.

In the Channel Summary by Connection Name workspace, this attribute is summarized for a given connection.

Highest Net Time The short-term duration of a network operation. The amount of time (in microseconds) to send a request to the remote end of the channel and to receive a response. The valid format is an integer. Although IBM MQ provides both a short-term value and a long-term value, the short-term value is selected and displayed by default. For historical data, this attribute shows the highest sampled value.

This attribute is only applicable to single-instance channels, and is not applicable to the channels that can have multiple instances, such as server-connection or receiver channels.

In the Channel Summary by Connection Name workspace, this attribute is summarized for a given connection.

Highest Transmit KB/Sec The highest attribute value among the Transmit KB per Sec attribute values from all instances of a multi-instance channel. For single-instance channels, this attribute is the same as the Transmit KB per Sec attribute value.

In the Channel Summary by Connection Name workspace, this attribute is summarized for a given connection.

Highest XmitQ Depth The number (depth) of messages on the transmission queue that are associated with this channel. The valid format is an integer.

This attribute is only applicable to single-instance channels, and is not applicable to the channels that can have multiple instances, such as server-connection or receiver channels. It shows the highest sampled value for historical data.

In the Channel Summary by Connection Name workspace, this attribute is summarized for a given connection.

Highest XmitQ Time The short-term transmission queue time. The time, in microseconds, that messages remained on the transmission queue before being retrieved. The time is measured from when the message is put onto the transmission queue until it is retrieved to be sent on the channel, therefore, the time includes any interval that is caused by a delay in the putting operation. The valid format is an integer. Although IBM MQ provides both a short-term value and a long-term value, the short-term value is selected and displayed by default. For historical data, this attribute shows the highest sampled value.

This attribute is only applicable to single-instance channels, and is not applicable to the channels that can have multiple instances, such as server-connection or receiver channels.

In the Channel Summary by Connection Name workspace, this attribute is summarized for a given connection.

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.

Latest Send Date & Time The latest time stamp among the Last Message Date & Time time stamps from all instances of a multi-instance channel. For single-instance channels, this attribute value is the same as the Last Message Date & Time value.

In the Channel Summary by Connection Name workspace, this attribute is summarized for a given connection.

Max Instances The maximum number of simultaneous instances of a server-connection channel that can be started. This attribute can be set in the range 0 - 999,999,999. A value of zero indicates that no client connections are allowed on this channel. The default value is 999,999,999. This attribute is valid only for server-connection channels of WebSphere MQ 7.0.1 and later versions.

Max Instances per Client The maximum number of simultaneous instances of a server-connection channel from a single client. This attribute can be set in the range 0 - 999,999,999. A value of 0 indicates that no client connections are allowed on this channel. The default value is 999,999,999. This attribute is valid only for server-connection channels of WebSphere MQ 7.0.1 and later versions.

Max Sharing Conversations The maximum number of conversations that can run over each instance of a server-connection channel. This attribute is valid only for server-connection channels of WebSphere MQ 7.0.1 and later versions. A value of 0 indicates that the channel is running in a mode earlier than that of WebSphere MQ version 7.0 with respect to the following behaviors:

  • Administrator stop-quiesce
  • Heartbeating
  • Read ahead
  • Sharing conversations
  • Client asynchronous consume

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.

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.

Running Instances The number of instances of a given channel or a connection in the running status.

Retrying Instances The number of instances of a given channel or a connection in the retrying status.

Summary Type Indicates whether the data is summarized on a channel level or on a connection level. Valid values are as follows:

  • Channel Summary = 0 (default)
  • Connection Name Summary = 1

Total Conversations The total number of conversations across all instances of a server-connection channel. This attribute is valid only for server-connection channels of WebSphere MQ 7.0.1 and later versions.

In the Channel Summary by Connection Name workspace, this attribute is summarized for a given connection.

Total Instances The number of total instances of a given channel or a connection.