WebSphere MQ Environment Variables

Attention: 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 OpenText Support for Micro Focus Products.
Parent topic: Environment Variables by Groups

ES_MQ_1PC

Indicates whether the IBM WebSphere MQ switch module ESMQXA operate in one-phase commit mode.
CAUTION:
Set this environment variable only when advised to do so by OpenText Support for Micro Focus Products.
Syntax 
ES_MQ_1PC={[Y|y|Yes|T|True]|[N|n|No|F|False}
Parameters
Y|y|Yes|T|True
The ESMQXA switch module operates in one-phase commit mode.
N|n|No|F|False
The ESMQXA switch module operates in two-phase commit mode.
Default 
ES_MQ_1PC=F

ES_MQ_LIB

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.
Restriction: This environment variable applies to UNIX environments only.
Syntax 
ES_MQ_LIB=path-name/library-name
Parameters
path-name
The full path to the library location.
library-name
The name of the library file.
Default
Not set. Enterprise Server looks for library files in the default location for your platform.
Comments
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

For threaded environments, the full path to and file name of the IBM WebSphere MQ client or server library. Required only when WebSphere MQ was not installed in the default location.
Restriction: This environment variable applies to UNIX environments only.
Syntax 
ES_MQ_LIB_T=path-name/library-name
Parameters
path-name
The full path to the threaded library location.
library-name
The name of the threaded library file.
Default
Not set. Enterprise Server looks for threaded library files in the default location for your platform.

ES_MQ_LIB_XA

The full path to and file name of the IBM WebSphere MQ XA library. Required only when WebSphere MQ was not installed in the default location
Restriction: This environment variable applies to UNIX environments only.
Syntax 
ES_MQ_LIB_XA=path-name/library-name
Parameters
path-name
The full path to the library location.
library-name
The name of the library file.
Default
Not set. Enterprise Server looks for library files in the default location for your platform.
Comments
In AIX environments, the library is an object inside a shared object. For example: 
ES_MQ_LIB_XA="/usr/mqm/lib64/libmqmxa64.a(libmqm64.o)"

ES_MQ_LIB_XA_T

The full path to and file name of the IBM WebSphere MQ XA library for threaded environments. Required only when WebSphere MQ was not installed in the default location
Restriction: This environment variable applies to UNIX environments only.
Syntax 
ES_MQ_LIB_XA_T=path-name/library-name
Parameters
path-name
The full path to the threaded library location.
library-name
The name of the threaded library file.
Default
Not set. Enterprise Server looks for threaded library files in the default location for your 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 configure MQ listeners in ESCWA. See MQ Listeners for details.
Syntax 
ES_MQ_LISTENER={queue-manager-name,queue-name,listener-name}
[[,queue-manager-name,queue-name,listener-name][...]]
Parameters
queue-manager-name,queue-name,listener-name
Characteristics of the listener being defined.
Default
Not set. Uses MQ listeners as defined in ESCWA, or, if not defined in ESCWA, 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 
ES_MQ_XA={D|S}
Parameters
D
Use a dynamic XA structure
S
Use a static XA structure.
Default 
ES_MQ_XA=D

MQSERVER

The names of one or more minimal channels.
Syntax 
MQSERVER=channel-name/transport-type/{machine-name|ip-address(port-number)}
   [,{machine-name|ip-address}(port-number)][...]]
Parameters
channel-name
The name of a channel as defined on the server.
transport-type
The communications protocol, which can be any of the following:
  • TCP
  • LU62
  • NETBIOS
  • SPX
machine-name
The name of the server machine.
ip-address
The machine IP address.
port-number
The number of the port used.
Comments
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.

Examples 
MQSERVER=CHANNEL3/TCP/QServer(1414)
MQSERVER=CHANNEL1/TCP/10.120.99.999(1414),10.120.98.888(1414)

TX_MQ_CONVERT

Sets the code set to overwrite the MQ Q manager CCSID. The value is used in the MD-codedcharsetid parameter.
Syntax 
TX_MQ_CONVERT=codeset[,Force]
Parameters
codeset
The code that corresponds to that you want to use to overwrite MQ Q manager CCSID. See Installing CCSID translation tables for further details.
Force
Force the convert option for MQ even if the application does not set the option on the call.
Default
Not set. Enterprise Server uses the Q Manager CCSID.
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=037,Force

TX_MQTRACE

Enables tracing in dfh0mqis for WebSphere MQ calls.