Creating a WebSphere® MQ protocol configuration

When you want to send requests to a service that uses WebSphere MQ transport protocol, you can create a protocol configuration to describe the transport settings for a service request.

Before you begin

If you are using SOAP security, ensure that you have configured the environment with the correct libraries and configuration files.

About this task

By default, messages are sent in bytes. Starting from V10.1.0, you can select message type as Text Message. After you create the protocol configuration, you can change the message format by selecting the Text Message check box in the Message Structure.

Transport and security settings can be associated with any service request. You can edit the existing configuration or duplicate the default configuration. You must have configured the environment with the correct libraries and configuration files when you use SOAP security.

Procedure

  1. Click the Generic service client Open the generic service client toolbar button, and then click the Transport tab.
  2. From the Protocol list, right-click MQ, and then click New MQ protocol configuration.
  3. Enter a name for the new transport configuration in the Name field.
  4. Enter a name for the queue manager that receives the call in the Queue Manager Name field.
  5. Enter a name for the queue managed by the queue manager in the Send Queue Name field.
  6. Select the Authentication check box and specify the user name and password to authenticate with the MQ server.
    Alternatively, add or update the login credentials in the Protocol Configuration tab of a service test.
  7. Select the Use Local Queue Manager check box when the WebSphere MQ server is running on the local computer.
  8. Perform the following steps if the MQ server is installed on a remote computer:
    1. Clear the Use Local Queue Manager check box.
    2. Enter the remote WebSphere MQ server details in the following fields:
      • The IP address or host name in the Address field.
      • Listener port number in the Port field.
      • Server connection mode channel name in the Client Channel field.
  9. Select the Use Temporary Queue for Response check box if you want the server to create a temporary queue for receiving messages.
  10. Perform the following steps to specify the queue that receives the response messages from the queue manager:
    1. Clear the Use Temporary Queue for Response check box.
    2. Enter a name for a queue in the Receive Queue Name field.
  11. Optional: Specify the name of the target service in the Target service field when you are using the Microsoft .NET framework with SOAP over MQ.
  12. Optional: Select Use RFH2 header when you are using SOAP over MQ. Otherwise, specify the Message Descriptor and Encoding options for the message header.
  13. Optional: Click Configure SSL to select an existing SSL configuration or to create a new one when the service requires SSL authentication.
  14. Click OK to create the protocol configuration.

Results

You have created a configuration for the WebSphere MQ transport protocol.

What to do next

  • You can use the protocol configuration for the WebSphere MQ with any service request.
  • You can change the message format by selecting the Text Message check box in the Message Structure.