Prepare Transformation Map

After you have created or changed the definition of your Transformation Map using the mapping tool, you need to prepare it for use before it can be executed in a processing sequence.

To do this, simply click the Prepare button at the Transformation Map Details. and then click Prepare in the Prepare Transformation Map window. Preparing your map may take a few minutes.

You may briefly see the MapForce window during the Prepare, as LANSA Composer loads and processes your Transformation Map to generate code that will execute the mapping.  This is normal and you should wait for the MapForce window to close again and the Prepare to continue.

When the Compile code for transformation map step completes successfully you may see a window like this:

You should click OK to allow the remaining steps to proceed.

When preparation is complete, you may click the Show Log button to display a detailed log of the steps completed.  The log will be useful for diagnosing failures in the preparation..

What Does Prepare Do?

The main steps are:

• Generates an executable file that implements the Transformation Map as defined in the mapping tool.  (You may briefly see the MapForce window appear during this step).
• Determines the parameters that the Transformation Map requires and catalogues information about the map.

When it is complete, LANSA Composer places the resulting executable file in the appropriate directory on your LANSA Composer server ready for execution.

For more information, refer to Transformation Map Executable Files.

Note: When your transformation map uses database components that connect to IBM i DB2 database tables, LANSA Composer will remove the library qualifier when you prepare the transformation map to execute as a Java executable (.JAR) file.  You must setup your database configuration so that the required files can be found at run-time.  For more information, refer to Additional Considerations for Transformation Maps Using IBM i DB2 .

When you have successfully prepared your Transformation Map, the new or revised parameters for the Transformation Map can be reviewed on the Parameters tab. The actual parameters shown for the Transformation Map depend upon the map definition in the mapping tool.  The catalogued information for the map can be viewed on the Catalogued tab.