Channel Short-Term History attributes

Use the Channel Short-Term History attributes to detect channel performance problems. This attribute group provides channel performance information for each monitored channel within a queue manager. These attributes are informational only; they cannot be used to create situations.

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) this channel has processed since it is initialized. This attribute is not available for CICS channels. The valid format is an integer.

Buffers Received The total number of buffers received during the current interval or aggregation period. The valid format is an integer.

Buffers Sent The total number of buffers sent during the current interval or aggregation period. The valid format is an integer.

Bytes Received The total number of bytes received during the current interval or aggregation period. The valid format is an integer.

Bytes Received (Deprecated) The total number of bytes received during the current interval or aggregation period. The valid format is an integer.

Bytes Sent The total number of bytes sent during the current interval or aggregation period. The valid format is an integer.

Bytes Sent (Deprecated) The total number of bytes 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 (Starting, Binding, Running, Retrying, Requesting, Paused, Initializing, In-Doubt, Inactive, Stopping, Stopped, or Unknown). "n/a" means the channel is not currently active (thus no short-term history data is available) but has been 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 assigned to the channel (SDR for sender, SVR for server, RCVR for receiver, RQSTR for requester, CLNTCONN for client connection, SVRCONN for server connection, CLUSRCVR for cluster receiver, or CLUSSDR for cluster sender) when it was created. Valid values are as follows:

  • n/a = 0
  • SDR = 1
  • SVR = 2
  • RCVR = 3
  • RQSTR = 4
  • CLNTCONN = 6
  • SVRCONN = 7
  • CLUSRCVR = 8
  • CLUSSDR = 9
  • MQCHT_MQTT=10

Completed Retry Time The time in seconds for all completed retry intervals after the channel goes into a retry state. 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. 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 system names.

CurBatch LUW ID The identifier 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 processed so far 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 sent for the logical unit of work (LUW) that the in-doubt channel is currently processing. This attribute is not available for CICS channels. The valid format is an integer.

Cur Defn 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 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 header data compression default techniques 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 message data compression default techniques 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 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) has been sent and the channel is waiting for an acknowledgment that the LUW has been successfully received (in other words, when a syncpoint has been requested but not yet performed).

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.00 (60 seconds). 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 header data compression last techniques 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 message data compression last techniques 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 & Time The date and time the last message was sent to the current channel/connection name combination. This attribute is not available for CICS channels. 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

Local Address The local communication address for the channel. The value returned depends on the TRPRYPE value 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 complete after the channel goes into a retry state because of a connection failure. The valid format is an integer.

Long Term Batch Size Indicates the long term number of messages in a batch. The valid format is an integer.

Long Term Compression Rate Long-term compression rate 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, displayed in microseconds, spent during compression or decompression. The valid format is an integer.

Long Term Exit Time Long-term time taken executing user exits per message. 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 Indicates the long-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 and, therefore, includes any interval caused by a delay in the putting applications. Valid format is an integer.

LUW Last Committed The identifier of the last-committed logical unit of work (LUW). 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.

Maximum Msg Len The maximum length of a message that can be transmitted on the channel. The valid format is an integer.

MCA Job Name Specifies the MCA job name string that is associated with a channel that uniquely identifies that channel. This name 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 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.

Monitoring Channel Level The level of monitoring data collection for the channel Valid values are as follows:
  • 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.)
Non-Persist Msg Speed The speed at which nonpersistent messages travel through the channel. Valid values are as follows:
  • n/a = -1
  • Normal = 1
  • Fast = 2

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 assigned to this queue manager. The valid format is an alphanumeric string of up to 48 case-sensitive characters.

Remote Partner Application Name The name of the client application at the remote end of the channel. This attribute applies only to server-connection channels. The valid format is an alphanumeric string of up to 48 characters.

Remote Partner Product Identifier The product identifier of the IBM MQ code running at the remote end of the channel. Possible values are as follows:
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
Remote Partner Version The version of the IBM MQ code running at the remote end of the channel. The remote version is displayed as VVRRMMFF, where
VV
Version
RR
Release
MM
Maintenance level
FF
Fix level

Remote Qmgr Name The name assigned to the queue manager or queue sharing group of the remote system. This parameter does not apply to server-connection channels, where no values are returned. The valid format is an alphanumeric string of up to 48 case-sensitive characters.

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
Security Protocol The security protocol that is used. Valid values are as follows:
  • 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 while the channel is not currently retrying, it gives the most recent retry information still being returned as current channel status by IBM MQ.

This value is not available (0) 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 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, displayed in microseconds, spent during compression or decompression. Valid format is an integer.

Short Term Exit Time Short-term time taken executing user exits per message. 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 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 and, therefore, includes any interval caused by a delay in the putting application 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. 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

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 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

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 transport type that is used. 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 (that is, depth) of messages on the transmission queue associated with this channel. The valid format is an integer.

XmitQ Messages Available The number of messages available. The valid format is an integer.