Loading

How to understand IBM WebSphere MQ errors

Fecha de publicación: Mar 2, 2024
Tarea

GOAL

This article describes how to understand IBM WebSphere MQ errors in logs files
Pasos
Mulesoft IBM Websphere MQ Connector enables an application to do messaging to an IBM MQ Broker using the IBM MQ JMS implementation. 

All IBM MQ interfaces return two values: a completion code (CC) and a reason code (RC), usually these values are included in the exception stack, WMQ Java implementation also return a JMSXXX message, for example:
...
at com.ibm.msg.client.commonservices.workqueue.SimpleWorkQueueItem.runItem(SimpleWorkQueueItem.java:99) 
at com.ibm.msg.client.commonservices.workqueue.WorkQueueItem.run(WorkQueueItem.java:343) 
at com.ibm.msg.client.commonservices.workqueue.WorkQueueManager.runWorkQueueItem(WorkQueueManager.java:312) 
at com.ibm.msg.client.commonservices.j2se.workqueue.WorkQueueManagerImplementation$ThreadPoolWorker.run(WorkQueueManagerImplementation.java:1227) 
Caused by: com.ibm.mq.MQException: JMSCMQ0001: IBM MQ call failed with compcode '2' ('MQCC_FAILED') reason '2009' ('MQRC_CONNECTION_BROKEN'). 
at com.ibm.msg.client.wmq.common.internal.Reason.createException(Reason.java:203) 
... 29 more 
Caused by: com.ibm.mq.jmqi.JmqiException: CC=2;RC=2009 
at com.ibm.mq.jmqi.remote.impl.RemoteSession.getConnection(RemoteSession.java:494) 
at com.ibm.mq.jmqi.remote.impl.RemoteSession.allocateTSH(RemoteSession.java:528) 
at com.ibm.mq.jmqi.remote.api.RemoteHconn.sendNotificationReconnectable(RemoteHconn.java:1503) 
...


JMSXXX message wrap these value (see Class MQException)

Completion Code (CC) allows to see if the call completed (successfully or partially) or not (failed):
   0 (MQCC_OK)              = Successful completion 
   1 (MQCC_WARNING)  = Warning (partial completion) 
   2 (MQCC_FAILED)       = Call failed 
      
Reason Code (RC) provides additional information about the error.

A successful call return CC=0 and RC=0, and any failing call return CC != 0 and RC = NNNN,  reason code (RC) is the most useful value to diagnostic the cause of the error, for example:
 
...
Root Exception stack trace:
com.ibm.mq.jmqi.JmqiException: CC=2;RC=2010
    at com.ibm.mq.jmqi.remote.api.RemoteFAP.jmqiPutMessageWithProps(RemoteFAP.java:7869)
    at com.ibm.mq.jmqi.remote.api.RemoteFAP.jmqiPut(RemoteFAP.java:7254)
    at com.ibm.mq.ese.jmqi.InterceptedJmqiImpl.jmqiPut(InterceptedJmqiImpl.java:496)
...


This call (PUT (jmqiPut)) fail with RC=2010 (MQRC_DATA_LENGTH_ERROR), the following page explains how to solve https://www.ibm.com/support/knowledgecenter/SSFKSJ_9.1.0/com.ibm.mq.tro.doc/q040710_.htm

 

References:

  • WMQ Connector (Mule 3.x)
  • WMQ Connector (Mule 4.x)
  • API completion and reason codes
  • Reason codes and exceptions
  • API reason codes
  • WMQ JMS Exception Messages
  • Class MQException


 
Número del artículo de conocimiento

001114465

 
Cargando
Salesforce Help | Article