Running an MDWorkbench RCP application

Once you deployed the launch configuration as an RCP application, you can launch the RCP user interface using the launcher in the export directory (mdworkbench.exe or eclipse.exe on Windows platform).

MDWorkbench first asks the user to validate a license source (license server or license file). The default license source used is the one selected in MDWorkbench IDE (from where the launch is deployed). Note: this license source can be changed in the preferences (menu Window > Preferences).

RCP Application

The Services view shows the available services in this application. Right click Run... on the Execute Deployed Launch Configuration service to run your configuration.

You can also specify the launch configuration as a command line parameter:

mdworkbench.exe -launch C:\otherWorkspace\myLaunch.launch

When you click on Run, the launch configuration is first saved on disk, and then the execution starts. Progress messages and errors are displayed in the Console view. These messages are persisted in a .log file, in the launch configuration directory. Execution outputs (generated files and written models) are displayed in the Report view. Double-clicking on an element in this view lets you open the corresponding file in the system editor (platform dependent).

Note: you can also execute the launch configuration in headless mode (command line).

Evaluation directory

The evaluation directory is set in the launch configuration. You can override the evaluation directory using a -evaluationDirectory parameter:

mdworkbench.exe -launch C:\otherWorkspace\myLaunch.launch -evaluationDirectory c:\generated

Launch arguments

The launch arguments (model connectors to use to read and write models, String arguments, etc.) are set in the launch configuration. You can override some launch arguments using -args[index] parameters:

mdworkbench.exe -launch C:\otherWorkspace\myLaunch.launch
-args[0] "XMI|c:\models\myModel.xmi" -args[2] "Hello World" -args[3] true

For a model connector, the value must of the form connectorName|uri (e.g. "XMI|c:\models\myModel.xmi").

Log

Progress messages and errors are persisted in a .log file, in the launch configuration directory.

Related tasks
Running an MDWorkbench command line application