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

Replacing a WebSphere Message Broker Version 7 Mapping node

A WebSphere® Message Broker Version 7 Mapping node cannot reference a graphical data map (.map file). If you want to reference a graphical data map, you must replace the WebSphere Message Broker Version 7 Mapping node.

Before you replace a Mapping node, you must complete the following task:
You might also need to complete the following task:

If you import your integration solutions from WebSphere Message Broker Version 7, you can still compile and deploy message flows that use WebSphere Message Broker Version 7 Mapping nodes. However, in WebSphere Message Broker Version 8 and later, Mapping nodes that were created in WebSphere Message Broker Version 7 are accessible in read-only mode and cannot be modified.

If you want to reference a graphical data map (.map file) in a Mapping node, you must use the Mapping node from WebSphere Message Broker Version 8 or later.

To replace a WebSphere Message Broker Version 7 Mapping node by using the IBM Integration Toolkit, complete the following steps:

  1. In the Application Development view, double-click a message flow that contains one or more WebSphere Message Broker Version 7 Mapping nodes.

    The message flow opens in the Message Flow editor.

  2. In the Message Flow editor, identify a WebSphere Message Broker Version 7 Mapping node that you want to replace.
  3. In the Palette, expand the Transformation section, and then drag a new Mapping node from the Palette to the canvas of the Message Flow Editor.

    A new Mapping node is added to your message flow, and is assigned a default name.

    If you rename the node, the name that you choose must be unique in the message flow.

    If you do not change the default name at this time, you can change it later. For more information, see Renaming a message flow node.

  4. Select your new Mapping node.

    The node properties are displayed in the Properties view.

  5. In the Properties view, a default value is entered in the Mapping routine property, and must be replaced by choosing one of the following actions:
    • To reference an existing graphical data map, click Browse... to locate it, or specify your .map file in the format {BrokerSchemaName}:MapName. {default} indicates that no Broker schema is used by the graphical data map. For more information, see Referencing an existing message map from a Mapping node.
    • To create a new graphical data map, double-click the Mapping node, or right-click the Mapping node and click Open Map. For more information, see Creating a message map from a Mapping node.
  6. Move the existing connections from your WebSphere Message Broker Version 7 Mapping node to your new Mapping node. For more information, see Connecting message flow nodes.
  7. Select your WebSphere Message Broker Version 7 Mapping node, and press the delete key (del) to remove it from your message flow. For more information, see Removing a message flow node.
  8. Repeat steps 3 through 7 for each WebSphere Message Broker Version 7 Mapping node that you want to replace in your message flow.
You have removed your WebSphere Message Broker Version 7 Mapping nodes and replaced them with new Mapping nodes.

Deploy and test your message flow. For more information, see Deploying resources.

Related information:
Mapping node
br40805_.htm | Last updated Friday, 21 July 2017