Channel status attributes
The status attributes of channels. In addition to viewing the status of a channel, you can view its saved status.
A channel's status is continually updated as messages are sent and received. A channel's saved status is updated only at the following times:
- For all channels:
- When the channel enters or leaves Stopped or Retrying state
- For a sending channel:
- Before requesting confirmation that a batch of messages has been received
- When confirmation is received
- For a receiving channel:
- Just before confirming that a batch of messages has been received
- For a server-connection channel:
- No data is saved
Therefore, a channel that has never been current cannot have any saved status. The attributes that are displayed for a channel's saved status are a subset of the attributes that are displayed for a channel's status; these attributes are known as common attributes. The common attributes are marked with an asterisk (*) in the following table.
For each attribute, there is a brief description of what information the attribute shows. The table also gives the equivalent MQSC parameter for the DISPLAY CHSTATUS command. For more information about MQSC commands, see Script (MQSC) Commands in the IBM® MQ online product documentation.
Attribute | Meaning | MQSC parameter |
---|---|---|
*Channel status | The status of the channel, which can be Starting, Binding, Initializing, Running, Stopping, Retrying, Paused, Stopped, or Requesting. | STATUS |
*Connection name | The connection name for which status information is displayed for the channel. | CONNAME |
Remote queue manager | The queue manager name, or queue-sharing group name, of the remote system. | RQMNAME |
*Channel instance type | The type of the channel, which can be Sender, Server, Receiver, Requester, Cluster-sender, Cluster-receiver, Server-connection. | CHLTYPE |
*Transmission queue | The name of the transmission queue for which status information is displayed for the specified channel. | XMITQ |
*Messages | The number of messages that have been sent or received (or, for server-connection channels, the number of MQI calls handled) since the channel was started. | MSGS |
Messages available | The number of messages that are queued on the transmission queue and are available to the channel for MQGETs. | XQMSGSA |
Channel substate | The action that the channel is currently performing. | SUBSTATE |
*Indoubt status | Whether the channel is currently in doubt. This is only YES while the sending Message Channel Agent is waiting for an acknowledgment that a batch of messages that it has sent has been successfully received. It is NO at all other times, including the period during which messages are being sent, but before an acknowledgment has been requested. For a receiving channel, the value is always NO. | INDOUBT |
MCA User ID | The user ID used by the MCA. This can be the user ID that is set in the channel definition, the default user ID for MCA channels, a user ID specified by a security exit, or, if the channel is a server-connection channel, a user ID transferred from a client | MCAUSER |
*Short peer name | The Distinguished Name of the peer queue manager or client at the other end of the channel. The maximum length is 256 characters, so longer Distinguished Names are truncated. | SSLPEER |
Compression rate | The compression rate achieved, displayed to the nearest percent. This displays a short-term indicator and a long-term indicator. These values are reset every time the channel is started and are displayed only when the channel is running. | COMPRATE |
*Channel monitoring | The current level of monitoring data collection for the channel. | MONCHL |
*Last sequence number | The number of the last message in the last batch that was committed by the channel. | LSTSEQNO |
*Last LUWID | The number of the last logical unit of work that was committed by the channel. | LSTLUWID |
*Current messages | For a sending channel, this is the number of messages that have been sent in the current batch. The value 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 saved channel instance, this parameter has meaningful information only if the channel instance is in doubt. However, the parameter value is still returned when requested, even if the channel instance is not in doubt. For a receiving channel, it is the number of messages that have been received in the current batch. It is incremented as each message is received. The value is reset to zero, for both sending and receiving channels, when the batch is committed. | CURMSGS |
*Current sequence number | For a sending channel, this is the message sequence number of the last message sent. 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 saved channel instance, this parameter has meaningful information only if the channel instance is in doubt. However, the parameter value is still returned when requested, even if the channel instance is not in doubt. For a receiving channel, it is the message sequence number of the last message that was received. It is updated as each message is received. | CURSEQNO |
*Current LUWID | The logical unit of work identifier that is associated with the current batch, for a sending or a receiving channel. For a sending channel, when the channel is in doubt it is the LUWID of the in-doubt batch. For a saved channel instance, this parameter has meaningful information only if the channel instance is in doubt. However, the parameter value is still returned when requested, even if the channel instance is not in doubt. It is updated with the LUWID of the next batch when this is known. | CURLUWID |
Last message time | The time when the last message was sent or MQI call was handled. For a sender or server, this is the time the last message (the last part of it if it was split) was sent. For a requester or receiver, it is the time the last message was put to its target queue. For a server-connection channel, it is the time when the last MQI call completed. | LSTMSGTI |
Last message date | The date when the last message was sent or MQI call was handled. | LSTMSGDA |
Bytes sent | The number of bytes sent since the channel started. This includes control information sent by the Message Channel Agent. | BYTSSENT |
Bytes received | The number of bytes received since the channel started. This includes control information received by the Message Channel Agent. | BYTSRCVD |
Batches | The number of batches completed since the channel started. | BATCHES |
Start time | The time when this channel started (in the form hh.mm.ss). | CHSTATI |
Start date | The date when this channel started (in the form yyyy-mm-dd). | CHSTADA |
Buffers sent | The number of transmission buffers sent. This includes transmission to send control information only. | BUFSSENT |
Buffers received | The number of transmission buffers received. This includes transmissions to receive control information only. | BUFSRCVD |
Long retries left | The number of long retry wait start attempts left. This applies only to sender or server channels. | LONGRTS |
Short retries left | The number of short retry wait start attempts left. This applies only to sender or server channels. | SHORTRTS |
MCA job name | The name of the job currently serving the channel. The format depends on the platform: On OS/400®, UNIX systems, and Windows, this is the concatenation of the process identifier and the thread identifier of the MCA program displayed in hexadecimal. On HP Integrity NonStop Server, this is the processor ID and PID displayed in hexadecimal. This information is not available on z/OS®. | JOBNAME |
MCA status | The status of the Message Channel Agent, which is Running or Not running. | MCASTAT |
Stop requested | Whether a user stop request is outstanding. The value is Yes or No. | STOPREQ |
Batch size | The batch size that is being used for this session (valid only on AIX®, HP-UX, Linux, OS/400, Solaris, Windows, and z/OS). | BATCHSZ |
Heartbeat interval | The heartbeat interval that is being used for this session. | HBINT |
NPM speed | The nonpersistent message handling technique that is being used for this session. | NPMSPEED |
Local address | The local communications address for the channel. The value depends on the transport type of the channel. Currently, only TCP/IP is supported. | LOCLADDR |
Xmit 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 on 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. The cell displays two values: a value based on recent activity over a short period of time, and a value based on activity over a longer period of time. These values depend on the configuration and behavior of your system, as well as the levels of activity within it, and serve as an indicator that your system is performing normally. A significant variation in these values might indicate a problem with your system. The values are reset every time the channel is started and are displayed only when the channel is running. | XQTIME |
Exit time | The amount of time, displayed in microseconds, that each message spent processing user exits. The cell displays two values: a value based on recent activity over a short period of time, and a value based on activity over a longer period of time. These values depend on the configuration and behavior of your system, as well as the levels of activity within it, and serve as an indicator that your system is performing normally. A significant variation in these values may indicate a problem with your system. They are reset every time the channel is started and are displayed only when the channel is running. | EXITTIME |
Network time | The amount of time, displayed in microseconds, to send an end
of batch request to the remote end of the channel and receive a response.
This is the time between sending the last message in a batch and receiving
the end of batch acknowledgment, minus the processing time of the
end of batch request at the remote end. There are two elements that
make up the network time:
|
NETTIME |
XMIT Batch size | The size of the batches transmitted over the channel. Two values are displayed: a value based on recent activity over a short period of time, and a value based on activity over a longer period of time. These values depend on the configuration and behavior of your system, as well as the levels of activity within it, and serve as an indicator that your system is performing normally. A significant variation in these values might indicate a problem with your system. The values are reset every time the channel is restarted and are displayed only when the channel is running. | XBATCHSZ |
Compression time | The amount of time per message, in microseconds, spent during compression or decompression. This attribute displays a short-term indicator and a long-term indicator. These values are reset every time the channel is started and are displayed only when the channel is running. | COMPTIME |
Message compression | The technique used to compress the message data sent by the channel. Two values are shown: the default message data compression value negotiated for the channel, and the message data compression value used for the last message that was sent. If no message has been sent through the channel, the second value is blank. | COMPMSG |
Header compression | Whether the header data that is sent by the channel is compressed. Two values are shown: The default header data compression value negotiated for the channel, and the header data compression value that was used for the last message that was sent. If no message has been sent through the channel, the second value is blank. | COMPHDR |
SSL key resets | The number of successful TLS key resets. The count of TLS secret key resets is reset when the channel instance ends. For more information, see Resetting SSL and TLS secret keys in the IBM MQ online product documentation. | SSLRKEYS |
SSL key reset date | The date on which the previous successful TLS secret key was reset. The count of TLS secret key resets is reset when the channel instance ends. For more information, see Resetting SSL and TLS secret keys in the IBM MQ online product documentation. | SSLKEYDA |
SSL key reset time | The time at which the previous successful TLS secret key was reset. The count of TLS secret key resets is reset when the channel instance ends. For more information, see Resetting SSL and TLS secret keys in the IBM MQ online product documentation. | SSLKEYTI |
SSL cert user ID | The local user ID associated with the remote certificate. | SSLCERTU |
SSL cert issuer name | The full Distinguished Name of the issuer of the remote certificate. The issuer is the Certificate Authority that issued the certificate. The maximum length is 256 characters, so longer Distinguished Names are truncated. | SSLCERTI |
Remote partner version | The version of the IBM MQ code running at the remote end of the channel. If the remote version is blank, the remote partner is at version 6 or earlier. | RVERSION |