IV72963: WMQ: CLASS LOAD ERRORS WITH THE OSGI BUNDLE RESULT IN ERRORS SUCH AS MQRC_HEADER_ERROR 2142

APAR status

• Closed as program error.

Error description

• There is an error with the packaging of the OSGi bundle
  com.ibm.mq.osgi.java_7.1.x.x.jar in WebSphere MQ V7.1.0.
  
  The initial problem report was for a Java OSGi application
  running in a CICS region that was using the MQ API to put a
  message with message properties. The put resulted in
  MQRC_HEADER_ERROR reason 2142. If message properties were not
  used, it worked fine.
  
  The message properties work fine when put using a non-OSGi
  program. It works with the MQ V7.0.1 and V8.0.0 bundles.
  
  The problem that the load for class
  com.ibm.mq.headers.internal.MQMessageWrapper fails when MQ is
  trying to process the message properties set by the
  application. This is because the com.ibm.mq.pcf.jar hasn't been
  included on the Bundle-ClassPath.
  
  During testing of the problem, another issue was found by the
  change team. Using CICS 5.2 with the customer's testcase, the
  7.1 MQ bundles fail with
   java.lang.NoClassDefFoundError:
   org.xml.sax.SAXException.
  CICS 5.2 runs with a strict mode of dependency resolution, so
  we need to list all the system packages that we use in the
  Import-Package statement.
  
  The packaging problem is relevant to non-z/OS environments as
  well.
  
  WebSphere Application Server (WAS) does not use these OSGi
  bundles, so the problem is not relevant to that environment.
  
  Additional Symptom(s) Search Keyword(s):
  2195 0x00000893 MQRC_UNEXPECTED_ERROR
  2142 0x0000085e MQRC_HEADER_ERROR
  

Local fix

Problem summary

• ****************************************************************
  USERS AFFECTED:
  This issue affects users of the WebSphere MQ v7.1 and v7.5
  Classes for Java OSGi bundles handling messages which use
  message properties.
  
  
  Platforms affected:
  MultiPlatform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  An attempt by OSGi Classes for Java application to send a
  message with message properties set failed, returning a
  MQRC_HEADER_ERROR and a linked exception like:
  
  Caused by: java.lang.NoClassDefFoundError:
  javax/xml/parsers/ParserConfigurationException
  

Problem conclusion

• Messages with properties set can be handled without error.
  
  The 7.5 Classes for Java OSGI bundle will now import the
  packages:
  org.xml.sax,
  org.xml.sax.helpers,
  javax.xml.parsers
  
  in addition to those imported previously.
  The 7.1 Classes for Java OSGI bundle will now import the
  packages:
  javax.naming,
  javax.transaction.xa,
  javax.net.ssl,
  javax.security.cert,
  org.xml.sax,
  org.xml.sax.helpers,
  javax.xml.parsers
  
  in addition to those imported previously, and may now also
  optionally import these packages:
                      javax.crypto,
  javax.crypto.spec,
  javax.security.auth.x500,
  com.ibm.crypto.provider,
  com.ibm.misc,
  com.ibm.security.pkcs7,
  com.ibm.security.pkcs9,
  com.ibm.security.pkcsutil,
  com.ibm.security.util,
  com.ibm.security.x509
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v7.1       7.1.0.8
  v7.5       7.5.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

  WMQ AIX V7

• Fixed component ID

  5724H7221

Applicable component levels

• R710 PSY

     UP