WebSphere Message Brokers
File: ar37630_
Writer: Cerys Giddings

Task topic

This build: July 31, 2007 21:36:46

Converting a message map to a submap

You can convert between a message map and a submap in order to change the usage of the map. You might convert a message map to a submap because you want to reuse the same mappings for multiple nodes. Use the following instructions to convert a message map to a submap for each message in the message map.

  1. From the Broker Application Development perspective right-click your message map and click Open.
  2. Right-click $source in the Source pane and select Add or Remove Headers and Folders. The Add or Remove Headers and Folders dialog opens.
  3. Select No folders (map body element only). Any previously selected headers or folders are cleared.
  4. Click OK to remove the headers and folders.
  5. Repeat steps 2 to 4 to select to map body element only from your target message under $target in the Target pane.
  6. Delete target map statements for existing mappings to properties, message headers or other folders such as LocalEnvironment. These mappings are flagged with warning messages after the headers are removed.
  7. Remove the reference to the new submap from any mapping nodes. If a reference to the submap exists in the Mapping Routine property of a mapping node an error message is displayed on the message flow.
  8. Save the submap, and check for any broken references as indicated by errors or warnings in the Problems view.
The submap is now ready to be used. See calling a submap for more information.

To convert a submap to a message map, click Add or Remove Headers and Folders for the source and target messages, and select to map Selected headers. You must ensure that no other maps call the changed map, check for errors in the Problems view to indicate this problem. See mapping headers and folders for more information about mapping headers, Properties and the LocalEnvironment.

Related concepts
Message Mapping editor
Related tasks
Editing a default-generated map manually
Creating and calling submaps and subroutines
Configuring message mappings
Related reference
Message mappings
Mapping node
DataDelete node
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2007Copyright IBM Corporation 1999, 2007. All Rights Reserved.
This build: July 31, 2007 21:36:46

ar37630_ This topic's URL is: