Installing API exits on zLinux

For the current version of IBM® Rational® Integration Tester, the IBM WebSphere® MQ API exit is only supported for MQ versions 7.0 and 7.1.

Before you begin

Ensure that the following prerequisites are met before you install the API exits:

Obtain the WebSphere MQ product code for Linux on System z® 64-bit.
As a minimum, install MQSeriesServer and MQSeriesRuntime on the WebSphere MQ server. You can also install MQSeriesSDK and MQSeriesMan. Installing these items provides you with valuable information and resources that can help streamline setting up the exit.
At least one queue manager must be defined for the WebSphere MQ server.
Ensure that a listener is working for Rational Integration Tester to use for the SYSTEM.ADMIN.SVRCONN channel.

About this task

To install the API exits:

Procedure

Install the files for your version of WebSphere MQ, found in IBMWebSphereMQdist.zip package:
- For WebSphere MQ version 7.0:
  - intercept_linux_s390_7.0
  - intercept_linux_s390_7.0_r
  - intercept_linux_s390x_7.0
  - intercept_linux_s390x_7.0_r
- For WebSphere MQ version 7.1 and later:
  - intercept_linux_s390
  - intercept_linux_s390_r
  - intercept_linux_s390x
  - intercept_linux_s390x_r
Rational Integration Tester API Exits are provided with Rational Test Control Panel. For information, see Rational Integration Tester tool packages

Note: The s390 exits are 32-bit, and the s390x exits are 64-bit.
Copy the 32-bit exits into the /var/mqm/exits directory on the zLinux WebSphere MQ machine, and the 64-bit exits into the /var/mqm/exits64 directory. Ensure that the file permissions match the parent directory permissions.
Create symbolic links for all four of the exit files, using the names for the zLinux exit files (see step 1). For instructions on creating the symbolic links, see Installing API exits on Linux (64-bit).
Note: The instructions for zLinux are similar, except that the names for the exits are different.
Create the NameList com.greenhat.intercept. This is required for the Rational Integration Tester intercept exit.
Note: If you plan to use Sift and Passthrough, also create a rit.divert.rules NameList.
Locate the qm.ini file, which is located in the /var/mqm/qmgrs/<queue mgr name> directory, and add the following lines to the end of this file:
```
ApiExitLocal:
   Data=com.greenhat.intercept
   Sequence=200
   Name=Intercept
   Function=EntryPoint
   Module=intercept
```
Note: For WebSphere MQ 7.0, the <exit_name> is intercept_linux_s390x_7.0 (without the "r"). For WebSphere MQ version 7.1 and later, the <exit_name> is intercept_linux_s390x (without the "r").

Feedback