Remote Debugging
isCOBOL allows remote debugging of programs.
Remote debugging is often used in the following scenarios:
• to debug a servlet or a web service running under Tomcat or other servlet container,
• to debug a COBOL program running via webclient,
• to debug a COBOL program that is called by foreign languages like C or Java,
• to debug a program with character-based interface managed by CHARVA,
• to debug a remote program running in the isCOBOL Server.
The program must have be compiled with either
-d option or
-dx option.
At run time, the only requirement is that the
iscobol.rundebug * property is set to 1 or 2 in the isCOBOL configuration. The program runs normally, listening on the TCP/IP port 9999. A different port number can be set via the
iscobol.debug.port configuration property.
To start a remote debugging session, the isCOBOL Debugger needs to know the host name of the machine running the program to be debugged and the port number dedicated to the debugger connection. Use the following command:
iscrun [ -d ] -r [ [ HostName ] Port ] |
When running on Windows, the following command can also be used:
isrun [ -d ] -r [ [ HostName ] Port ] |
The -d option can be omitted when -r is used.
If HostName is omitted, then localhost is assumed.
If Port is omitted, then 9999 is assumed.
In thin client environment you can debug the isCOBOL Server activity by running the isCOBOL Client with the
-d option as explained in
Usage of isCOBOL Client, Format 6.