DISPLAY CHSTATUS (MQTT)
Use the MQSC command DISPLAY CHSTATUS (MQTT) to display the status of one or more IBM® WebSphere® MQ Telemetry channels.
UNIX and Linux® | Windows |
---|---|
- The default behavior is for RUNMQSC to return a summary of the connections to the channel. If CLIENTID is specified then RUNMQSC returns details of each client connected to the channel.
- Either CLIENTID, SUMMARY, or neither may be specified, but not both at the same time.
- The DISPLAY CHSTATUS command for IBM WebSphere MQ Telemetry has the potential to return a far larger number of responses than if the command was run for a IBM WebSphere MQ channel. For this reason, the IBM WebSphere MQ Telemetry server does not return more responses than fit on the reply-to queue. The number of responses is limited to the value of MAXDEPTH parameter of the SYSTEM.MQSC.REPLY.QUEUE queue. When RUNMQSC processes a IBM WebSphere MQ Telemetry command that is truncated by the IBM WebSphere MQ Telemetry server, the AMQ8492 message is displayed specifying how many responses are returned based on the size of MAXDEPTH.
Parameter descriptions for DISPLAY CHSTATUS
You must specify the name of the channel for which you want to display status information. This parameter can be a specific channel name or a generic channel name. By using a generic channel name, you can display either the status information for all channels, or status information for one or more channels that match the specified name.
- (generic-channel-name)
- The name of the channel definition for which status information is to be displayed. A trailing asterisk (*) matches all channel definitions with the specified stem followed by zero or more characters. An asterisk (*) on its own specifies all channel definitions. A value is required for all channel types.
- WHERE
- Specify a filter condition to display status information for those channels that satisfy the selection criterion of the filter condition.
- ALL
- Specify this
parameter to display all the status information for each relevant instance.
If this parameter is specified, any parameters that request specific status information which are also specified have no effect; all the information is displayed.
Summary attributes
When SUMMARY or TOTAL are added to the MQSC command DISPLAY CHSTATUS, the number of conversations is displayed as the CONVS attribute. The following attributes display a summary for either each channel when SUMMARY is specified, or for all the channels when TOTAL is specified.- ALL
- Specify this
parameter to display all the status information for each relevant instance. This attribute is the
default value if no attributes are requested.
This parameter is valid for MQTT channels.
If this parameter is specified, any specified parameters that are requesting specific status information have no effect; and all the information is displayed.
- CURCNV
- The number of current conversations.
Client details mode
- STATUS
- The status of the client.
- CONNAME
- The name of the remote connection (IP address)
- KAINT
- The client's keep alive interval.
- MCAUSER
- The user ID being used by the channel.
- MSGSNT
- Number of messages sent by the client since it connected last.
- MSGRCVD
- Number of messages received by the client since it connected last.
- INDOUBTIN
- Number of in doubt, inbound messages to the client.
- INDOUBTOUT
- Number of in doubt, outbound messages to the client.
- PENDING
- Number of outbound pending messages.
- LMSGDATE
- Date last message was received or sent.
- LMSGTIME
- Time last message was received or sent.
- CHLSDATE
- Date channel started.
- CHLSTIME
- Time channel was started.