The
cobdebugremote (Windows) or
cobdebugremote32 (UNIX)
process runs on a remote machine and enables you to debug 32-bit applications on that machine using remote connections.
Restriction: The following applies to native code only.
Syntax:
To start the
cobdebugremote (Windows) or
cobdebugremote32 (UNIX)
process, enter the following at a COBOL command prompt:
Options:
Windows:
cobdebugremote option
UNIX:
- no options
- Starts the process and opens a random port for remote connections. The port number is displayed in the console.
- machine=name
- Specify the machine that the process is running on. Only valid with the
stop option.
- port
-
- port=nnnnn
- Specify the port to use to listen for connection requests.
- port=nnnnn-yyyyy
- Specify the range of ports to use. If port
nnnnn is in use, the next port is tried until a free port is found. If no free ports are found in the range, the utility returns an error.
Note: You must enter the same number you set as the
port option in the
cobdebugremote port field of your debug configuration.
- repeat
- After the debug session has been completed, start listening for another connection. If no option is specified, the process exits after the debug session has completed.
- stop
- Causes the process that is listening on the port to exit. Must be used with the
port option. This is only valid when the process is waiting for a connection.
Example
The following example starts the
cobdebugremote (Windows) or
cobdebugremote32 (UNIX)
process using port 45678 to listen for connection requests. After the debug session has been completed, the process starts listening for another connection.
Windows:
cobdebugremote port=45678 repeat
UNIX:
cobdebugremote32 port=45678 repeat
Comments:
If you intend to remotely debug callable shared objects (.so), you must set the COBIDY environment variable to the location of the
.idy file before you start
cobdebugremote32 or
cobdebugremote64.
