PH27482: LIBERTY 20.0.0.3 IS NOT ABLE TO CONNECT TO DB2 CLASSNOTFOUNDEXCEPTION WRITTEN INTO MESSAG 20/12/03 PTF PECHANGE

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 in CICS TS 5.4 when using the
  cicsts:jdbc-1.0 feature.
  
  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
  
  This problem can be circumvented by any of the following:
   - setting -Dcom.ibm.cics.jvmserver.wlp.args=--clean in the JVM
     profile.
   - setting -Dcom.ibm.cics.jvmserver.wlp.jdbc.driver.location=
     /the/jdbc/location in the JVM profile.
   - deleting Liberty's workarea directory whilst the JVM server
     is disabled.
  

Local fix

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

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users with UI67364, UI67366,        *
  *                 UI67368, UI69611, UI69615, UI69616, UI69693, *
  *                 UI70223, UI70655, UI70658 or UI70661         *
  *                 applied.                                     *
  ****************************************************************
  * 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

• UI67364 UI67366 UI67368 UI69611 UI69615 UI69616 UI69693 UI70223
  UI70655 UI70658 UI70661
  
  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:

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

  PH31839 UI72981 UI72983 UI72984

Modules/Macros

• DFHAPJVM DFHAPLJP DFHAXIS2 DFHCAL64 DFHCDJNI DFHCDK64 DFHKETIX
  DFHSJBD  DFHSJDM  DFHSJDS  DFHSJDUF DFHSJIN  DFHSJIS  DFHSJIX
  DFHSJJS  DFHSJL   DFHSJLOG DFHSJNA  DFHSJNDI DFHSJNR  DFHSJNT
  DFHSJPP  DFHSJPTI DFHSJRE  DFHSJRL  DFHSJRM  DFHSJRT  DFHSJSA
  DFHSJSC  DFHSJSM  DFHSJSR  DFHSJST  DFHSJTE  DFHSJTH  DFHSJTRI
  DFHSJWL  DFHSJXM  DFJ@H317 DFJ@H350 DFJ@H351 DFJ@H352 DFJ@H356
  DFJ@H360 DFJ@H387 DFJ@H390 DFJ@H427 DFJ@H448 DFJ@H467 DFJ@H468
  DFJ@H561 DFJ@H563 DFJDTCOE DFJOUTRE DFJWLPBP DFJWLPPL
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R00D PSY UI72984

     UP20/12/10 P F012 ­

• R10D PSY UI72983

     UP20/12/09 P F012 ­

• R200 PSY UI72981

     UP20/12/09 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.