Consider the following rules and guidelines for the IBM MQ objects in mappings and mapping tasks:
•When you import queues in the IBM MQ mapping, the import operation might fail with a connection error.
For more information about the connection error and steps to avoid this error, see IBM MQ reason code 2059 in the IBM MQ documentation.
•When you import an IBM message queue, ensure that the queue name does not contain a forward slash or percentage character.
•A mapping that reads from two queues with identical names but different special characters in the same position fails.
For example, if one queue name contains an underscore character while the other queue name contains a dot character in the same position.
For instance, if one queue name is "INFA_1" and the other queue name is "INFA.1", the mapping fails.
•A mapping might fail intermittently when you read or write messages to IBM MQ and the connection count for the server-connection channel in the Queue Manager component exceeds the maximum limit.
For more information about this error and the maximum limit of the connection count, see Server-connection channel limits in the IBM MQ documentation.
•When you run a mapping to read messages in real time, consider the following rules and guidelines:
- A mapping configured with the Aggregator or Joiner transformation fails.
- A mapping fails when you set the Recovery Strategy session property to Resume from last checkpoint in the mapping task.