Remote Debugging (Known Issues)

On Ubuntu and SUSE 15.1, you might need to set ptrace_scope to 0 to be able to debug applications. See Debugging Applications Which Run on Ubuntu (ptrace Restriction) for more details.
If, when you try to start debugging a remote application, you are logged on the remote machine (using connectremote) and X server is running, the debugger may encounter an error launching the application and return Debugger Error Code: -1. This may occur if you have started the RDO daemon from a user session on your hub (remote) machine.
To work around this issue, you need to do the following:
- Stop the startrdodaemon daemon and disconnect the RSE connection in Eclipse.
- Either stop X server on the remote machine or establish a new connection to the remote machine using SSH.
- Start the startrdodaemon daemon and debug the remote application.

When debugging a remote program, the performance of the network, specifically the latency between the local and remote machines, will have an effect on the responsiveness of Eclipse. Whenever Eclipse has to show the new execution position, a number of messages are sent from the remote machine, over the network, to get the required information. The effect of this is that it can take a few seconds after a Step command is issued before Eclipse has updated the screen and is ready for the next command.
You can mitigate this delay by closing any unnecessary debug views. For instance, by closing the Expressions view and the Variables view, the number of messages that are sent is reduced, which allows Eclipse to update quicker.
Large programs can suffer from a large delay the first time that the program is displayed in the debugger and an expression is evaluated. You can reduce this delay by following these steps:
1. Create a text file called debugconfig.xml.
2. Add the following lines, and then save the file:
```
<?xml version="1.0" encoding="utf-8" ?>
<NativeDebuggerOptions>
  <DebugOption Option="REMOTECHECKER" Value="yes"/>
</NativeDebuggerOptions>
```
3. At a command or shell prompt, set the environment variable DEBUG_CONFIG to the full path name for debugconfig.xml.
4. Start Eclipse from the same command or shell prompt.
Remote debugging does not work for programs running on AIX or HP machines, if you are trying to debug using Visual COBOL installed on a Linux machine.