Dynamically overriding a map with a compiled map

An upstream node in a message flow can dynamically override a map that is configured in the properties of a TX Map node. The upstream node can populate the IBM® Integration Bus local environment tree with the binary data of a compiled map. The map bytes in the local environment tree override the map that is configured on the TX Map node. Ensure that the map in the local environment tree is compiled for the appropriate operating system platform.

LocalEnvironment subtree

LocalEnvironment.WTX.DynamicMap
Contains the binary data of a compiled map. The map bytes dynamically override the map that is configured on a downstream TX Map node.
LocalEnvironment.WTX.DynamicMapName
Assigns a name to the binary data of the compiled map in the local environment tree. This name identifies the binary map for purposes such as map caching.
LocalEnvironment.WTX.MapServerLocation
Specifies the path to a map on the file system. This map runs instead of the map that is configured in the TX Map node.

Order of precedence

The order of precedence for map overrides is:
  1. A dynamic binary map in the local environment tree (LocalEnvironment.WTX.DynamicMap)
  2. A dynamic path to a map in the local environment tree (LocalEnvironment.WTX.MapServerLocation)
  3. A map that is configured through the TX Map node properties, whether it is configured through the map settings interface or by a WebSphere® IBM Integration Bus broker archive (BAR) editor.

Default directory locations for dynamic maps

The default location of a dynamic map’s log, trace, and work files is:
MQSI_WORKPATH/common/log/WTX/ExeGrpName/FlowName/NodeName/DynamicMapName
If you do not provide a dynamic map name by using LocalEnvironment.WTX.DynamicMapName, the dynamic map bytes are in the directory:
MQSI_WORKPATH/common/log/WTX/ExeGrpName/FlowName/NodeName/NodeName

You can find the value of MQSI_WORKPATH in a WebSphere IBM Integration Bus command shell environment.

If the dynamic map requires static files or RUN maps, put them in the same directory as the dynamic map's log, trace, and work files.