WebSphere Message Broker, Version 8.0.0.7 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

See information about the latest product version

Mapping an input message to multiple output messages

You can create a map that takes a single input message and produces either multiple instances of an output message model, or one or more instances of different output message models. A typical use of this function is message splitting, in which an input batch message is divided into individual record messages.

The following structural mapping transforms can be wired to the head of the output message assembly:
  • If/Else
  • ForEach
  • Join

To produce multiple instances of a particular output message, the ForEach or Join transform is wired to the head of the output message assembly. When the map is run, a new message is propagated for each iteration of the ForEach or Join transform.

To produce one or more instances of different output messages, add the outputs and the relevant message model to define the body structure. Each message assembly output has its own properties, which you can use to enable the selection of the output message domain and folders and the local environment or transport headers.

When you create a map in the New Message Map wizard, you can select a single input and a single output. However, you can use the Add output button in the Graphical Data Mapping editor to add additional outputs. You can do this in main maps only, not in submaps. You can use the Add input button in the Graphical Data Mapping editor to add only one input.

To produce each different output message, the map must contain the If/Else or ForEach and Join transforms, with a condition wired to the separate message assembly outputs. When the map is run, a new message is propagated for each conditional transform that is resolved as True. You can use the ForEach and Join transforms in the nested If/Else transform to produce multiple message outputs.

Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2016Copyright IBM Corporation 1999, 2016.

        
        Last updated:
        
        Last updated: 2016-05-23 14:48:26


Task topicTask topic | Version 8.0.0.7 | br28710_