Configure an IBM MQ connection

You can configure an IBM MQ connection in the API Connection Manager.

This allows you to connect to an IBM MQ queue or topic and to push and pull messages. For detailed information on IBM MQ, see the IBM MQ documentation.

Prerequisites

To use an IBM MQ connection, you have to install IBM MQ Client Library 9.1.0.4 or later.

If you use an earlier version, you can create a redirect as described in the Tricentis Knowledge Base.

Configure your connection

To configure an IBM MQ connection in the API Connection Manager, follow the steps below:

  1. Open the API Connection Manager.

  2. Add a new connection.

  3. Go to the Edit section.

  4. Specify a Name for your connection.

  1. From the Type drop-down menu, select IBM MQ.

  2. Enter the Queue/Topic Name. This is the name of the queue or topic you want to connect to.

  3. Specify the Host. This is the name or IP address of the IBM MQ server host.

  4. Enter the Port to listen to.

  5. Specify the Channel that you want to use to transfer messages.

  6. Enter the Manager that manages the messages in the queue.

  7. Select a Type from the drop-down menu:

    • Use Queue for a one-to-one messaging pattern.

    • Use Topic for one-to-many messaging.

  8. Select a Message Type from the drop-down menu:

    • Use JmsTextMessage for messages with a single text string.

    • Use JmsBytesMessage for messages that contain multiple types.

  9. Select a Jms Support type from the drop-down menu:

    • Use WmqWithJMS if the client type is JMS.

    • Use WmqNative for native IBM MQ.

  10. Optionally, select Peeking to retrieve messages from topics or queues without consuming them.

  11. Optionally, specify the following details to enable encrypted communication (SSL/TLS):

    • Cipher Spec: a combination of encryption algorithm and message authentication code algorithm such as ECDHE_ECDSA_AES_128_CBC_SHA256.

    • Cipher Suite: a suite of cryptographic algorithms such as SSL_RSA_WITH_RC4_128_MD5.

    • Peer Name: a string that contains the peer name.

    • Key Repository: the file path to the key repository without file extension.

    • Certificate Stores: a comma-separated list that contains one or more URLs of the certificate store servers.

  12. If your connection requires authentication, enter your Username and Password.

  13. Optionally, configure XML and web service security.

Configure an IBM MQ connection

You can now use your IBM MQ connection for testing. For information on how to push and pull messages in API Scan, see chapter "Run JMS messages".