Initiating the interactive debugger
Your application must be packaged to use the interactive debugger. There are different packaging specifications to use when packaging your application. See Packaging a Smalltalk image. You can also force the interactive debugger to open by specifying the halt message, either in the launch code supplied during packaging or in your application code.
You must already have created a passive image to use the interactive debugger.
Tip icon
For CICS Transaction Server, there must be a connection between CICS Transaction Server and your workstation. To acquire the connection, enter the following:
CEMT I CONN
The following appears:
I CONN
STATUS: RESULTS - OVERTYPE TO MODIFY
Con(BJL1) Net(NRIEYJ00) Ins Acq Vta Appc
Con(LRH1) Net(NRI4GB00) Ins Rel Vta Appc
To change a connection from released (Rel) to acquired (Acq), type an A over the R in Rel.
Tip icon
Using XD Interactive Debugger over TCP/IP with no nameserver
When trying to use the interactive debugger, if you are getting the error EHOSTNOTFOUND or EADDRNOTAVAIL from the run time side, the problem may be that your run time machine cannot resolve the TCP/IP address of your development machine. You can work around this problem by adding an entry to the hosts file on the run time machine for your development machine.
Starting the interactive debugger
When enabling the interactive debugger, you will be prompted to specify the protocol you want to use. If you want to change the protocol, select Change Transport from the XD menu of the XD Transcript. In the dialog that opens, select a transport and then OK. The transport names that begin with EsSCI support TCP/IP; the names that begin with EsCPIP support CPI-C.
When an error occurs in the application running on the target system, the connection between the target system and the workstation is activated. Your Smalltalk session is unaware of the connection until you select Enable Remote Debug from the XD menu. This selection "listens" for an incoming connection. Then, when an interactive debug session becomes active, the XD Debugger opens automatically. For each session, you need to enable the remote debugger listening selection only once.
You can close an XD Debugger window without disconnecting the interactive debugging session. With the connection still active, select Open XD Debugger from the XD menu to re-open the XD Debugger window in that Smalltalk session.
Last modified date: 05/11/2020