FreeKB - IBM MQ display chstatus command
IBM MQ - display chstatus command

If you are not sure what a channel is, check out our Getting Started tutorial. These examples are based on Linux.

Start the MQSC utility for the queue manager that you want to display the channel status. In this example, MANAGER01 is the name of the queue manager. If you are not sure the name of the queue manager, use the dspmq command to display the queue managers. This assumes that the "mqm" users .bash_profile has been updated to have PATH=$PATH:<root installation directory>/bin.

Display the status of every channel in the queue manager.

echo "display chstatus(*)" | runmqsc MANAGER01

 

Following is an example of what will be displayed. In this example, channel01 is running and channel02 is inactive. A channel will have a status or running when there is an active connection in the channel.

AMQ8417: Display Channel Status details.
  CHANNEL(MANAGER01.CHANNEL01.SVR)    CHLTYPE(SVRCONN)
  CONNAME(10.1.2.3)                   CURRENT
  STATUS(RUNNING)                     SUBSTATE(RECEIVE)

 

The status will be inactive when there are no active connections in the channel.

AMQ8417: Display Channel Status details.
  CHANNEL(MANAGER01.CHANNEL02.SVR)    CHLTYPE(SVRCONN)
  CONNAME(10.1.2.3)                   CURRENT
  STATUS(INACTIVE)                    SUBSTATE(RECEIVE)

 

The status will be stopped if the stop channel command was used.

AMQ8417: Display Channel Status details.
  CHANNEL(MANAGER01.CHANNEL01.SVR)    CHLTYPE(SVRCONN)
  CONNAME(10.1.2.3)                   CURRENT
  STATUS(STOPPED)                     SUBSTATE( )

 

Status retrying might suggest some issue making a connection. In this scenario, check the error logs.

AMQ8417: Display Channel Status details.
  CHANNEL(MANAGER01.CHANNEL01.SVR)    CHLTYPE(SVRCONN)
  CONNAME(10.1.2.3)                   CURRENT
  STATUS(RETRYING)                    SUBSTATE( )

 

Here is one possible example of what you might find in the error log.

AMQ9999E: Channel 'MANAGER01.CHANNEL01.SVR' to host 'mq.example.com' ended abnormally.

 

To display the status of a single channel.

echo "display channel (MANAGER01.CHANNEL01.SVR)" | runmqsc MANAGER01

 

Following is an example of what will be displayed.

AMQ8417: Display Channel Status details.
  CHANNEL(MANAGER01.CHANNEL01.SVR)    CHLTYPE(SVRCONN)
  CONNAME(10.1.2.3)                   CURRENT
  STATUS(RUNNING)                     SUBSTATE(RECEIVE)

 



Add a Comment




We will never share your name or email with anyone. Enter your email if you would like to be notified when we respond to your comment.




Please enter 5d864 in the box below so that we can be sure you are a human.




Comments

Web design by yours truely - me, myself, and I   |   jeremy.canfield@freekb.net   |