Debugging and tracing

As with a UDR written in C, a UDR written in Java™ code might generate the SQL messages for UDR and DataBlade® API errors when it executes. UDRs written in Java code adopt the HCL OneDB™ JDBC Driver error-reporting mechanism as well.

The UDR throws an SQLException in case of an execution error such as a failed OneDB JDBC Driver call. The routine manager detects such exceptions and translates it into a normal UDR error message.

In addition, the UDR can generate Java trace outputs and stack dumps at run time. These additional Java messages are written to the JVP log file. The JVP log file is separate from the main database server log file, online.log. No JVP-specific messages appear in the database log. The JVP log file is intended to be the main destination for logging and tracing messages that are specific to the JVP and the UDR. This log is essential for HCL support to perform debugging efforts. You should preserve it when possible.