Back to Contents

Using the Debugger

This section provides instructions for using the debugger for the GAS.

Topics

• Using the debugger on Windows
• Using the debugger on Unix

Using the Debugger for the GAS on the Windows platform:

To run the FGL debugger, you have to tell gasd not to run "fglrun" directly; instead, gasd must open a DOS command or a xterm window and run "fglrun -d".

1. In %FGLASDIR%/etc/as.xcf, change:
     <RESOURCE Id="res.dvm.wa" Source="INTERNAL">$(res.fgldir)\bin\fglrun.exe</RESOURCE>
   to:
     <RESOURCE Id="res.dvm.wa" Source="INTERNAL">cmd /K start cmd</RESOURCE> (Windows)
     <RESOURCE Id="res.dvm.wa" Source="INTERNAL">/home/test/xterm.sh</RESOURCE> (Unix)
   
   
2. In the application configuration file (default as.xcf), change the DVM availability timeout value to allow you time to type your debug commands.
   For example, change:
     <DVM_AVAILABLE>10</DVM_AVAILABLE>
   to:
     <DVM_AVAILABLE>60</DVM_AVAILABLE> This change allows you 60 seconds in which to type your debug commands.
    
3. Restart the gasd. (The gasd must be restarted whenever you modify the application server configuration file (default as.xcf) in order for the changes to take effect.)
    
4. Enter the application URL in your browser. This opens a shell window.



5. Type the commands to run the application:
     fglrun -d test.42r  <<< Sets the debugger on program test.42r.
     b test:20           <<< Sets a break point.
     run                 <<< Runs the application.
   This refreshes the browser like FGL debugger does with GDC.

Tip: You can also run gasd from the command line and override some the settings for res.dvm.wa:

• gasd -E res.dvm.wa="cmd /K start cmd" (Windows)
• gasd -E res.dvm.wa="/home/test/xterm.sh" (Unix)

Warning! Using gasd as a service

If you are using gasd as a service, you need to allow the service to interact with the desktop.

• Select the service.
• Open the properties
• In the "Log On" folder tab, check "Allow service to interact with desktop".
• Apply the change.
• Restart the service.

Back to the top

Using the Debugger for the GAS on Unix

The following instructions assume that you are operating within a graphical environment. If you are not operating within a graphical environment, simply enter the commands you want to process in the script.

To run the gasd, enter the following:

  gasd -E res.dvm.wa="/home/test/xterm.sh"

This removes all of the options given by gasd along with all error messages. A new xterm is opened. At this point, proceed as you would if you were running your applications from a Windows platform.

Back to the top