DISPLAY CHSTATUS (AMQP)
Use the MQSC command DISPLAY CHSTATUS (AMQP) to display the status of one or more AMQP channels.
Using MQSC commands
For information on how you use MQSC commands, see Performing local administration tasks using MQSC commands.
IBM® i | UNIX and Linux® | Windows | z/OS® |
---|---|---|---|
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.
Summary attributes
When no CLIENTID parameter is added to the MQSC command DISPLAY CHSTATUS (AMQP), a summary of AMQP channel information is displayed. The number of connections is displayed as the CONNECTIONS attribute. The following attributes display a summary for each channel.- 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.
- CONNECTIONS
-
The number of current connections to this channel.
- STATUS
-
The status of this channel.
Client details mode
- CLIENTID
-
The identifier of the client.
- STATUS
-
The status of the client.
- CONNAME
-
The name of the remote connection (IP address)
- AMQPKA
-
The client's keep alive interval.
- MCAUSER
-
The user ID that the client is using to access IBM MQ resources.
- CLNTUSER
-
The user ID that the client provided when it connected.
- MSGSNT
-
Number of messages sent by the client since it connected last.
- MSGRCVD
-
Number of messages received by the client since it connected last.
- LSTMSGDA
-
Date last message was received or sent.
- LSTMSGTI
-
Time last message was received or sent.
- CHSTADA
-
Date channel started.
- CHSTATI
-
Time channel was started.
- PROTOCOL
-
The communication protocol used by the client. The value is AMQP.
Examples
dis chstatus(MYAMQP) chltype(AMQP) all
The command outputs the following
status:
AMQ8417: Display Channel Status details.
CHANNEL(MYAMQP) CHLTYPE(AMQP)
CONNECTIONS(1) STATUS(RUNNING)
dis chstatus(*) chltype(AMQP) clientid(*) all
The command outputs the
following status:
AMQ8417: Display Channel Status details.
CHANNEL(MYAMQP) CHLTYPE(AMQP)
CLIENTID(recv_cc2022b) STATUS(RUNNING)
CONNAME(192.168.60.1) AMQPKA(0)
MCAUSER(matt) CLNTUSER( )
MSGSNT(0) MSGRCVD(0)
LSTMSGDA( ) LSTMSGTI( )
CHSTADA(2015-09-18) CHSTATI(06.23.30)
PROTOCOL(AMQP)