PH31839: LIBERTY 20.0.0.3 IS NOT ABLE TO CONNECT TO DB2 CLASSNOTFOUNDEXCEPTION WRITTEN INTO MESSAGE.LOG

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Liberty can't connect to DB2 after migrating Liberty 18.0.0.4
  to Liberty 20.0.0.3
  
  Following ClassNotFoundException is written to messages.log:
  
  LogService-221-com.ibm.cics.wlp.jdbc
   CWWKE0701E: bundle com.ibm.cics.wlp.jdbc:1.1.0
               (221)[com.ibm.cics.wlp.jdbc.CICSJdbcDriver(478)]
               The activate method has thrown an exception
               java.lang.RuntimeException:
               org.osgi.framework.BundleException:
    Exception in
     com.ibm.cics.wlp.jdbc.driver.wrapper.internal.Activaror.start
     internal of bundle com.ibm.cics.wlp.jdbc.driver.wrapper.
   ...
    Caused by: java.lang.ClassNotFoundException:
     com.ibm.db2.jcc.DB2Driver
     at java.lang.Class.forNameImpl(Native Method)
     at java.lang.Class.forName(Class.java:333)
     at
     com.ibm.cics.wlp.jdbc.driver.wrapper.internal.Activator.start
     (Activator.java:90)
   ... 88 more
  

Local fix

• specify property com.ibm.cics.jvmserver.wlp.jdbc.driver.location
  in the JVM profile
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: java.lang.ClassNotFoundException:       *
  *                      com.ibm.db2.jcc.DB2Driver when tasks in *
  *                      a Liberty JVM server attempt to use     *
  *                      JDBC.                                   *
  ****************************************************************
  A Liberty JVM server is started with server.xml manually
  configured for use of the cicsts:jdbc-1.0.  server.xml contains
  a cicsts_jdbcDriver element and optionally a cicsts_dataSource
  element.  The Db2 JDBC driver (JCC) is used successfully.
  
  The Liberty JVM server is recycled.  As a result of PH17642 CICS
  no longer starts Liberty with the --clean option.  This causes
  Liberty to automatically reinstall the OSGi bundles present when
  the server was stopped.
  
  An attempt is made to install the CICS JDBC wrapper bundle.
  This fails because the OSGi manifest uses the
  com.ibm.cics.jvmserver.wlp.jdbc.driver.location property which
  would be set by CICS using the information in server.xml,
  however this logic has yet to execute.
  
  As a result the Db2 JDBC driver cannot be used by any tasks.
  
  The JVM server's stderr file and messages.log will show:
  
  java.lang.ClassNotFoundException: com.ibm.db2.jcc.DB2Driver
  
  If SJ=1-4 tracing is enabled the JVM trace file will show that
  the CICS JDBC wrapper bundle is RESOLVED (rather than ACTIVE).
  

Problem conclusion

• The way in which the CICS Liberty feature cicsts:jdbc-1.0 is
  installed has been updated.  CICS will now install the
  com.ibm.db2.jcc JAR as an OSGi bundle directly.  The wrapper
  bundle com.ibm.cics.wlp.jdbc.driver.wrapper is no longer used.
  

Temporary fix

Comments

APAR Information

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

  PH27482

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

  UI73025

Modules/Macros

• DFJ@H390
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R300 PSY UI73025

     UP20/12/11 P F012 ¢

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.