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:

  1. Ensure that the remote queue manager and its command server are started and running properly.
  2. 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.
  3. 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:
        1. Click Start > Programs > IBM® Tivoli® Monitoring > Manage Tivoli Monitoring Services to open the Manage Tivoli Enterprise Monitoring Services window.
        2. Stop the IBM MQ Monitoring Agent that is configured to monitor the remote queue manager.
        3. Right-click the IBM MQ Monitoring Agent, and click Advanced > Edit Variables.
        4. Click Add in the window. The Add Environment Settings window is displayed.
        5. 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 
        6. Click OK twice to close the two windows and save your changes.
        7. 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=CCSID

        where:

        CCSID is the CCSID that is used by the remote queue manager.

  4. Restart the IBM MQ Monitoring Agent that is configured to monitor the remote queue manager.