How to install the API exit on Linux™ for System
z®.
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 IBM® DevOps Test Integrations and APIs (Test Integrations and APIs) to use for the
SYSTEM.ADMIN.SVRCONN channel.
To install the API
exits:
-
Install the files for your version of
WebSphere MQ, found in
IBMWebSphereMQdist.zip
package:
- For WebSphere MQ 8.0 and 9.0:
- intercept_linux_s390
- intercept_linux_s390_r
- intercept_linux_s390x
- intercept_linux_s390x_r
The sample scripts containing the distributed WebSphere MQ API agent .zip
file, can be downloaded from Test Virtualization Control Panel.
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 Test Integrations and APIs 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 8.0 and 9.0, the <exit_name>
is intercept_linux_s390x (without the "r").