Channel Statistics attributes
Use the Channel Statistics attributes to create situations for detecting channel performance problems. This attribute group provides channel performance information for each monitored channel within a queue manager. For example, you can create a situation to detect in-doubt channels or problems with channel status. Channel Statistics is a multiple-instance attribute group. You cannot mix these attributes with attributes of any other multiple-instance group.
Batch Size The negotiated batch size to be used. The valid format is an integer.
Batches Complete The number of logical units of work (LUWs) that this channel processed since it was initialized. This attribute is not available for CICS channels. The valid format is an integer.
Buffers Received The total number of buffers that are received during the current interval or aggregation period. The valid format is an integer.
Buffers Sent The total number of buffers that are sent during the current interval or aggregation period. The valid format is an integer.
Bytes Received The total number of bytes that are received during the current interval or aggregation period. The valid format is an integer.
Bytes Received (Deprecated) The total number of bytes that are received during the current interval or aggregation period. The valid format is an integer.
Bytes Sent The total number of bytes that are sent during the current interval or aggregation period. The valid format is an integer.
Bytes Sent (Deprecated) The total number of bytes that are sent during the current interval or aggregation period. The valid format is an integer.
Channel Name The name of this channel. The valid format is an alphanumeric string of up to 20 case-sensitive characters.
Channel Status The current operational status of the channel. n/a means the channel is not currently active (thus no short-term history data is available) but was active in the recent past (thus long-term history data is available).
For CICS channels, status is either In-Doubt or the CICS status (Conn_Not_Def, Out_Service, Going_Out, Released, Obtaining, Acquired, Freeing, or Available).
Valid values are as follows:
- n/a = 0
- Binding = 1
- Starting = 2
- Running = 3
- Stopping = 4
- Retrying = 5
- Stopped = 6
- Requesting = 7
- Paused = 8
- Initializing = 13
- Inactive = 101
- Conn_Not_Def = 200
- Out_Service = 201
- Going_Out = 202
- Released = 203
- Obtaining = 204
- Acquired = 205
- Freeing = 206
- Available = 207
- Unknown = 255
Channel Type The type that is assigned to the channel when it is created. Valid values are as follows:
- n/a = 0
- 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)
Completed Retry Time The time in seconds for all completed retry intervals after the channel goes into a retry state. This does not indicate elapsed time because it only includes the interval time up to the last completed retry interval. This value includes both short and long retry intervals. The valid format is an integer.
Connection Name The name of the physical or logical connection that this channel uses to transmit or receive data. This name is formed from the connection type (IP for TCP/IP, LU for LU6.2, or NETBIOS) and the connection address. This is the name of a currently active connection. One channel might have more than one active connection simultaneously. The valid format is an alphanumeric string of up to 264 case-sensitive characters. If multiple connections are configured for the channel, this attribute is displayed as a comma separated list of names of systems for the stated Transport Type attribute.
CurBatch LUW ID The identifier that is assigned to the current logical unit of work (LUW). If a sender channel is in doubt, this is the problem batch. This attribute is not available for CICS channels. The valid format is an alphanumeric string of up to 16 case-sensitive characters.
CurBatch Messages The number of messages that are processed for the current logical unit of work (LUW). If a sender channel is in doubt, this is the number of messages currently in doubt. This attribute is not available for CICS channels. The valid format is an integer.
CurMsg SeqNo The number of the last message that is sent for the logical unit of work (LUW) that the in-doubt channel is currently processing. This attribute is not available forCICS channels. The valid format is an integer.
Cur Defn Indicates whether the queue or channel is currently defined on the monitored queue manager. Valid values are No = 0 and Yes = 1.
Current Action State The current action that is being performed by the channel. Valid values are as follows:
- n/a = -1
- Other = 0
- End_Of_Batch = 100
- Sending = 200
- Receiving = 300
- Serializing = 400
- Resynching = 500
- Heartbeating = 600
- Security_exit = 700
- Receive_exit = 800
- Sending_exit = 900
- Message_exit = 1000
- Retry_exit = 1100
- Channel_definition_exit = 1200
- Net_connection = 1250
- SSL_hand_shaking = 1300
- Name_server = 1400
- MQPut = 1500
- MQGet = 1600
- MQI_Call = 1700
- Compressing = 1800
Current Sharing Conversations The number of conversations that are currently running over the channel instance. The valid format is an integer.
Default Header Compression The default techniques for header data compression that are supported by the channel. Valid values are as follows:
- n/a = -1
- None = 0
- Run_Length_Encoding_Compression = 1
- ZLIB_Encoding_Speed_Compression = 2
- ZLIB_Encoding_High_Compression = 4
- System = 8
- Any = 268435455
Default Message Compression The default techniques for message data compression that are supported by the channel. Valid values are as follows:
- n/a = -1
- None = 0
- Run_Length_Encoding_Compression = 1
- ZLIB_Encoding_Speed_Compression = 2
- ZLIB_Encoding_High_Compression = 4
- System = 8
- Any = 268435455
Heartbeat Interval The approximate time between heartbeat flows that are to be passed from a sending MCA when there are no messages on the transmission queue. The valid format is an integer.
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.
In-Doubt Status Indicates whether this channel is in doubt. Valid values are No = 0, Yes = 1, and n/a = 255. A channel is considered in doubt when a logical unit of work (LUW) was sent and the channel is waiting for an acknowledgment that the LUW was successfully received.
Interval Time The size of the current sampling interval, in hundredths of seconds. For example, .50 is half a second. This value is determined by the control parameters your site set when configuring the IBM MQ Monitoring agent; it is usually specified as 60 (60 seconds). The valid format is a decimal (formatted to 2 decimal places).
Keep Alive Interval The timeout value for a channel. The valid format is an integer.
Last Header Compression The last techniques for header data compression that are supported by the channel. Valid values are as follows:
- n/a = -1
- None = 0
- Run_Length_Encoding_Compression = 1
- ZLIB_Encoding_Speed_Compression = 2
- ZLIB_Encoding_High_Compression = 4
- System = 8
- Any = 268435455
Last Message Compression The last techniques for message data compression that are supported by the channel. Valid values are as follows:
- n/a = -1
- None = 0
- Run_Length_Encoding_Compression = 1
- ZLIB_Encoding_Speed_Compression = 2
- ZLIB_Encoding_High_Compression = 4
- System = 8
- Any = 268435455
Last Send Date and Time Last Send Date and Time value of the channels that match this channel type/channel status combination.
Last Send Date & Time The date and time that the last message was sent to the current channel/connection name combination. This attribute is not available for CICS channels.
Local Address The local communications address for the channel. The value returned depends on the TRPRYPE of the channel (currently only TCP/IP is supported). The valid format is an alphanumeric string of up to 48 case-sensitive characters.
Long Retries The number of long retry intervals that were completed since the channel went into retry state due to a connection failure. The maximum number of long retries is defined during channel definition using the LONGRTY keyword. The time interval in seconds for long retries is defined during channel definition using the LONGTMR keyword. The IBM MQ Monitoring agent attempts long retries after the channel reaches the maximum number of short retry attempts for the channel. The valid format is an integer.
Long Term Batch Size The long-term number of messages in a batch. The valid format is an integer.
Long Term Compression Rate Long term compression rate that is achieved to the nearest percentage. The valid format is a floating point number with a range from -1 - 100.
Long Term Compression Time Long term amount of time per message, in microseconds, spent during compression or decompression. The valid format is an integer.
Long Term Exit Time Long term amount of time per message, in microseconds, spent during executing user exits. The valid format is an integer.
Long Term Net Time Long term time of a network operation. The amount of time, in microseconds, to send a request to the remote end of the channel and receive a response. The valid format is an integer.
Long Term XmitQ Time Long term transmission queue time. The valid format is an integer.
LUW Last Committed The identifier of the last-committed logical unit of work (LUW). The valid format is an alphanumeric string of up to 16 case-sensitive characters.
Max Sharing Conversations The negotiated maximum number of conversations that can run over this particular instance of a server-connection channel. The valid format is an integer.
MAX Transmit KB/Sec Maximum value of Transmit Kilobytes per Second for channels that match this channel type/channel status combination.
Maximum Msg Len The maximum length of a message that can be transmitted on the channel. This attribute is for z/OS systems only, and always display n/a for distributed systems. The valid format is an integer.
MCA Job Name The MCA job name string that is associated with a channel that uniquely identifies that channel. This is not a user-friendly name, but it is provided to differentiate (along with Connection Name) between multiple active channel connections that can be defined to the same queue manager. The valid format is an alphanumeric string of up to 28 case-sensitive characters. This attribute is for non z/OS systems only.
MCA Status The status of the message channel agent. Valid values are Stopped = 0 and Running = 3.
MCA User ID The user ID that is used by the MCA for authorization to access IBM MQ resources. The valid format is an alphanumeric string of up to 12 characters. If the length of the user ID exceeds 12 characters, only the first 12 characters are displayed.
Message Count The number of messages that are sent or received on this channel during the current interval or aggregation period. For the Interval Summary row in the Recent Channel report, this count is the sum of all the message counts in the subsequent rows. This attribute is not available for CICS channels. The valid format is an integer.
- n/a = -10
- Queue_Manager = -3 (The level of monitoring data collected is based on the queue manager attribute.)
- None = -1
- Off = 0 (Monitoring data collection is turned off.)
- On = 1 (Monitoring data collection is turned on.)
- Low = 17 (Monitoring data collection is turned on with a low ratio of data collection.)
- Medium = 33 (Monitoring data collection is turned on with a medium ratio of data collection.)
- High = 65 (Monitoring data collection is turned on with a high ratio of data collection.)
- n/a = -1
- Normal = 1
- Fast = 2
Number of Channels Number of channels that match the channel type/channel status combination that are displayed in this row of the Channel Performance by Type/Status table view. It is calculated using the Channel Name attribute that is previously described.
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.
QSG Disp Indicates the disposition of the channel in a queue-sharing group environment. Valid values are Qmgr = 0, Copy = 1, Group = 3, and Unknown = 255. This attribute is for QSG environment on z/OS systems only.
QSG Name The name of the queue sharing group. The valid format is an alphanumeric string of up to 4 case-sensitive characters. This attribute is for QSG environment on z/OS systems only.
Remote Partner Application Name Name of the client application at the remote end of the channel. This parameter applies only to server-connection channels. The valid format is an alphanumeric string of up to 48 characters.
- MQMM
- Queue manager on a distributed systems
- MQMV
- Queue manager on z/OS® systems
- MQCC
- IBM® MQ C client
- MQNC
- IBM MQ client for HP Integrity NonStop Server
- MQNM
- IBM MQ .NET fully managed client
- MQJB
- IBM MQ Classes for JAVA
- MQJM
- IBM MQ Classes for JMS (normal mode)
- MQJN
- IBM MQ Classes for JMS (migration mode)
- MQJU
- Common Java™ interface to the MQI
- MQXC
- XMS client C/C++ (normal mode)
- MQXD
- XMS client C/C++ (migration mode)
- MQXN
- XMS client .NET (normal mode)
- MQXM
- XMS client .NET (migration mode)
- MQXU
- IBM MQ .NET XMS client (unmanaged/XA)
- MQNU
- IBM MQ .NET unmanaged client
- VV
- Version
- RR
- Release
- MM
- Maintenance level
- FF
- Fix level
Remote Qmgr Name The queue manager name or queue sharing group name of the remote system. The valid format is an alphanumeric string of up to 48 case-sensitive characters.
- NONE = 0
- SSLV3 = 1
- TLSV1 = 2
- TLSV12 = 4
- n/a = -1
SeqNo Last Committed The number of the last-committed message within the last-committed logical unit of work (LUW). The valid format is an integer.
Short Retries The number of short retry intervals that complete after the channel goes into a retry state because of a connection failure. The maximum number of short retries is defined during channel definition using the SHORTRTY keyword. The time interval in seconds for short retries is defined during channel definition using the SHORTTMR keyword.
If the channel continually fails to connect after reaching the maximum number of short retry attempts, the IBM MQ Monitoring agent attempts long retries using the longer interval defined. If this value is non-zero and the channel is not currently retrying, it gives the most recent retry information that is returned as the current channel status by IBM MQ.
This value is not available for CICS channels. The valid format is an integer.
Short Term Batch Size Indicates the short-term number of messages in a batch. The valid format is an integer.
Short Term Compression Rate Short-term compression rate that is achieved to the nearest percentage. The valid format is a floating point number with a range from -1 - 100.
Short Term Compression Time Short-term amount of time per message, in microseconds, spent during compression or decompression. The valid format is an integer.
Short Term Exit Time Short-term amount of time per message, displayed in microseconds, spent during executing user exits. The valid format is an integer.
Short Term Net Time Short-term time of a network operation. The amount of time (in microseconds) to send a request to the remote end of the channel and receive a response. The valid format is an integer.
Short Term XmitQ Time Short-term transmission queue time. The valid format is an integer.
SSL Cert Issuer Name The full Distinguished Name of the issuer of the remote certificate. The valid format is an alphanumeric string of up to 256 characters.
SSL Cert User ID The local user ID that is associated with the remote certificate. The valid format is an alphanumeric string of up to 12 characters.
SSL Key Count The number of successful SSL secret key resets that occurred for this channel instance since the channel started. The valid format is an integer.
SSL Key Date & Time The date and time of the previous successful SSL secret key reset. 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
SSL Short Peer Name The distinguished name of the peer queue manager or client at the other end of the channel. The valid format is an alphanumeric string of up to 256 characters.
Start Date & Time The start 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 Batches Complete Sum of Batches Complete values for channels that match this channel type/channel status combination.
Total Buffers Received Sum of Buffers Received values for channels that match this channel type/channel status combination.
Total Buffers Sent Sum of Buffers Sent values for channels that match this channel type/channel status combination.
Total Bytes Received Sum of Bytes Received values for channels that match this channel type/channel status combination.
Total Bytes Sent Sum of Bytes Sent values for channels that match this channel type/channel status combination.
Total CurBatch Messages Sum of Current Batch Messages values for channels that match this channel type/channel status combination.
Total Message Count Sum of Message Count values for channels that match this channel type/channel status combination.
Total Transmit KB/Sec Sum of Transmit Kilobytes per Second values for channels that match this channel type/channel status combination.
Transmission Queue Name The name of the transmit queue. The valid format is an alphanumeric string of up to 48 case-sensitive characters.
Transmit KB/Sec The transmission rate (in kilobytes per second) over the latest interval. This attribute is not available for CICS channels. The valid format is a decimal (formatted to 2 decimal places).
Transport Type The transmission type. Valid values are as follows:
- LOCAL = 0
- LU62 = 1
- TCP = 2
- NETBIOS = 3
- SPX = 4
- DECNET = 5
- UDP = 6
- CICS = 100
User Stop Request Indicates whether user stop request is outstanding. Valid values are n/a = -1, Stop_Not_Requested = 0, and Stop_Requested = 1.
XmitQ Depth The number of messages on the transmission queue that is associated with this channel. The valid format is an integer.
XmitQ Messages Available The number of messages that are queued on the transmission queue and available to the channel for the MQGET call. The valid format is an integer.