IBM MQ

You can configure IBM MQ as either a source or a target. The parameters are described in the following tables: 

For message headers, see IBM MQ Message Headers.

IBM MQ Source Parameters

The following tables describe the parameters for configuring IBM MQ as a source. The parameters differ depending on whether you choose to use a native connection or a JNDI lookup.

Native Connection

Field Description
Connection Name The name of the connection to IBM MQ, such as the hostname or IP address. For example, 123.123.123.123 (1414), where 123.123.123.123 is the host and 1414 is the port.
Username The username to authenticate with IBM MQ.
Password The password to authenticate with IBM MQ.
Queue Manager The name of the queue manager on IBM MQ. For example: QM1.
Channel The channel on IBM MQ. For example,DEV.APP.SVRCONN.
Additional Connection Properties

(Optional) The IBM MQ connection properties (refer to the IBM MQ documentation). Click Add Context if you need to specify additional context properties.

Destination Type Select TOPIC or QUEUE when the destination name is known, otherwise use UNKNOWN for a JNDI lookup.
Destination The binding identifier of the queue in IBM MQ. For example: my-ibmmq-target-queue_mqConnector_mq_sourceQ_10.
Durable Subscription Name

The name of the durable subscription multiple consumers can bind to. Durable subscriptions accumulate messages even when all consumers are offline, ensuring that no messages are lost.

This value is mandatory when the Destination Type is TOPIC. It is also required if the Destination Type is UNKNOWN and the destination resolves to a topic.

JNDI Lookup

Field Description
JNDI Context

(Optional) The IBM MQ connection properties (refer to the IBM MQ documentation). The required connection properties are as follows:

  • java.naming.factory.initial
  • java.naming.provider.url

(Optional) Click Add Context if you need to specify additional contexts.

Connection Factory Name The name of the JMS connection factory that defines the properties for the connection.
Username The username to authenticate with IBM MQ.
Password The password to authenticate with IBM MQ.
Destination Type Select TOPIC or QUEUE when the destination name is known, otherwise use UNKNOWN for a JNDI lookup.
Destination The binding identifier of the queue in IBM MQ. For example: my-ibmmq-target-queue_mqConnector_mq_sourceQ_10.
Durable Subscription Name

The name of the durable subscription multiple consumers can bind to. Durable subscriptions accumulate messages even when all consumers are offline, ensuring that no messages are lost.

This value is mandatory when the Destination Type is TOPIC. It is also required if the Destination Type is UNKNOWN and the destination resolves to a topic.

IBM MQ Target Parameters

The tables describe the parameters for configuring IBM MQ as a target. The parameters differ depending on whether you choose to use a native connection or a JNDI lookup.

Native Connection

Field Description
Connection Name The name of the connection to IBM MQ, such as the hostname or IP address. For example, 123.123.123.123 (1414), where 123.123.123.123 is the host and 1414 is the port.
Username The username to authenticate with IBM MQ.
Password The password to authenticate with IBM MQ.
Queue Manager The name of the queue manager on IBM MQ. For example: QM1.
Channel The channel on IBM MQ. For example,DEV.APP.SVRCONN.
Additional Connection Properties

(Optional) The IBM MQ connection properties (refer to the IBM MQ documentation). Click Add Context if you need to specify additional context properties.

Destination Type Select TOPIC or QUEUE when the destination name is known, otherwise use UNKNOWN for a JNDI lookup.
Destination The binding identifier of the queue in IBM MQ. For example: my-ibmmq-source-queue_mqConnector_mq_sourceQ_10.

JNDI Lookup

Field Description
JNDI Context

The IBM MQ connection properties (refer to the IBM MQ documentation). The required connection properties are as follows:

  • java.naming.factory.initial
  • java.naming.provider.url

(Optional) Click Add Context if you need to specify additional contexts.

Connection Factory Name The name of the JMS connection factory that defines the properties for the connection.
Username The username to authenticate with IBM MQ.
Password The password to authenticate with IBM MQ.
Destination Type Select TOPIC or QUEUE when the destination name is known, otherwise use UNKNOWN for a JNDI lookup.
Destination The binding identifier of the queue in IBM MQ. For example: my-ibmmq-source-queue_mqConnector_mq_sourceQ_10.