Message filters

You can filter the way messages are received in two different ways: Java Message Service (JMS) filters and Rational Integration Tester filters.

Important: When you use filtering, the system under test must be correctly configured. Messages that are filtered out are silently discarded. Rational® Integration Tester does not produce any warnings or errors.

Java™ Message Service (JMS) filters

The Message Selector field under Subscriber Configuration (see Subscriber options) accepts standard JMS filtering expressions (message selectors). When used, Rational® Integration Tester receives only messages that match the specified selector.

For example, if MyId='585858' is entered, only messages with the header field "MyId" having a value of 585858 is received. To send matching messages in an Rational® Integration Tester publisher, you would configure a message property as shown.

Note: Filtering is performed on message header properties, and matching messages are passed to Rational® Integration Tester (In other words, the JMS server filters the messages, not Rational® Integration Tester). This setup is useful in environments that share a single JMS queue or topic. By getting the applications to set header properties, you can separate messages logically. Rational® Integration Tester can interact with the messages from Application A without affecting the messages of Application B.

Rational® Integration Tester filters

After messages are passed to Rational® Integration Tester, they can be further filtered, using header and body fields, with the configuration in the Filter tab.

In this case, JMSDestination must equal "business.inventory global" and JMSCorrelationID must equal "32458". Otherwise, Rational® Integration Tester discards the message.