IBM MQSeries transport configuration

You can use the MQSeries (IBM WebSphere MQ) transport as a trading or an application transport.

IBM MQ support

Interchange is delivered with embedded IBM WebSphere MQ 8 client libraries.

When configured with SSL, Interchange supports only connections to WebSphere MQ server version 8.0.

If SSL is not used for the connection, Interchange works with both WebSphere MQ 7 and WebSphere MQ 8 servers.

For complete information on version compatibility and interoperability, refer to the IBM website:


To use this transport, on the MQSeries server side, the following elements must be properly configured:

  • Queue manager
  • Queues
  • Channel
  • Listener
  • Queue manager key database (for SSL connections)
  • Certificate (for SSL connections)
Note   To trade using MQ SSL, you must have a trusted SSL root certificate. Make sure your certificates are up to date and trusted.

Note on MQ Server client authentication configuration

Interchange supports MQSeries client authentication on the trading pickup side only. It does not support client authentication on the application side. When you set up the connection between an application pickup and an MQSeries Server, be sure to disable the option requiring client authentication on the IBM MQ Server side.

Exchange point configuration

Complete the following fields in the exchange wizard to configure this transport:

  • MQSeries connection type – Select an option:
    • Client connection – Select this option to use a channel connection, on the local machine or via the network, to connect to a queue manager.
    • Server binding – Select this option to use an API connection, via shared memory, to a local queue manager.
  • MQSeries server – Enter the fully qualified domain name or IP address of the MQSeries host.
  • Multi-instance queue manager – Select this option if you are using an MQSeries multi-instance queue manager. See WebSphere MQ multiple instances .
  • MQSeries standby server – Enter the MQSeries standby server address.
  • Port – Enter the port where the application listens for incoming documents. Default = 1414
  • Channel – Enter the name of the MQSeries communications channel configured on the MQSeries server.
  • Queue name – Enter the name of the MQSeries queue that receives incoming documents.
  • Queue manager – Enter the name of the MQSeries queue manager.
  • Convert data – Select this option if you want to convert the characters set of messages received from a queue to the set specified in the Characters set field. Clear the check box to turn off data conversion. This setting does not apply to messages outbound to a queue.
  • Characters set – Specify the character set used by the queue manager. This number should match the number used by the queue manager. Default = 819
  • This server requires a user name and password – If the MQSeries server requires a user name and password for connections, select this option, and then complete the fields:
    • User name – Enter the user name for connecting to the server
    • Password – Enter the password for connecting to the server
    • Confirm password - Confirm the password
  • Use SSL to connect to the IBM MQSeries server – Select this option if you want to use SSL on connections to this MQSeries server.
  • Note: For SSL you must add a trusted certificate for access to the IBM MQSeries server after completing the configuration of this delivery exchange.
  • When you select this option you must also complete the Select the SSL cipher suite field. From the drop down list, select the SSL cipher suite to use for the connection. The value must match the cipher suite that is configured for the channel on the MQSeries server. The following cipher suites are displayed, however not all of these suites are currently supported.
  • Interchange JSSE cipher suite Cipher specification (MQSeries name)

Click Next if you want to name the exchange. Otherwise, click Finish.

Related topics:

Related Links