Obtaining the MQ Service Provider

The MQ Service Provider is supported for use against IBM MQ for z/OS® Version 8.0 and later. There are two ways to obtain the MQ Service Provider for use with any supported version of IBM MQ.

1. Obtaining the MQ Service Provider from the Unix Systems Services Components feature of IBM MQ Version 9.0.1 (or later)
2. Obtaining the MQ Service Provider from Fix Central

Obtaining the MQ Service Provider from the Unix Systems Services Components feature of IBM MQ Version 9.0.1 (or later)

Install the feature following the instructions in the program directory. The MQ Service Provider will be located in the PATHPREFIX/zosconnect directory on your file system, where PATHPREFIX is the value chosen at installation time. By default, for IBM MQ Version 9.0.1, PATHPREFIX is /usr/lpp/mqm/V9R0M1.

Obtaining the MQ Service Provider from Fix Central

Go to Fix Central and locate the MQ Service Provider by searching for IBM-MQ-zOSConnect-ServiceProvider.

This should locate a tar file, for example, 9.0.1-IBM-MQ-zOSConnect-ServiceProvider.tar, which can be downloaded to your workstation.Attention: The same tar file is used with IBM MQ Version 8.0 as well. There is no separate tar file for IBM MQ Version 8.0.

Once downloaded, transfer the tar file into a directory PATHPREFIX on an appropriate z/OS LPAR. This directory should be somewhere that is accessible to z/OS Connect.

Extract the files by issuing the following command:

tar -oxvf 9.0.1-IBM-MQ-zOSConnect-ServiceProvider.tar

Change the permissions of the directory structure as appropriate for your enterprise.

Directory structure

Both ways of obtaining the MQ Service Provider create the same directory structure. The root directory of this structure is referred to as MQSP_ROOT throughout this documentation, where MQSP_ROOT is PATHPREFIX/zosconnect.

Underneath MQSP_ROOT are the following files and directories:

mqzosconnect.properties           Properties file that can be copied into z/OS Connect
v1.0/                                               Directory containing MQ Service Provider for z/OS Connect V1
        lib/
             com.ibm.mq.zosconnect_1.0.0.jar        Feature jar file for MQ Service Provider for z/OS Connect V1

             features/

                         zosConnectMQ-1.0.mf        Feature manifest for MQ Service Provider for z/OS Connect V1

v2.0/                                               Directory containing MQ Service Provider for z/OS Connect EE
        lib/
             com.ibm.mq.zosconnect_2.0.0.jar        Feature jar file for MQ Service Provider for z/OS Connect EE
 
             features/

                         zosConnectMQ-2.0.mf        Feature manifest for MQ Service Provider for z/OS Connect EE