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
- Create a queue called ONE_WAY_QUEUE on the target z/OS queue manager, using either MQSC or the IBM MQ Explorer.
-
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:- Change the value of the queueManager attribute to the correct target queue manager name.
- 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.
-
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.