To define the
WebSphere MQ XAR in
Enterprise Server, you use the MFDS browser interface, ensuring that the server is not started:
enterprise server instance
- 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.
- In the
Open string field, type the following:
TPM=CICS,AXLIB=casaxlib,QMNAME=queue_manager_name,CHANNEL,TRPTYPE,CONNAME
where the parameters are:
- 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.
- QMNAME
- The name of the queue manager. This is a mandatory parameter.
- 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 default is TCP. The following are valid values:
- LU62
- SNA LU 6.2
- NETBIOS
- NetBIOS
- SPX
- IPX/SPX
- TCP
- TCP/IP
- CONNAME
- The network address of the queue manager (connection name). The valid values of this parameter depend on the value of the
TRPTYPE parameter. CONNAME is mandatory when multiple MQ listeners are defined to make an MQ connection from the
Micro Focus Directory Server, and optional when connecting using a single MQ listener.
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.
Example Open String
TPM=CICS,AXLIB=casaxlib,QMNAME=TESTQ,CHANNEL_TESTQ,TCP,123.10.20.135(1414)
Note: If you specify the CHANNEL, TRPTYPE, and CONNAME parameters, you must also set the
MQSERVER environment variable, providing the same parameter values. 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.
- Click
Add to create the resource.