Creating a launch configuration in the EGL debugger

To start debugging an EGL text program, non-JEE basic program, or Rich UI handler in an EGL debugging session, you need to establish a launch configuration. You can create a launch configuration yourself, or you can have the EGL application create one for you automatically. In relation to automatic configurations, see "Starting a non-JEE application in the EGL debugger" or "Rich UI debugging."

To start a program using a launch configuration that you create yourself, follow these steps:

  1. Click Run > Debug Configurations. The Debug Configurations window opens.
  2. In the left pane of the Debug Configurations window, right-click EGL Program, then click New launch configuration in the pop-up menu. A new launch configuration is displayed below the EGL Program heading. The Launch tab is initially displayed.
  3. In the Name field, type a name for the launch configuration. By default, the launch configuration has the same name as the program, unless a configuration already exists for this program.
  4. In the Project field of the Load tab, type the name of your project.
  5. In the EGL program source file field, select the program that you want to debug.
  6. If you are debugging a program that takes command line arguments, click the Arguments tab. List the arguments for the program, in order, as you would on the command line.
    Note: To see the arguments for an EGL main or called program, use SysLib.getCmdLineArg() and SysLib.getCmdLineArgCount().
  7. If you need to use a different JRE than the default for this project, click the JRE tab and complete the information there.
  8. If you need additional Java™ classes to run the program, specify the paths for those classes on the Classpath tab.
  9. Add any needed source files on the Source tab.
  10. To set environment variables for the duration of the debug session only, type the names and values on the Environment tab.
  11. The Common tab defines general information about the launch configuration.  You may choose to store the launch configuration in a specific file and specify which perspectives become active when the launch configuration is launched.
  12. Click Apply to save the launch configuration settings.
  13. Click Debug to launch the program in the EGL debugger.
Note: If you have not yet clicked Apply to save the launch configuration settings, clicking Revert will remove all changes that you have made.

Feedback