How can I enable Java debugging?

You can enable Java debugging to check for problems in Java applications.

About this task

The HCL Notes® client supports Java debugging in the following contexts. Each context has its own JVM. Only one user can debug at a time in each context.

  • Foreground -- Java code that runs in the Notes® client interactively, for example, an agent triggered from the Actions menu.
  • Background -- Java code that runs in the Notes® client under control of the task loader, for example, a locally scheduled agent.
  • Web preview -- Java code being previewed in a browser through Domino® Designer, for example, an applet on a form.

Java code from a script library runs in the context of the calling code.

To enable and disable Java debugging on the Notes® client, complete the following steps:

Procedure

  1. Click Tools > Java Debugging Preferences. This opens the Java Debugging Preferences dialog.
  2. To enable foreground debugging, select Client Agents/Applets and specify a port number to connect the Notes® and debugger computers. Deselect to disable.
  3. To enable background debugging, select Locally Scheduled Agents and specify a port number to connect the Notes® and debugger computers. Deselect to disable.
  4. To enable Web preview debugging, select Http Preview and specify a port number to connect the Notes® and debugger computers. Deselect to disable.

Results

Pick a port number that you think is free. This may require trial and error or asking your system administrator.

Java debugging is disabled by default.

If changes are made to the foreground or background preference, you must restart Notes®. If changes are made to the Web preview preference, the preview must be restarted.

For more information on Java debugging, see HCL Domino® Designer Help.