Manage EJM Map Files

In the EJM Map Files workspace, you can view and research all mappings in a single place. With a large number of bundle-based processes and loader profiles, the EJM Map Files workspace makes it easier to maintain the map files to ensure proper routing and avoid any conflicts in wild cards.

About Map Files

The system automatically creates map files when you publish a bundle-based workflow which contains data artifact shapes for external data. Map files for IWS workflows and for profiled loader workflows are stored in the tpe/dynamic/msgcenter/eagle_ml-2-0_workflows and tpe/dynamic/msgcenter/profile/loads folders accordingly.

The NDFA stream (eagle_ml-2-0_default_cm_ndfa) uses map files to find the correct workflow for an incoming file based on the file mask.

List EJM Map Files

To list EJM map files: 

  1. In the EJM Monitoring Tool, click the Maintenance tab.

  2. In the left navigation pane, click EJM Map Files. 

    EJM Monitoring Tool - Maintenance tab

    You see the grid list of maps in the order in which they are searched/applied when a data file arrives to the NDFA stream.

Search EJM Map Files

You can filter the EJM map files list by providing values based on File Mask, Target Workflow name, and Map file name (one map file can have multiple maps defined inside).

To search EJM map files: 

  1. In EJM Monitoring tool, click the Maintenance tab, and then click EJM Map Files in the left navigation pane. 
    You see a list of EJM map files in the grid. The Search Details pane appears at the top of the tab. If it is not visible, you can click the Down Arrow to expand the pane.

  2. In the Search Details pane, provide one or more of the following values, or parts of those values, in the following filter boxes: 
    - File Mask. This corresponds to the list's File Mask column.
    - Target Workflow. This corresponds to the list's Target workflow column. 
    - Map File Name. One map file can have multiple maps defined inside. This corresponds to the list's Map File Name column. 
    If you do not know the exact value, you can specify a few characters at the beginning of or within the value. As you enter filter values, the grid entries change to reflect your criteria. 

  3. You can select the Clear option associated with each filter box to delete the criteria entered in that box. You can also select the Clear All button to delete the criteria entered in all filter boxes. 

Perform a Routing Check

Another very useful feature is ability to "dry-run" the routing. A routing check allows to you to determine which file mask applies to a specific file name, and to which workflow it would be redirected.

To identify masks for a file name: 

  1. In EJM Monitoring tool, click the Maintenance tab, and then click EJM Map Files in the left navigation pane. 
    You see a list of EJM map files. The Search Details pane appears at the top of the tab. If it is not visible, you can click the Down Arrow to expand the pane.

  2. Copy the file name for which you want to perform a routing check. 

  3. In the Search Details pane, paste the file name in the Routing Check box. 
    The grid shows only the matching file masks. Note that the masks in the first column of the grid work as if they were enclosed in asterisks. In the example shown in the following figure, the file name prior_nav_data_20210506.txt matches the mask, nav_data, and would be routed to the am_concat workflow for processing. 

    EJM Map Files - Routing Check box

View a Map File's Content

You can display the content of a map file displayed in the EJM Map Files grid. 

To display the content of an EJM map file: 

In the EJM Map Files grid, point to the row with a map file for which you want to view more information. 

A window displays the content of the map file for the selected row.

Copy Data for an EJM Map File

You can copy the map file content, map file name, and file mask for a row in the EJM Map Files grid into an exchange buffer. 

To copy EJM Map Files data:

In the EJM Map Files grid, right-click the row with data you want to copy, point to Copy, and then click one of the following values:

  • File Data. Copies the full content of the map file associated with the row.

  • Map File Name. Copies the map file name associated with the row. 

  • Mask. Copies the file mask associated with the row. 

EJM Map Files - Copy right-click options

Enable or Disable a File Mask

You can enable or disable the file mask associated with a row in the EJM Map Files grid. A green dot in the row's left column identifies rows with enabled file masks. A red dot in the row's left column identifies rows with disabled file masks. 

To enable or disable a file mask:

Do one of the following:

  • In the EJM Map Files grid, right-click the row with a disabled file mask, and click Enable to enable the file mask associated with the row. 

  • Otherwise, right-click the row with an enabled file mask, and click Disable to disable the file mask associated with the row. 

After such change, it is not necessary to restart any services or even to refresh Message Center cache. The changes take effect immediately.

EJM Map Files grid - Enable option