Running your map

ECMap is known for its high speed and quality performance. Map generation results in an efficient map run process, which in turn contributes to the speed and throughput of the ECMap mapping product.

Running your map involves:

The final steps in the mapping process are to generate and run your map. During generation, your map is checked to make sure that everything is set up properly. Generating the map produces the .map file, which contains all the mapping instructions you created. Running the map – with the ECRTP runtime program – interprets the .map file, reads the input data, performs the mapping, and creates the output file.

StepsGenerating your map

When you generate a map, ECMap compiles all of your business rules and logic into your finished map.

  1. Select Generate Map (the yellow traffic light) on the toolbar or Workspace. The Generate Map window displays.

  2. Make sure that the Multiple Files check box is not checked.

    NoteMultiple Files is checked by default. Select the check box to uncheck it, or you receive a warning – “All Recd Files with Multiple Recs must have Record Type Fields”

  3. Select Run on the Generate Map window. Messages flash across the text box until the following message appears: “Map generation completed successfully”.

  4. You can view the results of the map generation process by selecting View Log. The Generate Log window displays.

  5. Select Exit to return to the main ECMap window.

StepsRunning your map

Map files are distributed and deployed with the runtime engine.

  1. Select Run Map (the green traffic light) on the toolbar or Workspace.

    The Run Any-to-Any Map window displays. It has several tabs – Required, Option 1, Option 2, File Alias, ODBC Alias, Parameters, I/O Redirect, and Web Script.

    For this exercise, you have to enter only one value. The program has already entered the other required information for you.

    If a map run is successful and Short Trace is used, the message “Maprun Complete – No Errors Encountered” appears. If the run is not successful, you need to run the map again, choosing Long Trace. You would then use the expanded information in this log to correct your errors.

  2. On the Option 1 tab, select Short Trace as the Trace Type.

  3. Select Run Map.

  4. Select View Trace to review the trace log. The message “Maprun Complete – No Errors Encountered” displays on the outgoing.err-Notepad window.

    NoteIf you choose Long Trace as the Trace Type, ECMap gives you a detailed list of records read and written, rules performed, etc.

  5. Close the outgoing.err Notepad window.

  6. Close the Run Any-to-Any Map window to return to the main ECMap window.