IMMap interface overview

The IMMap method creates a map object instance from the byte array representing a compiled map file. This method creates hierarchies of map, card and adapter objects.

Client applications call the methods of the IMMap to do the following map functions:

load
control
run

The map object is created when a map is loaded from a compiled map (.mmc) file or from memory. The TX Programming Interface caches maps. Therefore, if multiple map objects are created for the same map, the map file is read only one time.

A map object is reentrant. After a map object has been created, the map can be run an infinite number of times without any need for the map to be reloaded.

Multiple threads cannot reference the same map object concurrently. If multiple threads need to execute the same map concurrently, a separate map object should be obtained for each thread.

The identifier is used to identify the specific map. This might be the name of the map or any other identifier that the application will use. Subsequent calls to this method with the same identifier will not introduce additional processing of the compiled map. Therefore, after the initial call to this method, the memory consumed by compiledMap might be freed.