WebSphere MQ-Specific Environment Variables

These environment variables relate to configuring the WebSphere MQ environment. For the most part, you do not need to specify these environment variables, unless you have installed WebSphere MQ in a non-default location, or you are instructed to do so by Micro Focus.

ES_MQ_1PC

Restriction: This environment variable applies to UNIX environments only.

Indicates whether the IBM WebSphere MQ switch module ESMQXA should operate in one-phase commit mode. Set this environment variable only when advised to do so by Micro Focus.

Syntax

Windows:
SET ES_MQ_1PC=value

UNIX:
ES_MQ_1PC=value
export ES_MQ_1PC

Values

Y|y|T - ESMQXA operates in one-phase commit mode.

Default

By default ESMQXA does not operate in one-phase commit mode.

ES_MQ_LIB

Restriction: This environment variable applies to UNIX environments only.

The full name including the path of the IBM WebSphere MQ client or server library. This should only be required if MQ was NOT installed in the default location.

Syntax

Windows:
SET ES_MQ_LIB= fully_qualified_library

UNIX:
ES_MQ_LIB= fully_qualified_library
export ES_MQ_LIB

Values

fully_qualified_library - A fully-qualified library name.

Default

By default ES will try to locate libraries in the default location for the platform.

Important: In AIX environments the library is an object inside a shared object. For example

ES_MQ_LIB="/usr/mqm/lib64/libmqmxa64.a(libmqm64.o)"

ES_MQ_LIB_T

Restriction: This environment variable applies to UNIX environments only.

The full name including the path of the IBM WebSphere MQ client or server library, for threaded environments. This should only be required if MQ was NOT installed in the default location.

Syntax

UNIX:
ES_MQ_LIB_T= fully_qualified_library
export ES_MQ_LIB_T

Windows:
SET ES_MQ_LIB_T= fully_qualified_library

Values

fully_qualified_library - A fully-qualified threaded library name.

Default

By default ES will try to locate threaded libraries in the default location for the platform.

ES_MQ_LIB_XA

Restriction: This environment variable applies to UNIX environments only.

The full name including the path of the IBM WebSphere MQ XA library. This should only be required if MQ was NOT installed in the default location.

Syntax

UNIX:
ES_MQ_LIB_XA= fully_qualified_library
export ES_MQ_LIB_XA

Windows:
SET ES_MQ_LIB_XA= fully_qualified_library

Values

fully_qualified_library - A fully-qualified library name.

Default

By default ES will try to locate libraries in the default location for the platform.

Important: In AIX environments the library is an object inside a shared object. For example

ES_MQ_LIB="/usr/mqm/lib64/libmqmxa64.a(libmqm64.o)"

ES_MQ_LIB_XA_T

Restriction: This environment variable applies to UNIX environments only.

The full name including the path of the IBM WebSphere MQ XA library, for threaded environments. This should only be required if MQ was NOT installed in the default location.

Syntax

UNIX:
ES_MQ_LIB_XA_T= fully_qualified_library
export ES_MQ_LIB_XA_T

Windows:
SET ES_MQ_LIB_XA_T= fully_qualified_library

Values

fully_qualified_library - A fully-qualified threaded library name.

Default

By default ES will try to locate threaded libraries in the default location for the platform.

ES_MQ_LISTENER (deprecated)

Defines one or more WebSphere MQ listeners.

Note: ES_MQ_LISTENER is deprecated, and provided for backward compatibility only. We recommend that you use MFDS configuration instead.

Syntax

UNIX:
ES_MQ_LISTENER={QueueManagerName,QueueName,ListenerName}
[,QueueManagerName,QueueName,ListenerName}...
export ES_MQ_LISTENER

Windows:
SET ES_MQ_LISTENER={QueueManagerName,QueueName,ListenerName}
[,QueueManagerName,QueueName,ListenerName}...

Values

QueueManagerName,QueueName,ListenerName - the characteristics of the listener being defined.

Default

By default, no WebSphere MQ listeners are defined.

ES_MQ_XA

The type of XA structure to use for the two-phase commit XA switch module.

Syntax

UNIX:
ES_MQ_XA=value
export ES_MQ_XA

Windows:
SET ES_MQ_XA=value

Values

D: use a dynamic XA structure
S: use a static XA structure

Default

By default, a dynamic XA structure is used.

MQSERVER

The name of a minimal channel.

Values

MQSERVER=ChannelName/TransportType/MachineName(Port)

where:

ChannelName specifies the name of a channel as defined on the server
TransportType specifies the communications protocol, which can be:
- TCP
- LU62
- NETBIOS
- SPX
MachineName(Port) specifies the name of the server machine and optional port number

Example:

MQSERVER=CHANNEL3/TCP/QServer(1414)

Important: If you have defined MQ as an XA resource, then the values used in this environment variable must also be contained in the XA open string. See XAR for WebSphere MQ for more information.

This environment variable is IBM-defined, and more information may be found in the relevant IBM publication.

TX_MQ_CONVERT

Sets the code set. Specify this variable to overwrite the MQ Q manager CCSID. The value is used in the MD-codedcharsetid parameter.

If the variable is not set, Enterprise Server uses the Q Manager CCSID.

If the variable is set, Enterprise Server uses it, and overwrites the Q manager CCSID.

TX_MQ_CONVERT=codeset

For example:

TX_MQ_CONVERT=037

To force the convert option for MQ even if the application does not set the option on the call, specify the code set followed by Force:

TX_MQ_CONVERT=codeset,Force

For example:

TX_MQ_CONVERT=037,Force