IBM Integration Bus, Version 9.0.0.8 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

See information about the latest product version

Setting the collection name

You can set a default name, or use a correlation string, for the name of your message collections, by using the Collection name property on the Collector node.

Before you start:

This task assumes that you have already created a message flow that contains a Collector node. For more information, see Creating a flow that uses message collections.

Each message collection that is produced by the Collector node has a name. The collection name is the value that is associated with the CollectionName attribute in the message collection tree structure. Each message collection has only one name.

You can either use Collection name to set a default name to be used for each message collection, or you can use the event handler properties to create a correlation string to use for the message collection name. You can use the correlation string to generate a unique name for the message collection, based on the content of the input messages. To use the correlation string for the collection name, you must enter the wildcard symbol *. If you leave Collection name blank, or if it is set to * and the value of the correlation string is empty, the CollectionName attribute of the message collection is set to an empty value.

Any * characters in the collection name are replaced with the correlation string. The correlation string for each message collection is also copied into the local environment message that is associated with the propagated message collection. The location of the correlation string in the local environment is Wildcard/WildcardMatch.

To configure the message collection name:

  1. Open the message flow that contains the Collector node.
  2. Right-click the Collector node and select Properties.
  3. Click the Basic tab.
  4. For the Collection name property, enter a name for the message collections that are generated by the Collector node. If you have set a value for Correlation path on your input terminals, you can use the * for the Collection name property to substitute the correlation string into the collection name value. Leave the collection name blank if you want to set your message collection name to an empty value.
Next: Setting the event coordination property.

ac37750_.htm | Last updated Friday, 21 July 2017