This document covers the following topics:
Starting with Natural for Windows Version 6.2, the debugger is integrated in Natural Studio. The complete Natural Studio functionality can thus be used in parallel to the debugger. For example, when the debugger is active, you can navigate to another object in the library workspace or you can search for a specific object using the command.
The debugger is used to debug Natural applications in the following environments:
in the local environment, and
in a remote environment, that is: on a mapped development server (SPoD). The prerequisite is that one of the following versions is installed on the development server:
Natural for Mainframes Version 4.2 or above.
Natural for UNIX Version 6.2 or above.
No additional settings are necessary for debugging. Natural Studio handles all steps internally (such as setting up or terminating the communication with the corresponding server).
See also Environments and Views in the Library Workspace in the documentation Using Natural Studio and Accessing a Remote Development Environment in the documentation Remote Development Using SPoD.
Note:
Several differences exist when you debug applications in a remote
mainframe environment. These differences are listed in the platform-specific
Natural Development Server (NDV) documentation which applies to this Natural
release. The NDV documentation is available separately; it is not part of this
Natural for Windows documentation.
When you are working with Natural Studio and invoke the debugger for an object on a mapped development server, it is possible that the old debugger is invoked instead of the new integrated debugger. This is the case when an old version of Natural is installed on the development server. Old versions are:
Natural for UNIX Version 6.1.1 or below.
With one of the next versions, remote debugging will no longer supported. Instead, you will have to use the debugger which is integrated in Natural Studio.
Remote debugging is done when you debug a native Natural for UNIX application from a Windows computer, or when you debug a Natural dialog application remotely from an other PC. This is done outside the context of SPoD.
To enable remote debugging, you have to proceed as follows:
Install the debug front-end on a Windows computer. This also installs
the remote debugging service natdbgsv
which must be active for
remote debugging. See Installing the Remote
Debugger.
Define the parameters RDNODE
,
RDPORT
and RDACTIVE
in the
environment which contains the application that is to be debugged. See
Setting Up Your
Environment for Remote Debugging for further
information.
Invoke the debugger by entering the system command
DEBUG
object-name
in the
environment which contains the application that is to be debugged.
The following topics are covered below:
Important:
For running the remote debugger, the Microsoft Windows Personal
Firewall must be deactivated. See
Configuring the
Microsoft Windows Personal Firewall to Run Natural in the
Operations documentation for Natural for
Windows.
If you have Natural for Windows installed, you must use the remote debugger delivered with Natural for Windows. If the remote debugger has not yet been installed, use the Modify option of the Natural installation package to add the remote debugger to your Natural for Windows installation. See Maintaining Your Natural or Natural Runtime Environment in the Installation documentation for Natural for Windows.
You only need to install the remote debugger stand-alone, if you do not have Natural for Windows installed. If you want to you debug a Natural application which is stored on a UNIX platform, copy $NATDIR/$NATVERS/dbrmt/I386/nrd.exe from the UNIX installation medium to your Windows computer (for example, to a temporary directory) and unzip it. Run setup.exe to start the installation of the remote debugger.
The following topics are covered below:
Either install the remote debugger (the corresponding files can be
found on the UNIX installation medium) or install Natural for Windows (the
remote debugger can optionally be installed with a Natural for Windows custom
installation; see the
Installation documentation for Natural
for Windows). This also installs the Natural remote debugging service
natdbgsv
.
To uninstall the remote debugging service, enter natdbgsv
-u
in the command line. To view the current service's port name
and version, enter natdbgsv -s
. To re-install the
service on a different port, uninstall it first and then enter
natdbgsv -i portnumber
,
where portnumber is the value of the
RDPORT
profile parameter. If the port number is already used, a dialog appears where
you can enter a new port number.
Note:
Before you install the remote debugging service on a port other
than 2600 (default value), you have to change the value of the
RDPORT
profile parameter to match the port number of the
client computer where the Natural application is being debugged.
Install the remote debugger (the corresponding files can be found on
the UNIX installation medium) or install Natural for Windows (the remote
debugger can optionally be installed with a Natural for Windows custom
installation; see the
Installation documentation for Natural
for Windows). This also creates the debugger shortcut in the
menu (in the same programs folder in which you can
find the shortcuts for Natural) which represents the listener process
natdbgsv
. To use remote debugging, natdbgsv
must be
started. The first time the listener process is launched in a specific user
session, a free port number is displayed which must be entered in the
corresponding field of the RDPORT
profile
parameter.
Any subsequent activation of natdbgsv
causes the listener
to be started with the same port number. If this number is already used by a
different application, then the user must provide natdbgsv
's port
dialog with a new port number and RDPORT
must be
adjusted accordingly.
Start Natural with the following profile parameter settings:
RDACTIVE
set to
"ON".
RDNODE
set to the
node name of the Windows server.
RDPORT
set to
"2600" or another port number: the number of either
port with which you have installed the remote debugging service (see
Windows
Side without Terminal Services), or with which port the
listener process was started (see
Windows Side
with Terminal Services).
There are different scenarios of how you can use remote debugging: A single Natural client runs under the control of one remote debugging session or a distributed Natural application runs under the control of several remote debugging sessions. Such a distributed application may include both Natural RPC and DCOM servers or even components not written in Natural, such as Visual Basic clients.
The following topics are covered below:
The diagram below illustrates debugging in a single Natural application.
To debug each component of the following distributed Natural
application, you enter DEBUG
objectname
in the command line of
Natural debug client 1. The first time the Natural Debug Client calls a
subprogram on a Natural RPC server, a new debug session is opened for the RPC
server. Then, the RPC server's processing is debugged. The debug session is
closed as soon as the RPC server is terminated.
The same applies to a Natural DCOM server.
As in the previous scenario, the first time a method on the DCOM server is called, a new debug session is opened for the DCOM server, the DCOM server's processing is debugged, and the debugger session is closed as soon as the DCOM server is terminated: