Channel Status attributes
Use the Channel Status attributes to create situations for detecting channel status problems. The Channel Status attributes provide channel status information for each monitored channel within a queue manager.
Batch Size Negotiated batch size. The valid format is an integer.
Batches Complete Number of complete batches. The valid format is an integer.
Buffers Received Number of buffers that are received. The valid format is an integer.
Buffers Sent Number of buffers that are sent. The valid format is an integer.
Bytes Received Number of bytes that are received. The valid format is an integer.
Bytes Received (Deprecated) Number of bytes that are received. The valid format is an integer.
Bytes Sent Number of bytes that are sent. The valid format is an integer.
Bytes Sent (Deprecated) Number of bytes that are sent. The valid format is an integer.
Channel Disp Disposition of channel on a z/OS system. Valid values are as follows:
- n/a = -2
- All = -1
- Shared = 2
- Private = 4
- Fixshared = 5
Channel Inst Type Type of channel instance. Valid values are as follows:
- Current = 1011
- Saved = 1012
- Short = 1015
Channel Name Name of the channel. Valid format is an alphanumeric string of up to 20 case-sensitive characters.
Channel Status Status of the channel. The valid format is an integer. 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 Type of the channel. Valid format is an integer. Valid values are as follows:
- n/a = 0
- Sender = 1
- Server = 2
- Receiver = 3
- Requester = 4
- Client-connection = 6
- Server-connection = 7
- Cluster-receiver = 8
- Cluster-sender = 9
Connection Name Name of the connection. This is the connection name that is obtained using the MQSC DIS CHS command (see IBM MQ documentation for further information about this command). The valid format is an alphanumeric string of up to 264 case-sensitive characters.
CurBatch LUW ID Logical unit of work identifier for in doubt batch. The logical unit of work identifier is associated with the current batch for a sending or receiving channel. For an in-doubt sending channel, it is the LUW ID of the in doubt batch. It is updated with the LUW ID of the next batch when it is known. The valid format is an integer.
CurBatch Messages Number of messages that are in doubt. For a sending channel, this is the number of messages that are sent in the current batch. It is incremented as each message is sent, and when the channel becomes in doubt, it is the number of messages that are in doubt. For a receiving channel, it is the number of messages that are received in the current batch. It is incremented as each message is received. The valid format is an integer.
CurMsg SeqNo Sequence number of the last message in the in-doubt batch. For a sending channel, this is the message sequence number of the last sent message. It is updated as each message is sent, and when the channel becomes in-doubt, it is the message sequence number of the last message in the in-doubt batch. For a receiving channel, it is the message sequence number of the last message that is received. It is updated as each message is received.
Current Action State 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 It is blank for all channel types other than server-connection channels. For each instance of a server-connection channel, it gives the number of conversations that are currently running over that channel instance.
Default Header Compression Indicates whether header data that is sent by the channel is compressed. 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 Whether message data that is sent by the channel is compressed. This is the default value assigned when the channel is created if no other value is assigned by the user. 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 Interval of heartbeat. The valid format is an integer.
Host Name Name of the host on which the queue manager is running. The valid format is an alphanumeric string of up to 48 case-sensitive characters.
In-Doubt Status Whether the channel is currently in doubt. A sending channel is in doubt only when the sending MCA is waiting for an acknowledgment that a batch of messages, which it sent, was successfully received. It is not in doubt at all other times, including the period during which messages are being sent, but before an acknowledgment is requested. The valid format is an alphanumeric string of up to 48 case-sensitive characters. Valid values are as follows:
- No = 0
- Yes = 1
- n/a = 255
Keep Alive Interval Keep alive interval. If the channel is idle for the length of time that is specified by this attribute (in seconds), the queue polls the other queue that is connected to the channel to ensure that the connection is still functioning. Valid values are as follows:
- Auto = -1
- n/a = -2
Last Header Compression Indicates whether header data that is sent by the channel is compressed. 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 This value determines whether message data sent by the channel is compressed. 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 Date & Time Date and time at which the last message is sent or MQI call is handled. 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 communications address for the channel. The valid format is an alphanumeric string of up to 48 case-sensitive characters.
Long Retries Left Number of long retry attempts that remain. The valid format is an integer.
Long Term Batch Size Indicator of the number of messages in a batch based on activity over a long period of time. The valid format is an integer.
Long Term Compression Rate Compression rate to the nearest percentage point based on activity over a long period of time. The valid format is a floating point number.
Long Term Compression Time The amount of time per message, in microseconds, spent on compression or decompression based on activity over a long period of time. The valid format is an integer.
Long Term Exit Time The amount of time per message, in microseconds, spent processing user exits based on activity over a long period of time. If more than one exit is processed per message, the value is the sum of all the user exit times. The valid format is an integer.
Long Term Net Time The amount of time, in microseconds, from when a request is sent to the remote end of the channel until a response is received, based on activity over a long period of time. The valid format is an integer.
Long Term XmitQ Time The amount of time in microseconds that messages remain on the transmission queue before being retrieved, based on activity over a long period of time. 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 value includes any interval caused by a delay in the putting application.
LUW Last Committed Logical unit of work identifier for last committed batch. The valid format is an integer.
Max Sharing Conversations It is blank for all channel types other than server-connection channels. For each instance of a server-connection channel, it gives the negotiated maximum of the number of conversations that can run over that channel instance. The valid format is an integer.
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 Name of MCA job. The valid format is an alphanumeric string of up to 28 case-sensitive characters.
MCA Status Status of the MCA. Valid values are as follows:
- n/a = -1
- Stopped = 0
- Running = 3
MCA User ID User identifier used by the MCA. It applies to server-connection, receiver, requester, and cluster-receiver connections. The valid format is an alphanumeric string of up to 12 case-sensitive characters.
Message Count Number of messages that are sent or received, or number of MQI calls that are handled. The valid format is an integer.
Monitoring Level Current amount of monitoring data that is collected for the channel. Valid values are as follows:
- Queue_Manager = -3
- n/a = -1
- Off = 0
- Low = 17
- Medium = 33
- High = 65
QMgr Name Name of the queue manager. Valid format is an alphanumeric string of up to 48 case-sensitive characters.
Non-Persist Msg Speed Speed at which nonpersistent messages are sent. Valid values are as follows:
- n/a = -1
- Normal = 1
- Fast = 2
Origin Node Node name of the managed system. The valid format is an alphanumeric string of up to 128 case-sensitive characters.
Remote Partner Application Name Name of the client application at the remote end of the channel for server-connection channels. The valid format is an alphanumeric string of up to 48 case-sensitive 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 Name of the remote queue manager, or queue sharing group. 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 Sequence number of the last message in the last committed batch. The valid format is an integer.
Short Retries Left Number of short retry attempts remaining. The valid format is an integer.
Short Term Batch Size Indicator of the number of messages in a batch based on recent activity over a short period of time. The valid format is an integer.
Short Term Compression Rate Compression rate to nearest percentage point based on recent activity over a short period of time. The valid format is a floating point number.
Short Term Compression Time The amount of time per message, in microseconds, spent on compression or decompression based on recent activity over a short period of time. The valid format is an integer.
Short Term Exit Time The amount of time per message, in microseconds, spent processing user exits based on recent activity over a short period of time. If more than one exit is processed per message, the value is the sum of all the user exit times. The valid format is an integer.
Short Term Net Time The amount of time, in microseconds, from when a request is sent to the remote end of the channel until a response is received, based on recent activity over a short period of time. The valid format is an integer.
Short Term XmitQ Time The amount of time in microseconds that messages remained on the transmission queue before being retrieved, based on recent activity over a short period of time. 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 value includes any interval caused by a delay in the putting application.
SSL Cert Issuer Name The full Distinguished Name of the Certificate Authority that issues the remote certificate. Valid format is an alphanumeric string of up to 256 case-sensitive characters.
SSL Cert User ID The local user ID that is associated with the remote certificate (z/OS systems only). The valid format is an alphanumeric string of up to 12 case-sensitive characters.
SSL Key Count The number of SSL secret key resets that occurred for this channel instance since the channel was started. If the SSL secret key negotiation is enabled, the count is incremented whenever a secret key reset is performed. The valid format is an integer.
SSL Key Date & Time Date and time of the previous 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 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 case-sensitive characters. Exceptionally long distinguished names are truncated.
Start Date & Time The date and time at which the channel is started. 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 Channel transmission rate in kilobytes per second. The valid format is an integer.
User Stop Request Indicates whether user stop request is outstanding. Valid values are as follows:
- n/a = -1
- Stop_Not_Requested = 0
- Stop_Requested = 1
XmitQ Messages Available Number of messages on the transmission queue that are available to the channel for the MQGET call. The valid format is an integer.
XmitQ Name Name of the transmission queue. The valid format is an alphanumeric string of up to 48 case-sensitive characters.