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.