Remote Debugging

isCOBOL allows remote debugging of programs. The only requirement is that the iscobol.rundebug * property is set to 1 or 2. The program runs normally, listening to a TCP/IP port. When a debugging session establishes a connection with it, the user can debug the program.

Remote debugging is often used to debug isCOBOL Web Services or programs that do not have a user interface.

To start a remote debugging session, the only information that the debugger needs are the host name of the machine running the program to be debugged, and the port number to which it is listening. 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.