Setting up the pluglet debugging support

How you enable debugging support for the workbench depends on the details of your configuration.

Before you begin

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 Oracle VM:

Java VM	Java VM debug arguments
IBM 1.4 J9	`-Xj9` `-Xdebug` `-Xrunjdwp:transport=dt_socket,server=y,suspend=n,onthrow=com.ibm.datatools.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`
Oracle	`-Xdebug` `-Xrunjdwp:transport=dt_socket,server=y,suspend=n,onthrow=com.ibm.datatools.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 that is listed in the debug arguments table of this document is typically used for debugging, but other values can be used as well.

Procedure

To enable the pluglet debugger perspective:

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. For example, add the following IBM 1.5 VM debug arguments to the eclipse.ini file stored in the default directory for an installation of IBM InfoSphere Data Architect version 7.6:
```
-vmargs -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=8000
```
Modify your desktop shortcut for your workbench, and add the debug arguments by specifying them in a -vmargs workbench argument. The following example lists a target shortcut link for an InfoSphere Data Architect version 7.6 workbench that uses the -vmargs argument:
```
"C:\Program Files\IBM\IDA7.6.0\eclipse.exe" -product com.ibm.rational.data.architect.product.ide -vmargs
```
Click Run > Internal Tools.
Verify if the Pluglet Debugger was added to the pull down menu.

What to do next

Launch the pluglet debugger workbench.