Set up a simple one way MQ Service Provider service on z/OS Connect V1

Use the following steps, in order, to set up a simple one-way MQ Service Provider service.


Before you begin

Ensure that we have set up all the components correctly, as described in Enabling z/OSĀ® Connect and the MQ Service Provider and Checking that z/OS Connect is correctly set up


Procedure

  1. Create a queue called ONE_WAY_QUEUE on the target z/OS queue manager, using either MQSC or the IBM MQ Explorer.
  2. Define an IBM MQ messaging provider connection factory and a queue. You do this by adding the following to the bottom of server.xml, but inside the server element.
    ________________________________________
     <jmsConnectionFactory id="cf1" jndiName="jms/cf1" connectionManagerRef="ConMgr1">       
         <properties.wmqJms
            transportType="BINDINGS"
            queueManager="MQ21"/>
    </jmsConnectionFactory>
    
    <connectionManager id="ConMgr1" maxPoolSize="5"/>
    
    <jmsQueue id="q1" jndiName="jms/d1">
         <properties.wmqJms
           baseQueueName="ONE_WAY_QUEUE"/>
    </jmsQueue>
    ________________________________________
    
    Notes:
    1. Change the value of the queueManager attribute to the correct target queue manager name.
    2. A transportType of bindings is used. The means that a cross-memory connection is used to communicate with the queue manager. This is the only supported transportType when using the MQ Service Provider.
  3. Define a simple one-way MQ Service Provider service by adding the following to server.xml, but inside the server element.
    ________________________________________
    <zosConnectService id="zosconnMQ1"
                            invokeURI="/oneWay"
                            serviceName="oneWay"
                            serviceRef="oneWay" />
    
     <mqzOSConnectService id="oneWay"
                          connectionFactory="jms/cf1"
                          destination="jms/d1"/>
    ________________________________________
    
    The zosConnectService element defines a new service to z/OS Connect using the serviceName of oneWay. The:

    • invokeURI attribute makes it easier to invoke the service.
    • serviceRef attribute must match the ID attribute of a z/OS Connect service provider, which in this case is provided by the mqzOSConnectService element.

    The mqzOSConnectService element defines a single service instance provided by the MQ Service Provider.

    The connectionFactory and destination attributes tell the instance how to locate the IBM MQ messaging provider connection factory, and queue, respectively.

    See mqzOSConnectService element for details of the attributes in this structure.


Results

You have set up a simple one-way service.


What to do next

You need to test the service.