Starting the Remote Debugger

This topic describes how to use the NetBeans IDE to create and debug 3GL programs and remote properties settings of an EXE file.

Creating 3GL Programs

Remote Debug

Setting Remote Properties for EXE Files

 

Creating 3GL Programs

You can create 3GL programs such as C, C++, Pascal, FORTRAN, etc. using Distributed NetBeans Remote 3GL debug interface.

 

The following example shows how to create a new C source file:

1. From the main menu in NetBeans IDE, select File > New File. The New File dialog box is displayed.

2. Click the plus sign (+) next to OpenVMS C/C++ listed under Categories and select C source files.

3. In the File Types, select the template file and click Next.

The New empty C implementation file dialog box is displayed. Enter the File Name and Folder as shown. Click Finish.

A new C source file with .c extension is created in the NetBeans IDE.

 

Remote Debug

To debug a program do the following:

1. In the NetBeans IDE, compile and build your C file. For more information, see Remote Language Compile and Build.

2. Execute a DCL command procedure on the remote OpenVMS system. For more information, see Remote DCL execution.  After DCL execution, EXE and OBJ files are created in the NetBeans IDE.

3. Right-click the EXE file and select Remote Debug.  

 

The NetBeans IDE Output - Remote Debug Server window is displayed.  

 

Setting Remote Properties for EXE Files

To change the settings, right-click the EXE file in NetBeans IDE and select Remote Properties. For more information, see Remote Options.

Use Xterm for Execution

The Use Xterm for Execution property is set to False by default. Your application will automatically point the display at your desktop system. Setting Use Xterm for Execution to True is useful if you want to view terminal output from your OpenVMS system, or if you want to prompt the user for input.

 

Run as Foreign Command

The Run as Foreign Command property is set to False by default. Setting this property to True allows you to debug the program in foreign command. It also allows you enter values in the Arguments dialog box by clicking the button next to Arguments property. These arguments will be appended to the foreign command from the Arguments property or as entered in the Prompt for Runtime Arguments property. For more information about using foreign commands, see the OpenVMS User's Manual.

Note:

1. The values entered in Enter the arguments dialog box overrides the values set in the Arguments property.

2. To enter a value in Arguments property you must close and open the Remote Properties dialog box. If Run as Foreign Command or Prompt for Runtime Arguments properties are checked, the Arguments property is disabled.

 

Prompt for Runtime Arguments

The Prompt for Runtime Arguments property is set to False by default. Setting this property to True allows you to enter the values in the Enter the arguments dialog box when you right-click and select Remote Debug in the NetBeans IDE. However, the values entered in Enter the arguments dialog box overrides the values set in the Arguments property.

The prompt will appear only when the Run as Foreign Command property is checked.