Compiling and Building a Project

When you compile or build your project, Distributed NetBeans spawns the appropriate compiler, as specified in your global, project, or individual file settings.

See Also

Compiling with Compiler Settings

Compiling with a Command File

Executing from the Project Menu

Navigating Compilation Errors

 To compile and build your C, C++, COBOL, FORTRAN, or PASCAL program on a remote  OpenVMS system

1.  In the NetBeans IDE, click on the Filesystems tab.

2.  Select the remote filesystem.

3.  Right click on the language source file.

4.  Choose Remote Compile or Remote Build, or use the Remote Toolbar.

5.  Use a DCL command procedure or an Ant XML file to execute the program.

Important  If you try to locally compile or build these files, you will get an error. The OpenVMS compilers do not run on the desktop system.

    

There are several properties you can change on the remote server that affect how you compile and build 3GL language programs on the remote server. To change these properties, select the file, then right click on Remote Properties.  See Remote Options for more information.  

Command qualifiers for remote compilation are controlled using the remote properties named Local Qualifiers and Global Qualifiers. The values of these two strings are inserted into the compile command that is generated and sent to OpenVMS.  

Local qualifiers are placed after the file to be compiled.  Global qualifiers are placed after the command verb.

Following is an example of the remote properties for a C++ file called DECBURGER.C.

Compiling with Compiler Settings

There are several ways to compile or build files or projects. You can select individual or multiple source files in Filesystems and click Remote Compile or Remote Build or you can select a command file and choose Remote Execute.

Remote Building Versus Remote Compiling
The difference between Remote Build and Remote Compile is that the Remote Build command always compiles the source, whereas Remote Compile only compiles the source if the source is modified or the corresponding object file is not available.

  To compile or build

    1. Select a COBOL file from Filesystems.

    2. Select the Remote Compile or Remote Build command from the Remote Command toolbar  (or use the right-click context menu).

A successful compile or build is indicated by the following message in the Output Window:

Finished <my-3GL-language-app>.

If the Remote Compile command is repeated without the source code changing, the output message is:

Nothing was compiled, everything is up to date. Finished <my-3GL-language-app>.

Right-click on a source file to select Compile or Build

   To specify compiler settings

Select Remote Properties from the context menu.

These properties determine the DCL command with which the compiler will be invoked. You can determine compiler settings for individual files, for projects, and globally.

Compiling with a Command File

If you have a command file (typically a DCL file) defined for compiling and/or linking your source files, you can execute it to build your sources.

   To compile or build with a command file

    1. Check the Command File property of a source file.

    2. Specify the location of the command in the Command File property of the Command File Settings tab.

Using the Compile and Build commands will now execute the command file (instead of compiler settings).

The command file and build directory (optional) are specified 

Creating and Editing Command Files
You can create your command files using the supplied empty DCL file template.  
You can edit already existing files or new command files using the Source Editor.

Executing a Command File by Itself

   To execute a command file

    1. Right-click on a command file (typically a DCL procedure) that you want to use for compiling and/or linking your source files

    2. Choose the Remote Execute command.

This executes whatever compile, build, or link instructions are contained within the command file.

Executing from the Project Menu

If you explicitly add files to an IDE Project, you can execute them from the Project menu with one command. The main advantage is that the source files that you add to the IDE project can exist in more than one mounted directory, because the IDE project can be considered to be a virtual directory.

   To execute from the Project menu

           

You can add a new file to an IDE project from the context menu of a project icon

Navigating compilation errors

In the Output Window, errors are highlighted with the details of the compilation error (source file and line number). Double-click on the blue underscored text to jump to the appropriate place in the source file, which is highlighted in red.   

 

A compile error is shown in the Output Window and, when the link is clicked, is highlighted in the Source Editor