Troubleshoot Connection Errors
Note the following errors and troubleshooting actions when using the IBM MQ Series JMS Adapter.
Error | Error Occurrence Scenario | Verification Steps |
---|---|---|
|
When testing the IBM MQ Series JMS Adapter connection on the Connections page. | For the queue manager, where authentication is required and the username/password were not provided. |
|
When testing the IBM MQ Series JMS Adapter connection on the Connections page. | Verify that the connectivity agent is up and running. |
|
When testing the IBM MQ Series JMS Adapter connection on the Connections page. | Check the following:
|
|
When selecting Topic on the Basic Info page and clicking Next to go to the Configuration page in the Adapter Endpoint Configuration Wizard. | Verify that you ran the following commands as the authorized mqm user (to point to the location of the MQSC file):
For example:
|
|
When testing the IBM MQ Series JMS Adapter connection on the Connections page. | Verify that the MQ client JAR file com.ibm.mq.allclient.jar is present in AGENT_INSTALL_HOME/agenthome/thirdparty/lib . You can find this JAR file in the MQSeries_Install/java/lib folder.
|
|
When testing the IBM MQ Series JMS Adapter connection on the Connections page. | Verify that the jms.jar file is present in AGENT_INSTALL_HOME/agenthome/thirdparty/lib . You can find this JAR file in the MQSeries_Install/java/lib folder.
|
|
When selecting Topic or Queue on the Basic Info page and clicking Next to go to the Configuration page in the Adapter Endpoint Configuration Wizard. | Verify that the connectivity agent is up and running. |
|
When selecting Topic or Queue on the Basic Info page and clicking Next, the list of available topics or queues is blank on the Configuration page in the Adapter Endpoint Configuration Wizard. | Verify that the server connection channel is up or the queue manager is up. Verify also that the connectivity agent is up. |
|
When testing the IBM MQ Series JMS Adapter connection on the Connection page without authentication. | Verify that the message channel agent (MCA) property in the server connection channel for that queue manager has a valid value. See Prerequisites for Creating a Connection. |