Creating Filters for Use with IBM webMethods Broker

If IBM webMethods messaging trigger subscribes to publishable document types associated with IBM webMethods Broker connection alias, you can specify a single filter that can be used by IBM webMethods Broker and/or Integration Server. Use the Filter column in the Condition detail table to specify the filter.

Create the filter using the syntax defined in IBM webMethods Service Development Help.

The filter can be saved with the subscription on IBM webMethods Broker and with the IBM webMethods messaging trigger on the Integration Server. This is because some filter syntax that is valid on Integration Server is not valid on IBM webMethods Broker. For example, IBM webMethods Broker prohibits the use of certain words or characters in field names, such as Java keywords, @, *, and names containing white spaces. The location of the filter and whether IBM webMethods Broker and/or Integration Server applies the filter, depends on the filter syntax, which is evaluated at design time.

When you save IBM webMethods messaging trigger, Integration Server and IBM webMethods Broker evaluate the filter in the Filter column.

Integration Server evaluates the filter to make sure it uses the proper syntax. If the syntax is correct, Integration Server saves the IBM webMethods messaging trigger in an enabled state. If the syntax is incorrect, Integration Server saves the IBM webMethods messaging trigger in a disabled state.

IBM webMethods Broker evaluates the filter syntax to determine if the filter syntax is valid on the IBM webMethods Broker. If IBM webMethods Broker determines that the syntax is valid for the IBM webMethods Broker, it saves the filter with the document type subscription. If the IBM webMethods Broker determines that the filter syntax is not valid on the IBM webMethods Broker or if attempting to save the filter on the IBM webMethods Broker would cause an error, IBM webMethods Broker saves the subscription without the filter.

IBM webMethods Broker saves as much of a filter as possible with the subscription. For example, suppose that a filter consists of more than one expression, and only one of the expressions contains the syntax that the IBM webMethods Broker considers invalid. IBM webMethods Broker saves the expressions it considers valid with the subscription on the IBM webMethods Broker. (Integration Server saves all the expressions.)

When a filter is saved only on Integration Server and not on IBM webMethods Broker, the performance of Integration Server can be affected. When the IBM webMethods Broker applies the filter to incoming documents, it discards documents that do not meet filter criteria. Integration Server only receives documents that meet the filter criteria. If the subscription filter resides only on Integration Server, IBM webMethods Broker automatically places the document in the subscriber’s queue. IBM webMethods Broker routes all the documents to the subscriber, creating greater network traffic between the IBM webMethods Broker and the Integration Server and requiring more processing by the Integration Server.