Programming Guides › Programming Guide for Java Connector Server › Java CS SDK › Building and Debugging

Building and Debugging

After installing the Java CS SDK refer to the README.txt file in the jcs-sdk-home directory. The file explains how the ANT build harness works, and information about a preconfigured project and launcher for the Eclipse IDE. Typically the best approach for debugging is to use Eclipse, or your alternative IDE.

However, to debug remotely, there are some flags you are required to provide on the "java" command-line used to run the Java CS. You can refer to these flags in the jcs-sdk-home/bin/jcs.bat file which can be used as an alternative way to invoke a development Java CS (rather than using your IDE). The flags are "-Xdebug -Xrunjdwp:server=y,transport=dt_socket,address=8787,suspend=n".

Note: For more information, see http://www.ibm.com/developerworks/opensource/library/os-eclipse-javadebug/index.html which is a useful reference article.

Be aware of the following:

• The example port chosen in this configuration (8787) can be varied as long as the Remote Java Application used to connect to the remote Java CS server is also updated to match.
• The debug support in the JVM uses this port and is independent of the port on which the Java CS can be contacted, which is configured in server_jcs.properties and defaults to 20410 for production Java CS instances.
• If "suspend=y" is used instead of "suspend=n" then the JCS does not proceed with its start-up sequence until a Remote Java Application attaches to it. This is useful if you want to debug the start-up sequence.
• The production Java CS install uses procrun to launch JVM as a Windows service. To configure its command-line arguments use the Regedit operating system utility to change the following key:

  LOCAL_MACHINE\SOFTWARE\ComputerAssociates\Identity Manager\Procrun 2.0\im_jcs\Parameters\Java

• The Options key contains the list of all options passed to the target JVM, add the debug arguments described previously.
• Restart the Java CS service (or development JVM) after you change the command-line arguments.