IBM Support

Finding the number of running channels

Technote (FAQ)


How do I determine the number of channels that are running for my queue manager?


You want to monitor your queue manager and try to avoid the following message, which indicates that the maximum number of channels has been reached.

AMQ9513: Maximum number of channels reached.



In UNIX systems, you can enter the following compound command. Ensure to replace CHLNAME and QMGR with the proper values for your system:

echo "DISPLAY CHSTATUS(CHLNAME)" | runmqsc QMGR | grep 'AMQ8417' | wc -l

If you want to query for all channels, then use * for CHLNAME:

echo "DISPLAY CHSTATUS(*)" | runmqsc QMGR | grep 'AMQ8417' | wc -l


For Windows, there is no "grep" but "find" can be used instead:

echo DISPLAY CHSTATUS(CHLNAME) | runmqsc QMGR | find /c "AMQ8417"

Notes about the Windows "find" command:
- The command requires the string to be searched to be specified between double quotes, otherwise you will get an error: FIND: Parameter format not correct
- The flag /c counts the number of lines in which the string appears. Similar to the UNIX command: wc -l


From command line, type:
1. QSH (to access the shell environment)
2. echo "DISPLAY CHSTATUS(*)" | /qsys.lib/qmqm.lib/runmqsc.pgm QMGR | grep 'AMQ8417' | wc -l

NOTE: This returns the value of the number of active channel connections


How to identify MQ client connections and stop them

Cross reference information
Segment Product Component Platform Version Edition
Business Integration IBM MQ

Product Alias/Synonym

WebSphere MQ WMQ

Document information

More support for: WebSphere MQ
Channels LU62 / TCP

Software version: 6.0, 7.0, 7.1, 7.5, 8.0, 9.0

Operating system(s): AIX, HP-UX, IBM i, Linux, Solaris, Windows

Reference #: 1449463

Modified date: 13 February 2013