JNI layer trace
The Java Native Interface (JNI) layer trace provides trace and debugging information about how IBM Sterling Transformation Extender interacts with the Java Virtual Machine (JVM). Use the JNI layer trace to collect details about a Java adapter problem that are not recorded in the Java-based adapter trace file. For example, if an exception is not recorded by a IBM Sterling Transformation Extender Java-based adapter or command (such as JMS, Java Class, SOAP, JExit), the JNI trace file records the error. If the Java adapter does not load at all, the JNI layer trace file records details about the failure.
When IBM Sterling Transformation Extender creates the
JVM with the -verbose option (specified in the [JVM
Options] section of the dtx.ini file), the JNI layer
trace file includes the details about the JVM garbage collection, class loading, and JNI
invocation calls.
The JNI layer trace can produce a large amount of information and impact performance. Avoid using the JNI layer trace in a production system, unless you enable it for a limited time and then disable it.
You can define the following options:
- Option
- Description
- Switch
- Master switch. Valid values are on and off. If off, the rest of the options are ignored.
- File
- Specifies the full path of the file that receives the tracing information. IBM Sterling Transformation Extender automatically appends the process ID (PID) of the Launcher system or IBM Sterling Transformation ExtenderIBM Integration Bus execution group to the end of the file name. This behavior is the default.
- pid
- Turns off the functionality that automatically appends the
process ID (PID) to the end of
the file name. Add the following
entry:
pid=off. See the description for the File option. - Level
- Controls the amount of information recorded by the JNI trace. A
higher trace level includes the trace information of all the numerically lower
levels. For example, trace level 100 includes the information of all trace levels lower than
100.
Level Description 10 Critical information that tracks execution details of the IBM Sterling Transformation Extender JNI layer 20 Errors that surface from the JNI layer as a result of IBM Sterling Transformation Extender JNI calls 30 Warning information about the timing and sequence of IBM Sterling Transformation Extender JNI calls. This trace level is the default. 40 General information about the execution of a IBM Sterling Transformation Extender Java adapter 50 Verbose details regarding the execution of a IBM Sterling Transformation Extender Java adapter 100 "Startup" details before attaching to a JVM thread