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