---
schema_version: "1"
id: 8fdb43d9b89ba58fbab965b383834d20756a1033ddfc4001d84e129c367ace6b
title: IBM MQ Tuning For Performance
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/ibm-mq-connector/1.7/ibm-mq-performance.md
canonical_url: https://docs.mulesoft.com/ibm-mq-connector/1.7/ibm-mq-performance
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 3eff35652600f58ca6fb3ccc83aad696af8d4b8f828bf41bb8cbb71d52245f3b
description: MuleSoft Documentation Site
release: "1.7"
latest: false
---
---
product: IBM MQ Connector
version: 1.7
keywords: jms, ibm mq, mq, performance, connector, consume, message, source, listener
---

# IBM MQ Tuning For Performance

> For the full documentation index, see: https://docs.mulesoft.com/llms.txt

Performance can be a significant factor when processing many messages, which means that you probably
want to check the following configurations to ensure you get the most out of the IBM MQ connector.

## Don’t Disable Connections Reuse

Connections are expensive to create, so it’s important to reuse them as much as possible.

**Notes:**

- By default, the IBM MQ connector uses an aggressive `caching-strategy` that reuses as many
  consumers and producers as possible. We recommend that you keep this configuration untouched since
  any modification can reduce the performance of your application.

- Disabling connections caching reduces the performance of your application.

## Increasing Concurrent Messages Processing

A good way to improve the performance of your application is to increase the number of concurrent
consumers that receive messages from the same destination. This can be done easily in the IBM MQ
connector by configuring the `numberOfConsumers` parameter.

Out of the box, the `listener` uses four consumers concurrently at the same destination, but you can
increase this number to a value that better fits your needs:

```xml
<ibm-mq:listener config-ref="config"
     destination="#[vars.destination]"
     numberOfConsumers="20"/>
```

> [!TIP] Increasing the `numberOfConsumers` is the easiest way to improve the throughput of your
> listeners.

## Optimize Your Configuration For Clusters

For applications running in clusters, keep in mind the concept of **primary node** and how the
connector behaves. When running in a cluster, the IBM MQ `listener` default behavior is to receive
messages only at the primary node, no matter what kind of destination you are consuming from.

In case of consuming messages from a queue, change this configuration to receive messages in all the
nodes of the cluster, not just the primary.

This can be done with the `primaryNodeOnly` parameter:

```xml
<ibm-mq:listener config-ref="config"
     destination="${inputQueue}"
     primaryNodeOnly="false"/>
```

Consuming messages from a topic is a bit different, since the default behavior of receiving messages
only in the primary node is the most common use case, given that it avoids processing the same
message multiple times across the cluster.

If you are using the JMS 2.0 shared subscriptions mechanism, then you want to change the cluster
configuration to consume from all the nodes, again setting `primaryNodeOnly` to `false`:

```xml
<ibm-mq:listener config-ref="JMS_20_config"
      destination="${inputTopic}"
      primaryNodeOnly="false">
     <ibm-mq:consumer-type>
         <ibm-mq:topic-consumer
         shared="true"
         subscriptionName="clusteredEventListener"/>
     </ibm-mq:consumer-type>
 </ibm-mq:listener>
```

> [!TIP] When listening from a queue in a cluster, change the `primaryNodeOnly` configuration to
> `false`.

> [!WARNING] When listening from a topic in a cluster, not using the `primaryNodeOnly` configuration
> causes the cluster to process the same message more than once unless shared-subscriptions is used.

## See Also

- [To Consume Messages](https://docs.mulesoft.com/ibm-mq-connector/1.7/ibm-mq-consume)

- [Using Topic Subscriptions](https://docs.mulesoft.com/ibm-mq-connector/1.7/ibm-mq-topic-subscription)