Install the IBM MQ resource adapter

The IBM MQ messaging provider feature in WLP makes use of a component of IBM MQ called the IBM MQ resource adapter. For compatibility reasons, users of z/OS® Connect V1 must use the IBM WebSphere MQ Version 7.5 resource adapter, regardless of the version of the queue manager that it connects to.

Before you begin

Go to Obtaining the IBM MQ Resource Adapter for WLP, which describes how to link to Fix Central, and download the latest resource adapter.

The resource adapter will be in the form: 7.5.0.Fix_level-WS-MQ-Java-InstallRA.jar. Note, it is this jar file that the procedure refers to.

This procedure installs the IBM MQ resource adapter in WLP.

Procedure

Extract the contents of the jar file, go to the wmq directory, and FTP the wmq.jmsra.rar file in binary into an appropriate directory on the target file system. This directory is referred to as MQRA_ROOT for the remainder of these instructions.
Locate the Unix System Services Components directory of the target queue manager. For example, this directory might be called /mqm/V9R0M1/. The directory should contain a java/lib subdirectory, which contains a number of native libraries (.so files).
Edit the server.xml file of the server. Add the following lines:
1. ```
<variable name="wmqJmsClient.rar.location"  
          value="MQRA_ROOT/wmq.jmsra.rar"/>
<wmqJmsClient nativeLibraryPath="MQJAVA_LIB_DIR"/>
```
  where MQJAVA_LIB_DIR is the directory located in step 2, for example /usr/lpp/mqm/V9R0M1/java/lib.
2. Save the changes.
The first line tells WLP where to locate the IBM MQ resource adapter.

The second line tells the IBM MQ resource adapter where to locate the native libraries that are used for bindings connections to IBM MQ.

See wmqJmsClient, and Deploying JMS applications to Liberty to use the IBM MQ messaging provider for more information.
Set up the STEPLIB. You must do this so that the native libraries located in step 2 can connect to the queue manager.Run the following command in the shell used to start the WLP server:
```
export STEPLIB=HLQ.SCSQAUTH:HLQ.SCSQANLE
```
where HLQ is the high level qualifier of the data sets containing the IBM MQ installation.

Results

You have partially installed the IBM MQ resource adapter. Note that the IBM MQ resource adapter will not be fully installed until its parent feature (wmqJmsClient-1.1) is enabled.

What to do next

Install the MQ Service Provider into WLP.