You use a COBOL Application debug configuration to debug projects developed on a remote UNIX machine. Depending on your connection
type, you may need to configure an X window implementation before you can debug the remote application, so that the output
of a remote application running on a UNIX machine can be viewed on your local machine. If you are using an SSH connection
type, you do not need an X window implementation (although you can still use one if you wish); with an SSH connection type,
you can direct the remote program output to the Console view in the IDE instead.
UNIX:
If you require an X window implementation, ensure the local X11 server can receive connections from the remote machine. You
can do this using the
xhost + command or by enabling SSH port forwarding. Alternatively, enable TCP/IP connections for X11 by setting a value in a configuration
file in a manner appropriate to your operating system. For example:
- Red Hat: run the
gdmsetup utility and deselect
Deny TCP connections to Xserver in the Security tab (this configures
DisallowTCP=false in /etc/gdm/custom.conf)
- SUSE: set DISPLAYMANAGER_XSERVER_TCP_PORT_6000_OPEN="yes" in
/etc/sysconfig/displaymanager
Configuring the X window
Specify the connection and appearance details in the IDE preferences, as follows:
- Click
.
The options in the Remote Launching group are the ones directly relating to the X window behavior.
- In the
Default X Server (DISPLAY) field, enter the display details.
The default value is
${hostname}:0.0. This configuration applies to both remote COBOL and PL/I projects.
- To change the font used in the display, modify the value of the
X Font field.
Tip: Select
Use X Server font to use the default font settings from the environment where the X Server is installed.
- If you are not using the default port number (8000) to debug remote projects, modify the
Default cobdebugremote port field.
- Modify any of the remaining debug settings, as applicable.
- Click
Apply and Close.