LocalEnvironment DynamicMap and MapServerLocation caching

When the TX Map node Cache map property is enabled, the TX Map node caches the path to a map and the dynamic map bytes that are configured in the local environment tree.

Dynamic map caching

When Cache map is enabled and a dynamic map has a name (LocalEnvironment.WTX.DynamicMapName), the node caches the bytes of a dynamic map (LocalEnvironment.WTX.DynamicMap). The node cannot cache dynamic map bytes that do not have a dynamic map name.

After you cache a dynamic map, a TX Map node that invokes the dynamic map name does not need to retrieve the map bytes from the local environment tree. If the TX Map node receives the dynamic map name (LocalEnvironment.WTX.DynamicMapName) together with at least one placeholder byte in LocalEnvironment.WTX.DynamicMap, the node runs the cached map.

For example, if you cache a map named PreProcessEDI and a TX Map node receives the following input from the local environment tree on a subsequent invocation, the TX Map node runs the cached PreProcessEDI map:

SET OutputLocalEnvironment.WTX.DynamicMapName = 'PreProcessEDI';
SET OutputLocalEnvironment.WTX.DynamicMap = X'00';

To enable the TX Map node to detect changes to a cached dynamic map, use a new map name (LocalEnvironment.WTX.DynamicMapName) to trigger the node to load the map bytes (LocalEnvironment.WTX.DynamicMap).

MapServerLocation caching

When you set the TX Map node Cache map property, the TX Map node caches each unique MapServerLocation path in the local environment tree. The TX Map node does not need to load a cached map path for subsequent invocations of the map, but the map must exist.

To enable the TX Map node to detect changes to a cached map path, use a new map server location (LocalEnvironment.WTX.MapServerLocation) to trigger the node to load a new map path.