You can use the Progress Developer Studio for OpenEdge Debugger in attachable mode by
attaching it to a debug-ready external AVM. The external AVM could be any one of the
following:
- An AVM running outside Progress Developer Studio for OpenEdge on the same
machine or a remote machine.
- An AppServer or WebSpeed agent running on the same machine or a remote
machine.
To attach the Debugger to an external AVM:
-
Select a launch configuration under the External OpenEdge
Application node on the Debug
Configurations wizard. For more information on selecting a launch
configuration, see Running or debugging a program.
-
On the Connections tab, select the connection type of the
application to which you want to connect.
-
Select one of the following options:
- Make debug-ready and attach (local host only) -
Makes a process debug-ready and attaches the Debugger to the process. Select
this option only if the external AVM is running on the same machine as the
Debugger.
- Attach to debug-ready process - Attaches the
Debugger to a process that is debug-ready. Select this option if the
external AVM instance is running on a remote machine.
-
On the Source tab, specify one or more source lookup paths
on which Progress Developer Studio for OpenEdge searches for the source code of
the program being executed by the attached AVM. For more information, see Source tab (Progress OpenEdge External AVM).
Making a process debug-ready and attaching the Debugger to it
To make a process debug-ready and attach the Debugger to it:
- Select Make debug-ready and Attach (local host
only).
- In the Process ID field, enter the process ID of the
process on the local machine you want to debug.
o list the currently running
OpenEdge processes, click Select Process. The
Select Process dialog box appears. For more
information, see the Select Process dialog
- In the Port field, enter a port number which you want to
use for communicating with the client process, or leave the default value (0)
for the AVM to determine a usable port number.
- Click OK.
Attaching the Debugger to a debug-ready process
To attach the Debugger to a process that is already in a debug-ready state:
- Select Attach to debug-ready Process.
- Enter the name of the host on which the process is running, or accept the
default localhost.
Note: You must enter a host
name if the process is not running on the same machine as
the Debugger.
- Enter the port number used to make the process
debug-ready.
- Click OK.
When you select Debug on the debug launch configuration, Progress Developer Studio
for OpenEdge tries to connect to the AVM specified by the host (or process ID) and
the port number. Once connected, the Debug view displays the attached AVM.
Note: The external AVM must be in the debug mode on the specified host and
port in order to make a successful connection with Progress Developer Studio for
OpenEdge. Only one debug client can connect to the specified AVM at a time.