To run or debug any program in Eclipse, you must create a launch configuration. Launch configurations are particular to the programming language you are using, so an OmniMark Launch Configuration is different from a Java Launch Configuration, for instance.
The quickest way to create an OmniMark launch configuration is to select Run – Debug As – OmniMark Program. This creates a default launch configuration that will run the OmniMark program without any parameters and with the default options. To set parameters and change options you must create a new Launch Configuration or edit an existing one. (Note that you can have more than one launch configuration per program. This allows you to run your programs with different options depending on the launch configuration you choose.)
To create a new launch configuration:
Select Run – Debug.... The launch configuration dialog is displayed.
Right click on OmniMark Application and choose New. A new OmniMark launch configuration is created.
Type a name for the new launch configuration in the Name: box.
To edit an existing launch configuration, you can select Run – Debug... and select it from the list, or you can right click on the launch configuration in the Debug window and select it from the menu.
The OmniMark launch configuration dialog has three tabs, Launch, Parameters, and Common.
The launch tab has the following settings:
The parameters tab has the following settings:
The common tab contains Eclipse options which are shared by many launch configurations.
You can construct a launch configuration by importing a project (.xop) file from standalone OmniMark Studio.
Create an Eclipse project and include your main source (.xom) file in that project.
Choose File – Import.... The import dialog will appear.
Choose Standalone OmniMark Studio project file and click Next.
Use Browse to locate the project file you want to import.
If necessary, change the name of the launch configuration from the one suggested.
If more than one workspace file is listed, select the one that contains your main source file. (If none are listed, then the source file listed in the project is not in an Eclipse workspace (project). Cancel and start again.)
Click Finish. The import dialog will close.
Open the launch configuration window and confirm that your project file was imported correctly.
For a fast run, debug or compile, in the Navigator window right click either a program file ".xom" or an OmniMark project file ".xop". Then select the processing desired. The launch configurations used to do this type of processing are not permanent and therefore cannot be reused.
If the run or debug is chosen on a program file then the program is immediately lanuched. In both cases, no command line arguments provided to the program so do not use these processing options if the program expects parameterization from the command line.
If the compile option is selected then the program is byte-compiled and stored in file with the same base name but with ".xvc" file suffix.
If run or debug is chosen on a project file then the program is immediately launched and the parameters specified in the project file are passed to the program.
If the compile option is selected then the program specifed in the project file is byte-compiled. If the project file does not specify a file to save the byte codes into then they are stored in a file with the same base name as the program file but with ".xvc" file suffix. If there is a byte code file name specified then it is used.