To define the
WebSphere MQ XAR in
Enterprise Server, you use the MFDS browser interface, ensuring that the server is not started:
Click
Edit against the region you want to update.
This action takes you to the
General properties tab.
Click on the
XA Resources tab.
Click
Add to open the new definition page.
You can now add an XA resource including the following values:
In the
ID field, type the four-character identifier for this XA resource; for example,
XAMQ.
In the
Name field, type the name of this XA resource.
In the
Module field, type
esmqxa.dll (Windows) or
the full path to and filename of the
ESMQXA.so or
ESMQXA64.so file, located in the
$COBDIR/lib directory, which by default is
/opt/microfocus/EnterpriseDeveloper/lib (UNIX).
The name of the queue manager. This is a mandatory parameter.
TPM
The transaction manager being used. Must be set to
CICS.
AXLIB
The name of the library that contains the transaction manager's
ax_reg and
ax_unreg functions. Must be set to
casaxlib.
CHANNEL
Optional - the name of an MQI channel. If this parameter is supplied, the CONNAME parameter must also be supplied.
TRPTYPE
Optional - the communications protocol for the MQI channel. The following are valid values:
LU62
SNA LU 6.2
NETBIOS
NetBIOS
SPX
IPX/SPX
TCP
TCP/IP
The default is TCP.
CONNAME
Optional - the network address of the queue manager (connection name). The valid values of this parameter depend on the value of the TRPTYPE parameter.
If TRPTYPE is set to:
CONNAME must be:
LU62
A symbolic destination name, which identifies a CPI-C side information entry.
You cannot use the network qualified name of a partner LU or a partner LU alias.
NETBIOS
A NetBIOS name.
SPX
A 4-byte network address, a 6-byte node address, and an optional 2-byte socket number.
These values must be specified in hexadecimal notation. A period must separate the network and node addresses, and any socket number must be enclosed in parentheses. For example:
0a0b0c0d.804abcde23a1(5e86)
The default value is 5e86.
TCP
A host name or an IP address, optionally followed by a port number in parentheses. The default value is 1414.
If this parameter is supplied, the CHANNEL parameter must also be supplied.
Note: You need not specify the CHANNEL, TRPTYPE, and CONNAME parameters. Instead, you can specify these parameters via the
MQSERVER environment variable. See
WebSphere MQ-Specific Environment Variables for more information.
The
Close string field is not required.
You can type a note in the
Description field to aid identification of this XA switch module.
Check the
Enabled box to ensure that the XA switch module is available.
