IBM Support

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

Subscribe to this APAR

By subscribing, you receive periodic emails alerting you to the status of the APAR, along with a link to the fix after it becomes available. You can track this item individually or track all items by product.

Notify me when this APAR changes.

Notify me when an APAR for this component changes.

 

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 number

    IT27711

  • Reported component name

    IBM MQ BASE MP

  • Reported component ID

    5724H7251

  • Reported release

    800

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2019-01-10

  • Closed date

    2020-03-06

  • Last modified date

    2020-03-06

  • 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

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSYHRD","label":"IBM MQ"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"8.0.0.0","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}}]

Document Information

Modified date:
06 March 2020