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
- 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
SET ES_MQ_1PC=value
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
- 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
SET ES_MQ_LIB= 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_T
- 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
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
- 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
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
- 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
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
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
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:
- 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