Describes the provided WebSphere MQ switch module.
The ESMQXA module is provided as part of
Enterprise Developer and does not need to be built. The filename for the built module is
esmqxa.dll (Windows) or
ESMQXA.so or
ESMQXA64.so, located in the
$COBDIR/lib directory, which by default is
/opt/microfocus/EnterpriseDeveloper/lib (UNIX).
By default, the ESMQXA module operates in two-phase commit mode. You can set the environment variable ES_MQ_1PC to Yes or True in order for the module to operate in one-phase commit mode, but you should only do this if advised to by Micro Focus.
In UNIX environments, to use the
WebSphere MQ switch, you must have IBM
WebSphere MQ Server or IBM
WebSphere MQ Client installed. If they are not installed at the default location, you must use the ES_MQ_LIB_XA environment variable (or the ES_MQ_LIB_T environment variable for threaded environments) to identify the full name including the path of the IBM MQ XA library appropriate to your platform.
Important: In AIX environments the library is an object inside a shared object. For example:
ES_MQ_LIB_XA="/usr/mqm/lib64/libmqmxa64.a(libmqmxa64.o)"
Note: Depending on how you configure
Enterprise Server, you might not need an XA switch for
WebSphere MQ. See
Configuring Enterprise Server for IBM
WebSphere MQ for more information.