How to install the API exit on Linux for System z®.
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.1, 7.5, 8.0 and 9.0:
- intercept_linux_s390
- intercept_linux_s390_r
- intercept_linux_s390x
- intercept_linux_s390x_r
The distributed WebSphere MQ API
Exit .zip file that contains the sample scripts can
also be downloaded from Rational Test Control Panel itself.
For more 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 Linux for System z WebSphere MQ computer,
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, by
using the names for the Linux for System z exit files (see step
1). For instructions on creating the symbolic links, see Installing API exits on Linux (64-bit).
Note: The
instructions for Linux for System z are similar, except
that the names for the exits are different.
- Create the NameList com.greenhat.intercept.
This Namelist is required for the Rational
Integration Tester intercept exit.
Note: If you plan to use the sift-and-pass-through-capability,
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 version
7.1, 7.5, 8.0 and 9.0, the <exit_name> is intercept_linux_s390x
(without the "r").