The status of the remote queue manager is shown as QueueManager_Not_Available in Tivoli Enterprise Portal
Problem: The status of the remote queue manager is shown as QueueManager_Not_Available in Tivoli Enterprise Portal.
Solution: Do the following steps to fix this problem:
- Ensure that the remote queue manager and its command server are started and running properly.
- Ensure that the REMOTE monitoring option of the IBM MQ Monitoring Agent that is configured to monitor the remote queue manager is set to YES.
- Check the error logs of IBM MQ
Client that is installed on the agent host. On Linux® and
AIX® systems, these files are located in
/var/mqm/errors, and the name of the file is
AMQERR0n.LOG, where n is a number. On Windows® systems, the name of the files is
amqerr0n.log, where n is a number. They are located in
the errors subdirectory of the IBM MQ Client installation directory.
By default, the directory is C:\Program Files\IBM\IBM MQ\errors.
- If the following error message is shown in the error log:
AMQ9202 - Remote host xxx not available, retry later.Ensure that the listener of the remote queue manager is started and working properly. Ensure that the CONNAME attribute of the client channel definition uses the correct host name and port of the remote queue manager. Use IP address instead of host name if possible.
- If the following error message is shown in the error log:
AMQ9520: Channel not defined remotely.Ensure that the server connection channel with the same name as the client connection channel is defined correctly in the remote queue manager.
- If the following error message is shown in the error log:
AMQ9541: CCSID supplied for data conversion not supported.It indicates that the IBM MQ Client and the remote queue manager use different coded character set number and the conversion fails.
To correct this, you must create the MQCCSID environment variable on the IBM MQ Client host to override the existing configured CCSID that the host uses.
- If the IBM MQ Client
host is running on a Windows system, do the
following steps to create the MQCCSID environment variable:
- Click Start > Programs > IBM® Tivoli® Monitoring > Manage Tivoli Monitoring Services to open the Manage Tivoli Enterprise Monitoring Services window.
- Stop the IBM MQ Monitoring Agent that is configured to monitor the remote queue manager.
- Right-click the IBM MQ Monitoring Agent, and click Advanced > Edit Variables.
- Click Add in the window. The Add Environment Settings window is displayed.
- Enter MQCCSID in the Variable field and the CCSID value that the remote queue
manager uses in the Value field. You can use the following MQSC command to find out the
CCSID value that is used by the remote queue manager:
display qmgr ccsid - Click OK twice to close the two windows and save your changes.
- Start the IBM MQ Monitoring Agent.
- If the IBM MQ Client
host is running on AIX or Linux systems, define the MQCCSID environment variable in the
mq.ini file that is located in the
install_dir/config directory, where
install_dir is the directory where the agent is installed. Make sure that the
definition of MQCCSID is right below the definition of MQCHLTAB, for example:
MQCHLLIB=$CANDLEHOME$/$BINARCH$/$PRODUCTCODE$/bin MQCHLTAB=AMQCLCHL.TAB MQCCSID=CCSIDwhere:
CCSID is the CCSID that is used by the remote queue manager.
- If the IBM MQ Client
host is running on a Windows system, do the
following steps to create the MQCCSID environment variable:
- If the following error message is shown in the error log:
- Restart the IBM MQ Monitoring Agent that is configured to monitor the remote queue manager.