IT27711: Trace enhancements for the IBM MQ classes for Java/JMS

APAR status

• Closed as program error.

Error description

• Several classes from the MQ classes for Java/JMS API are missing
  trace points for key methods.
  
  This makes diagnosis of problems from trace more challenging
  than it would otherwise need to be.
  

Local fix

Problem summary

• ****************************************************************
  USERS AFFECTED:
  This issue affects users of the IBM MQ Classes for Java/JMS, who
  have been asked by IBM Support to collect and submit trace for
  analysis.
  
  
  Platforms affected:
  MultiPlatform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  Trace points in the code output diagnostics when trace is
  enabled for the IBM MQ classes for Java/JMS.  For various
  reasons, several methods in the code base did not contain trace
  points, which resulted in no data being output into the trace
  logs when trace was enabled, and the class methods were
  utilised.
  
  This made analysis of trace logs take longer, and gave less
  insight into the operation of the IBM MQ classes for Java/JMS.
  

Problem conclusion

• Several trace points have been added to the following classes to
  assist with diagnostic collection and analysis:
  
    com.ibm.mq.jmqi.local.LocalMQ
    com.ibm.mq.jmqi.local.internal.adapters.Adapter
    com.ibm.mq.jmqi.local.internal.adapters.BatchAdapter
    com.ibm.mq.jmqi.local.internal.adapters.CICSAdapter
    com.ibm.mq.jmqi.local.internal.adapters.WASAdapter
    com.ibm.mq.jmqi.local.internal.adapters.WMBAdapter
    com.ibm.mq.jmqi.remote.api.RemoteFAP
    com.ibm.mq.jmqi.remote.impl.RemoteConnectionPool
    com.ibm.mq.jmqi.remote.impl.RemoteConnectionSpecification
    com.ibm.mq.jmqi.remote.rfp.RfpUID
    com.ibm.mq.exits.MQCD
    com.ibm.mq.jmqi.internal.JmqiDC
    com.ibm.mq.jms.MQConnectionFactory
    com.ibm.mq.jms.MQQueueConnectionFactory
    com.ibm.mq.jms.MQTopicConnectionFactory
    com.ibm.mq.jms.MQXAConnectionFactory
    com.ibm.mq.jms.MQXAQueueConnectionFactory
    com.ibm.mq.jms.MQXATopicConnectionFactory
    com.ibm.mq.MQManagedConnectionJ11
    com.ibm.mq.MQSESSION
    com.ibm.mq.XAtoJTA
    com.ibm.msg.client.jms.admin.JmsConnectionFactoryImpl
    com.ibm.msg.client.jms.admin.JmsXAConnectionFactoryImpl
  
  com.ibm.msg.client.wmq.compat.base.internal.MQConnectionSecurity
  Parameters
    com.ibm.msg.client.wmq.compat.jms.internal.MQConnection
    com.ibm.msg.client.wmq.compat.jms.internal.MQXAConnection
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v9.1 CD    TBC.
  v9.1 LTS   9.1.0.6
  
  The latest available maintenance can be obtained from
  'WebSphere MQ Recommended Fixes'
  http://www-1.ibm.com/support/docview.wss?rs=171&uid=swg27006037
  
  If the maintenance level is not yet available information on
  its planned availability can be found in 'WebSphere MQ
  Planned Maintenance Release Dates'
  http://www-1.ibm.com/support/docview.wss?rs=171&uid=swg27006309
  ---------------------------------------------------------------
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

• Fixed component name

  IBM MQ BASE MP

• Fixed component ID

  5724H7251

Applicable component levels