Skip to content

Using WTX Map Node in WebSphere Message Broker

by on October 25, 2013

As a follow-up to our blog article (WebSphere Transformation Extender – Simple HIPAA 835X12 5010 to XML Mapping Example) on setting up a simple map in WebSphere Transformation Extender (WTX), we are now going to extend this to leverage WTX for Integration Servers to deploy a message flow to WebSphere Message Broker v8 (WMB).


  • Webshpre Message Broker v8
  • WebSphere Message Broker Toolkit v8.0.0.2
  • WebShere MQ Explorer v7
  • Rfhutil


Our scenario depends on the following MQ queues and WebSphere Transformation Extender Map node. Please create these queues In MQ explorer (or using runmqsc from command line) and follow the steps to create your WebSphere Message Broker flow using the WTX Map node.

  • TT.WTX.EXAMPLE.HIPAA8355010.IN – Input queue
  • TT.WTX.EXAMPLE.HIPAA8355010.XML.OUT– Output queue
  • TT_WTX_Example_HIPAA8355010_TO_XML_MAPPING – WTX Map node



Input Test Data: 835_5010a1_Test_File.txt


Steps of using WTX Map node within a message flow in WMB Toolkit (mapping HIPAA 835 TO XML)

1. Create a WebSphere Message Broker Project

Click File –> New –> Message Broker Project –> Type in (TT_WTX_EXAMPLE_HIPAA835X12_TO_XML_PROJECT)

2. Create a message flow

  • Right click your Message Broker Project –> New –> Message Flow –> Type in (TT_WTX_SAMPLE_HIPAA8355010_TO_XML_MSG_FLOW)


  • In the Message Flow editor, add and name the MQ nodes listed in the following image


a.      Create WTX Map node

  • Go to your Palette drawers and scroll down until you see WebSphere TX, then drag a WTX Map node from the palette onto the Message Flow Editor.
  • The node initially has no output terminals, and one failure terminal.


b.      Configure WTX Map node properties     

  • Navigate to the Properties view, shown in image above.
  • On the Basic tab of the WTX Map node, select the source map and browse to your executable map file that you have already created. (See WTX blog)


  • On the Input tab of the WTX Map node, select the map card that receives the input.


  • On the Output tab, click add then type in what is shown in the below image.
  • On the Outputs tab, configure properties to describe the format of the output message propagated by the output card:
    • Click Add to add a set of properties. A dialog box will appear.
    • Enter values for Card Number, Message Domain, Coded Char Set Id, Encoding, and then click OK. Message Domain must be one of the supported message domains.


c.      Connect the nodes together


d.      (Recommended) Perform a clean and rebuild of your projects



e.     Your flow is now ready to be deployed, and tested.

Following image is what you will suppose to get in “TT.WTX.EXAMPLE.HIPAA8355010.XML.OUT”

Note*: We used the Rfhutil testing tool in this example, but you could use any available testing tools.


We look forward to your feedback or comments on this posting.   You can also email us at or go to for more information. Thanks you,



From → Integration

Leave a Comment

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

%d bloggers like this: