General tab
- PL/I Project
- The project that will be used while debugging.
- Connection Properties
- Enter values for these fields if you want to debug your project or the application when it is running on a remote machine.
-
-
- Remote Host
- The name or IP address of the remote machine.
- Launch the cobdebugremote process on the remote host
- Check this to launch the debug configuration on the specified remote host.
- Specify the port on which cobdebugremote process will listen on the remote host
- When you are debugging an application on a remote machine, the
cobdebugremote (Windows) or
cobdebugremote32 (UNIX) process (or
cobdebugremote64 for a 64-bit process) needs to be running on that machine.
- If you are developing the application on the remote machine
- If you are using
Micro Focus Enterprise Developer UNIX Components, the IDE starts the
cobdebugremote (Windows) or
cobdebugremote32 (UNIX) process (or
cobdebugremote64 for a 64-bit process) automatically on the remote machine when you start debugging. You do not need to select a port as a
random one is picked when the process starts, but if you select this option you can assign a specific port in the
cobdebugremote port field. If you do specify a port, the process starts automatically on that port.
- If you are developing the application on the local machine and debugging remotely
- You must first start the
cobdebugremote (Windows) or
cobdebugremote32 (UNIX) process (or
cobdebugremote64 for a 64-bit process) from a command promdt.
- The process takes the following options:
- 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.
If you run the process with no options, you must enter the port number displayed in the console in the
cobdebugremote port field.
- Matching options
- Specifies which programs the debugger attaches to when the program starts:
-
-
- Any (Windows only)
- The debugger attaches to any process that is enabled for debugging. For instance, using the environment variable COBSW=+A
or by a call to CBL_DEBUG_START.
Note: This odtion is only available when debugging applications running on Windows.
- Debug session identifier
- Specify the
identifier of the program the debugger should attach to.
- Debug options
-
-
-
- Application is 64 bit
- Check this when the application you are debugging is 64-bit.
- Return to waiting state when debug disconnects
- When checked, the debugger returns to the waiting state after disconnecting.
Other tabs
The other tabs available for all PL/I configuration options are the same as those for COBOL applications. See the
COBOL Application, COBOL Attach to Process, and COBOL Wait for Application Attachment topic for details.