TX Map node overview

The TX Map node is a component of the IBM® Transformation Extender for IBM Integration Bus.

Within a IBM Integration Bus message flow, a series of steps is used to process a message. A message flow node performs each step. The TX Map node is a message flow node that you use in message flows. It runs a IBM Transformation Extender map within a message flow. The TX Map node uses one or more broker message trees as its input, runs a IBM Transformation Extender map that you specify, and creates one or more broker message trees as its output.

The map that the TX Map node runs can either be a compiled map that is predeployed to the broker, or a source map that is compiled when the message flow is added to a broker archive (bar) file and deployed as part of broker archive deployment. The map can have multiple input cards, but the TX Map node only has a single input terminal.

If the message tree that arrives at the input terminal consists of a single message, select which input card receives the message. If the message tree that arrives at the input terminal is a message collection, containing multiple messages, each message in the collection is delivered to the appropriate input card. Then the TX Map node runs the map.

Any cards that did not receive a message obtains data from the adapter that is specified on them. The map can have multiple output cards. Select which output cards to connect to other nodes in the message flow. If the output terminal for an output card is connected, a message tree is built, and propagated down the message flow. If the output terminal for an output card is not connected, the data is sent to the adapter that is specified on the card.

IBM Integration Bus processes many different classes of message, such as fixed-length binary, delimited text, and XML. Each class is known as a message domain. The TX Map node can handle input and output messages belonging to several different message domains. See Supported message domains.

The TX Map node is contained in the IBM Transformation Extender for IBM Integration Bus drawer of the IBM Integration Toolkit message flow node palette. Use the message flow node palette to add TX Map nodes in the message flows you are creating in the Message Flow editor. Drag node objects from the palette onto the IBM Integration Toolkit canvas, and create connections, also called wires, between two nodes.

The TX Map node is not an input node, and can not be used to trigger the execution of the message flow.