XAR for WebSphere MQ

You can now add an XA resource including the following values:

1. In the ID field, type the four-character identifier for this XA resource; for example, XAMQ.
2. In the Name field, type the name of this XA resource.
3. In the Module field, type 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.
4. In the Open string field, type the following:

   TPM=CICS,AXLIB=casaxlib,QMNAME=queue_manager_name,
      [CHANNEL=channel_name,TRPTYPE=trp_type,CONNAME=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:

   channel=MARS.SVR,trptype=tcp,conname=MARS(1415),qmname=MARS,tpm=cics

   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.
5. The Close string field is not required.
6. You can type a note in the Description field to aid identification of this XA switch module.
7. Check the Enabled box to ensure that the XA switch module is available.
8. Click Add to create the resource.