IBM Support

Netcool/OMNIbus JDBC Gateway fails to start with java.lang.ClassNotFoundException: com.ibm.db2.jcc.DB2Driver

Troubleshooting


Problem

The JDBC Gateway (nco_g_jdbc) fails to start and the writer thread exits with a java.lang.ClassNotFoundException for the configured DB2 JDBC driver class.

Symptom

The following errors appear in the JDBC Gateway debug log:

2026-08-22T17:21:21: Debug: D-GJA-000-000: [ngjava]: G_JDBC: Thread-2: Property Gate.Jdbc.Driver: com.ibm.db2.jcc.DB2Driver
2026-08-22T17:21:21: Error: E-GJA-000-000: [ngjava]: G_JDBC: Thread-2: In logException
2026-08-22T17:21:21: Error: E-GJA-000-000: [ngjava]: G_JDBC: Thread-2: com.ibm.db2.jcc.DB2Driver
2026-08-22T17:21:21: Error: E-GJA-000-000: [ngjava]: G_JDBC: Thread-2: java.lang.ClassNotFoundException: com.ibm.db2.jcc.DB2Driver
2026-08-22T17:21:21: Error: E-GJA-000-000: [ngjava]: G_JDBC: Thread-2: java.lang.Class.forNameImpl(Native Method)
2026-08-22T17:21:21: Error: E-GJA-000-000: [ngjava]: G_JDBC: Thread-2: java.lang.Class.forName(Class.java:340)
2026-08-22T17:21:21: Error: E-GJA-000-000: [ngjava]: G_JDBC: Thread-2: com.ibm.tivoli.netcool.integrations.jdbc.GWJdbcConnection.(GWJdbcConnection.java:119)
2026-08-22T17:21:21: Error: E-GJA-000-000: [ngjava]: G_JDBC: Thread-2: com.ibm.tivoli.netcool.integrations.jdbc.GWJdbcWriter.writerThreadStart(GWJdbcWriter.java:189)
2026-08-22T17:21:21: Error: E-GJA-102-065: [ngjava]: G_JDBC: Java reader/writer start (writer) method failed to complete successfully. (-19:General failure)
2026-08-22T17:21:21: Error: E-GTK-102-061: [ngtk]: G_JDBC: Writer thread start handler function has failed to complete successfully. (-19:General failure)
2026-08-22T17:21:21: Error: E-ETC-004-008: THREAD MGR: thread G_JDBC Writer (0x7f3331b0ef50) EXIT: General failure
2026-08-22T17:21:21: Error: E-UNK-000-000: [ngtk]: Failed to determine ready status for all threads in thread group 'NGtk.User'. (-19:General failure)

The gateway enters the RUN state but the writer thread immediately exits, preventing any events from being written to the database.

Cause

The Gate.Jdbc.Driver property in the gateway properties file is set to com.ibm.db2.jcc.DB2Driver, but the JVM embedded in the JDBC gateway cannot locate the corresponding DB2 JDBC driver .jar file (db2jcc4.jar or db2jcc.jar) at runtime.

The gateway searches for JDBC driver classes in the $OMNIHOME/gates/java/ directory. If the required .jar file is absent, mis-named, or not readable in that directory, the JVM throws a java.lang.ClassNotFoundException and the writer thread terminates with a General failure (-19).

 

Resolving The Problem

Obtain the correct DB2 JDBC driver JAR from your DBA or from the IBM Db2 installation. The required file is typically one of:

db2jcc4.jar (preferred for Db2 10.1 and later)
db2jcc.jar (legacy Db2 versions)
db2jcc_license_cu.jar (licence file — also required in some environments)
Copy the JAR file(s) to the $OMNIHOME/gates/java/ directory on the JDBC gateway host:

cp /path/to/db2jcc4.jar $OMNIHOME/gates/java/
cp /path/to/db2jcc_license_cu.jar $OMNIHOME/gates/java/ # if required

Verify the driver class name in the gateway properties file matches the JAR you have deployed. For db2jcc4.jar, the correct class name is:

Gate.Jdbc.Driver: com.ibm.db2.jcc.DB2Driver

Verify file permissions — ensure the JAR file is readable by the OS user that runs the gateway process.

Restart the JDBC gateway and confirm the writer thread starts successfully. The following message indicates a successful start:

Information: I-GTK-102-062: Writer thread start handler function has completed successfully.

Document Location

Worldwide

[{"Type":"MASTER","Line of Business":{"code":"LOB77","label":"Automation Platform"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSSHTQ","label":"Tivoli Netcool\/OMNIbus"},"ARM Category":[{"code":"a8m500000008ZydAAE","label":"Gateways-\u003EHistorical Gateways-\u003EJDBC Gateway nco_g_jdbc"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.1.0;7.2.0;7.2.1;7.3.0;7.3.1;7.4.0;8.1.0"}]

Document Information

Modified date:
11 September 2026

UID

ibm17287255