Starting Remote Compilation

After compile commands and rules are specified as described in Defining Compile Commands and Defining Compile Rules remote source files and library elements can be compiled. Select the source in the BS2000 Explorer view or in a Project View and select Remote Compile With from the context menu. A dialog box will open where you can select the compiler (more precisely the compile rule) with which you want the source being compiled. Your previous selection, if any, is marked with a tick.

BS2IDE persistently remembers your recent selection. If you wish to recompile the same (meanwhile possibly modified) source file or library element with the same compiler (or compile command) it suffices to select Remote Compile from the context menu or to press CTRL+ALT+C (the key binding can be customized in Preferences > General > Keys).

If only a single compile rule matches your source selection, Remote Compile and CTRL+ALT+C are enabled even for the first compilation of this source.

You can also use Remote Compile With (Temporarily) option to compile your source code. For this purpose: select the source file in the Project Explorer view and select the specific compile rule from Remote Compile With (Temporarily) context menu. If you wish to recompile the same source file or library element with the same compiler you can also use CTRL+ALT+O shortcut.

Within a BS2000 Remote Build Project you should prefer Project > Build All or Ctrl+B to build the project rather than compiling individual sources. The incremental project builder will only recompile sources affected by recent changes.

Console view

The SYSOUT of the compile command is logged to the Console view (to be opened via

Window > Show View > Other... > General > Console). The matching compile rule, the values assigned to placeholders, and the finally executed compile command are also logged.

In most cases you do not need to inspect this log. However, during development of compile commands and compile rules it is very helpful to analyze problems. Later on it will suffice to inspect the problem markers created for compiler messages.

Problem markers

After compilation has finished, for each error, warning, or note reported by the remote compiler, a problem marker is created for the compiled source file. As usual problem markers can be viewed either in a text editor opened for the source file, or collectively in the

Problems or

Markers view.

Problem markers are persistent. They are removed before a subsequent compilation of the same source, e.g. after problems have been fixed in the editor and the modified source has been saved.

Listings

In most cases you do not need to insect the listing generated by the compiler because BS2IDE has inspected it for you and has set problem markers for found compiler messages. However, if the listing could not be interpreted, you need to inspect it by yourselves. If the source file is selected in the Project Explorer View you can open the corresponding listing file with the context menu BS2000 > Open Remote Listing File or by pressing Ctrl+Alt+L.