Setting up the pluglet debugging support

How you enable debugging support for the workbench depends on the details of your configuration.
The pluglet debugging support described is only enabled for workbench instances that are debuggable. The workbench must be started with the “-Xdebug” and “-Xrunjdwp” Java VM debug arguments.

The following table lists the appropriate forms of these debug arguments for IBM® J9 VM, the IBM Classic VM, and the Sun VM:

Java VM Java VM debug arguments
IBM 1.4 J9 -Xj9 -Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=n,onthrow=com.ibm.xtools.pluglets.ui.internal.debug.PlugletDebugException,address=8000
IBM 1.4 Classic -Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=8000
IBM 1.5 -Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=8000
Sun -Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=n,onthrow=com.ibm.xtools.pluglets.ui.internal.debug.PlugletDebugException,launch=none,address=8000
Note: The socket port number specified in the address value of the “-Xrunjdwp” Java VM argument can be any available port number on your workstation. The value 8000 in the table above is typically used for debugging, but other values can be used as well.
To enable the pluglet debugger feature:
  1. Add the debug arguments to the “eclipse.ini” file after the “-vmargs” workbench argument. Each debug argument must be specified on a line by itself after the other VM arguments already in the file.
  2. Modify your desktop shortcut for your workbench, and add the debug arguments by specifying them in a “-vmargs” workbench argument.
  3. Click Run > Internal Tools.
  4. Verify if the Pluglet Debugger was added to the pull down menu.

    Pluglet debugger functionality

Now, you are ready to launch your pluglet debugger workbench.

Feedback