PL/I Application

Describes the fields and controls on the Debug Configuration dialog box for PL/I Application configurations.

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 cobdebugremote32 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 cobdebugremote32 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 cobdebugremote32 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.
Use X Server
For SSH-only connection types (Micro Focus DevHub SSH Only), this option must be selected when debugging, to send output to your X Server implementation : if not, an error is displayed at the top of the dialog box.
(If you are simply running your PL/I application, you may clear this option to bypass the X Server implementation, and display output in the Console view within the IDE; this is suited to simple I/O programs, but for anything more complex, you may still want to use an X Server implementation, for a better display experience.)
For other connection types, this option is unavailable, and an X Server implementation must be used in all scenarios.
X Server (DISPLAY)
If you are debugging an application on a remote UNIX machine using Micro Focus Enterprise Developer UNIX Components, enter the identifier for the X server that will display the remote program output. The default value is client machine name:0.0.
Before debugging, make sure that the X server is running and that the remote machine xhost configuration has the correct access permissions. You can use the xhost + command to add your host or username to the list of those permitted.
Main Program
Select the main executable in your project. If you have already selected this in a build configuration you only need enter the build configuration name, otherwise you can browse to the program's location in your project.
Start options
Enter the arguments to pass to the program when it starts. You can also indicate the working directory of the application if the project doesn't explicitly specify its location.
Debug options
Application is 64 bit
Check this when the application you are debugging is 64-bit.
Run options
Check Pause after running the application to prevent the application terminal from automatically closing once it has completed running. This option gives you time to note any terminal output. Press Enter to close the terminal.

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.