It is likely that RiverWare object or slot names do not match their associated database names. For example, the reservoir inflow is called Inflow in RiverWare while in DSS Part C, it is instead called RES-INFLOW. Because different databases use different naming conventions, there is no way for RiverWare to know the database’s naming convention. The name mapping tool provides a tool for the user to specify the link between the two naming systems. The name mapping tool allows the user to define multiple name mappings.

To bring up the name mapping editor from the DMI Manager, the user selects Utilities, then Name Maps.

Double-clicking the newly added Name Map opens the Name Map dialog as shown in the following screenshot. In this dialog, the user is able to edit the name of the Name Map. Selecting Name Map, then New adds a new entry to the list.

Selecting the newly selected entry opens the context menu options shown in Figure 4.26. Either select Select Simulation Object or Select Slot. This action opens the selector dialog for the appropriate selection. In this dialog, the user selects the desired objects or slots that will be part of this Name Map. If accounting is enabled, supplies, accounts, exchanges, and paybacks are also available. Use the filters and wildcards to select generic slots. For example, the user could select Reservoir.Inflow as an entry. See Creating a Name Map of All Reservoir.Inflow Slots in User Interface for details on using the selector. The selections made here are considered dynamic root selections. That is, the selection is saved with the model file and is automatically updated if objects or slots are added to or removed from the model. This is especially useful when using wildcards.

To define the data name, in the Name Map manager, select the blank area to the right of the entry under the word Name. This is where the user specifies the database’s variable name for the entry. Figure 4.26 shows an example.

The entries in the Name Map are prioritized with the highest priority first. If there is a conflict between two entries, the entry with the highest priority takes precedence and the other entry becomes disabled with a red X. This means that if there is a red X, there is a higher priority selection that controls the item. For example, in Figure 4.27, the first entry for ResA.Inflow (INFLOW) takes priority over the second entry (RESINFLOW). The green check marks show that the first item is controlling the selection. This functionality allows users the functionality to create a name map in a generic case but redefine it in special case.