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


Choosing message assembly components to include in a message map

You can add the message tree components, that is, the Properties tree, the headers, and the message body into a message map. You can also add the local environment tree into a message map, and the Environment tree.

About this task

In IBM® Integration Bus, the logical tree structure is the internal representation of a message. The logical tree structure is created by the parser when the message is received by an input node. It is also known as the Message tree and makes up part of the message assembly. The message assembly consists of four trees:
  • Message tree: This tree includes the Properties folder, the message body, and headers.
  • Environment tree
  • Local environment tree: This tree includes multiple destination folders, and a variables folder.
  • Exception list tree

When you create a message map, the Properties folder and the message body are automatically included in your Graphical Data Mapping editor.

Note: You can remove the properties folder and the message body in the message map if you only want to modify the local environment tree. This will accelerate your message transformation since the message properties and the message body will be copied over without the need to bring them into the transformation engine.

You cannot add the exception list tree to the message map. The exception list is included automatically, and the entire contents of the input exception list is retained in the output.

Procedure

Choose one or more message assembly components to include in a message map:

Results

The following table summarizes the message assembly tree folders that you can include into your message map:
Table 1. Message assembly trees that can be included in a message map
Message assembly trees Folders in a message assembly tree Can be configured in a message map as an input to the map and as an output to the map? Status in a message map
Message tree Properties folder Yes Required
Message tree Header folders Yes Optional
Message tree Message body Yes
Note: You must cast parts of the SOAP message body to be able to define transforms between its input and output elements.
Required
Local environment tree Variables folder Yes (You must cast a variable to define transforms between its input and output elements.) Optional
Local environment tree Destination folders Yes Optional
Environment tree   Yes Optional
Exception list tree   No  

What to do next

Identify the configuration of the different message assembly components. For more information, see Choosing a mapping action.


br30021_.htm | Last updated 2016-06-25 08:09:09