Troubleshooting
Problem
When using any of the WebSphere® Transformation Extender (WTX) Java™ based adapters, you can better troubleshoot problems by turning on the Java Native Interface layer (JNI) trace.
Resolving The Problem
The JNI layer trace can be turned on in the configuration file found in the WTX installation directory. The configuration file name differs by version.
| Version | File Name |
| 8.1, 8.2, 8.3 | dtx.ini |
The configuration file contains a section named
[JNI Layer Trace].
[JNI Layer Trace]
;switch=off
;file=These instructions will assist you in changing the configuration file so that a trace file is created.
- Find the [JNI Layer Trace] section in the configuration file.
- Uncomment (delete the semicolon [ ; ] from the front of the line) the switch option.
- Change the switch option from "off" to "on".
- Uncomment the file option.
- Add a complete path and file name to the file option.
An example of the modified options is listed below.
[JNI Layer Trace]
switch=on
file=c:\temp\jnitrace.txtAfter completing these instructions, your configuration file is ready to create a JNI layer trace. Run the map or system that contains the map using a Java based adapter. The trace file will appear in the file you indicated.
Additional settings for JNI layer trace
There are three additional options that can be set to make the trace file display more, or verbose, information. These are set in the [JVM Options] section of the configuration file.
[JVM Options]
;option1=
;option2=
;...
The three options are for verbose class loading, verbose garbage collection, and verbose JNI. Each is described in the table below.
| Option | Description |
| -verbose:class | Specifies whether to use verbose debug output for class loading. |
| -verbose:gc | Specifies whether to use verbose debug output for garbage collection. |
| -verbose:jni | Specifies whether to use verbose debug output for native method invocation. |
These instructions will assist you in changing the configuration file so that a verbose JNI trace file is created.
- Find the [JVM Options] section in the configuration file.
- Uncomment (delete the semicolon [ ; ] from the front of the line) for option1.
- Add one of the options listed in the table above.
- Repeat steps 2 and 3 for each option you would like added. Add optionN=, where N is the next number and N <= 128.
An example of the modified options is listed below.
[JVM Options]
option1=-verbose:jni
option2=-verbose:gc
option3=-verbose:classNote: Tracing creates very large files and should only be used for debugging purposes. When not in use, each option can be turned off by commenting (adding a semi-colon to the front of) the line in the configuration file.
Related Information
[{"Product":{"code":"SSVSD8","label":"IBM Transformation Extender"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"Configuration","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"8.4.1;8.4;8.3;8.2","Edition":"International;US","Line of Business":{"code":"LOB59","label":"Sustainability Software"}},{"Product":{"code":"SSVSD8","label":"IBM Transformation Extender"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"Java Adapter","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"8.1;8.0.1;8.0","Edition":"International;US","Line of Business":{"code":"LOB59","label":"Sustainability Software"}},{"Product":{"code":"SSVSD8","label":"IBM Transformation Extender"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"JMS Adapter","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"8.1;8.0.1;8.0","Edition":"International;US","Line of Business":{"code":"LOB59","label":"Sustainability Software"}},{"Product":{"code":"SSVSD8","label":"IBM Transformation Extender"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"JNDI Adapter","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"8.1;8.0.1;8.0","Edition":"International;US","Line of Business":{"code":"LOB59","label":"Sustainability Software"}},{"Product":{"code":"SSVSD8","label":"IBM Transformation Extender"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"MIME Adapter","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"8.1;8.0.1;8.0","Edition":"International;US","Line of Business":{"code":"LOB59","label":"Sustainability Software"}},{"Product":{"code":"SSVSD8","label":"IBM Transformation Extender"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"SDK","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"8.1;8.0.1;8.0","Edition":"International;US","Line of Business":{"code":"LOB59","label":"Sustainability Software"}}]
Product Synonym
Ascential DataStage TX Mercator
Was this topic helpful?
Document Information
More support for:
IBM Transformation Extender
Software version:
8.4.1, 8.4, 8.3, 8.2
Operating system(s):
AIX, HP-UX, Linux, Solaris, Windows
Document number:
85281
Modified date:
16 June 2018
UID
swg21244512