IT22065: JSON4J.jar and MQLight specific code is being incorrectly shipped

APAR status

• Closed as program error.

Error description

• The com.ibm.mq.allclient.jar file shipped with MQ V9.0.0.2
  contains the following entry in its MANIFEST.MF file:
  
  Class-Path: jms.jar fscontext.jar providerutil.jar JSON4J.jar
  bcpkix-jdk15on-157.jar bcprov-jdk15on-157.jar
  
  This indicates that the JAR file JSON4J.jar is required by
  applications that use this JAR file. However, the JAR file is
  not shipped as part of the product. The JAR file is not
  required, and the entry in the MANIFEST.MF file is misleading.
  

Local fix

• The reference to the JSON4J.jar file on the class-path should
  not be an issue for the customer and their use of the
  com.ibm.mq.allclient.jar file for access to the MQ classes for
  JMS or MQ classes for Java APIs.
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  This issue affects the users of the following product releases:
  
  - IBM MQ v8
  - IBM MQ v9
  
  Who have MQ classes for Java and/or classes for JMS applications
  that use:
  
  -  The JAR file com.ibm.mq.allclient.jar.
  -  Or the self-extracting JAR file
  <V.R.M.F>-WS-MQ-Install-Java-All.jar file
  
  
  Platforms affected:
  MultiPlatform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  This APAR addresses 3 issues that were introduced as a result of
  the support for MQ Light:
  
  Issue 1:
  -----------
  With the release of MQ v8.0.0.1,  JSON4J.jar was incorrectly
  added as a dependency to the classpath in the manifest file of
  com.ibm.mq.allclient.jar.
  
  Issue 2:
  -----------
  With the release of MQ v8.0.0.1, JSON4J.jar was incorrectly
  packaged inside the Java-All.jar file.
  
  Issue 3:
  -----------
  The package com.ibm.msg.client.mqlight was being incorrectly
  packaged within com.ibm.mq.allclient.jar.
  

Problem conclusion

• The following changes have been made to resolve these issues:
  
  Issue 1:
  -----------
  The reference to JSON4J.jar have been removed from the classpath
  statement within the manifest file for the
  com.ibm.mq.allclient.jar JAR.
  
  Issue 2:
  -----------
  JSON4J.jar file has been removed from the
  <V.R.M.F>-WS-MQ-Install-Java-All.jar JAR file.  Applications
  that require the JSON4J library must obtain it from an
  alternative source after this APAR such as via the WebSphere
  Application Server runtime environment.
  
  Issue 3:
  -----------
  The package com.ibm.msg.client.mqlight is no longer included
  inside the com.ibm.mq.allclient.jar JAR file.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v8.0       8.0.0.9
  v9.0 LTS   9.0.0.3
  
  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 BASE MULTIP

• Fixed component ID

  5724H7251

Applicable component levels