Troubleshooting
Problem
The IBM WebSphere® MQ adapter will not run if the operating system's library search path is not set up properly, particularly for a 64-bit installation of WebSphere Transformation Extender version 8.2 or later.
Symptom
The map audit log reports the problem in a similar manner to the following example log:
<TargetReport card="1" adapter="IBM WebSphereMQ (server)"
bytes="0" adapterreturn="-99999">
<Message>Adapter not found</Message>
<Settings>-QMN QMGRNAME -QN QUEUENAME</Settings>
</TargetReport>
Cause
The operating system's library search path is not set up properly.
Resolving The Problem
To successfully run the WebSphere MQ adapter, the WebSphere MQ client drivers must be present in the library search path.
The environment variable that defines the library search path is dependent
on the operating system you are using. The following table lists the
environment variable used for the given operating system.
| Operating System | Environment Variable |
| Solaris® and Linux® | LD_LIBRARY_PATH |
| HP-UX® | SHLIB_PATH |
| IBM® AIX® | LIBPATH |
For a 64-bit installation of WebSphere Transformation Extender, as is available for version 8.2 releases and later, you must supply the correct 64-bit library search path.
For instance, an AIX-based 64-bit installation might require you to set the library search path environment variable in the following way before you
run the map:
export LIBPATH=/usr/mqm/lib64:$LIBPATH
For a 32-bit installation, it might require you to set the library search path environment variable in the following way:
export LIBPATH=/usr/mqm/lib:$LIBPATH
Even though the actual path name might vary, you must specify the proper
32 or 64 bit client driver location on the library search path. For WebSphere Transformation Extender versions earlier than 8.2, you must always choose
the 32-bit driver path.
This same search path requirement also applies to other WebSphere Transformation Extender adapters that interface with database and messaging products.
Product Synonym
WebSphere Transformation Extender WTX Ascential DataStage TX Mercator
Was this topic helpful?
Document Information
Modified date:
16 June 2018
UID
swg21394857