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:
1. 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.
2. On the Connections tab, select the connection type of the application to which you want to connect.
3. 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.
4. 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:
1. Select Make debug-ready and Attach (local host only).
2. 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
3. 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.
4. 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:
1. Select Attach to debug-ready Process.
2. 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.
3. Enter the port number used to make the process debug-ready.
4. 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.
An AVM running outside Progress Developer Studio for OpenEdge on the same machine or a remote machine.