Installing API exits on Linux™ for System z®

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 HCL DevOps Test Integrations and APIs (Test Integrations and APIs) to use for the SYSTEM.ADMIN.SVRCONN channel.

About this task

To install the API exits:

Procedure

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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").