Local Master Configuration

A local master configuration file can either be located in the Eclipse root folder with the name MasterConfig.xml or MasterConfig.txt depending on its format. See Master configuration syntax for more information. Alternatively, a master configuration file can be returned by a local operating system command. See Master Configuration for more information. In this case, a local system reference can be created in the Application Explorer view:

  1. Right-click in the Application Explorer view, and then click Add System.

    This opens the Add System(s) dialog box.

  2. Select the Local System entry.
  3. Click OK.

Expanded the local system reference to view all the applications defined in the local master configuration file.

Master configuration syntax

The master configuration can be defined in one of two supported formats: flat format and XML. Both formats use the same keywords. The table below shows all available keywords and their meanings.

The flat format master configuration consists of lines with keywords, together with the respective values. The keywords are separated from the values by a colon and at least one space.

For example, a row in the master configuration file might look like this:

System: System_name

Lines beginning with an asterisk (*) are interpreted as comments.

Flat format XML format Description
System <System> Name and identifier of the remote system as it is displayed in the Tree view. It is used as a unique identifier for caching application data, so changing the name in a productive system is not recommended.
Appl <Appl> Name and identifier of the modeled application as it is displayed in the Tree view.
Conf <Appl conf="…"/> Platform, path and name of the model file.
Version <Appl version="…"/> Version of the model file.
INFO <Appl info="…"/> Optional. Information about the data that is deleted for consistency in the Eclipse Workspace when loading a new version of the model.
Property: <Property ID>=<Value> <Property propertyID="…" value="…"/> Static property values for an application.
EndAppl </Appl> End of an application description.

Any number of modeled applications can be listed for a system. The master configuration file must have at least one application defined.

The Conf entry consists of the specification of the platform together with the platform-dependent fully-qualified or absolute file name. The only supported value for the platform is local..

Examples of correct Conf data:
  • local:c:\config\config.xml

The INFO entry determines which persistent information held in the Eclipse Workspace have to be deleted in the case of a version change of the modeled application, for consistency. Permitted information are filters and elements. The information can be combined in any way.

INFO entry Deleted files Content of the files
filters ft_filters.xml All filters in the application
elements et_elements.xml

eb_elementsinlists.xml

li_<listid>

lm_Element_Lists.xml

All cached elements that are assigned to the application and all element lists in the application  

Master configuration from OS command 

A local master configuration can be returned dynamically by an operating system command. The command, which could, for instance, execute a script file to return the configuration, must be specified with the "teamdeveloper.masterconfig" Java system variable. See Setting Java System Variables for more information.

The value of the variable must contain an operating system command, which returns a complete master configuration file in XML format to standard out when executed.

For example (Windows):

  • cmd.exe /c type %HOMEDRIVE%%HOMEPATH%\\localmasterconfig.xml
  • cmd.exe /c H:\batfiles\MasterConfiguration.bat