Starting dxladebug

dxladebug is started either from CDE or with the option to open the user I/O window:

> dxladebug -iow  my_progexe &

To start dxladebug from a script, insert in the script the following statement:

dxladebug -iow my_program &

and invoke the script as follows:

my_script  param1  param2 &

N.B. Type all script parameters and run script in background.

With this type of startup dxladebug opens the I/O debugger window and all stdin data must be typed in this window. If stdin data is too long and complex to be typed as happens with control cards, the script must create a temporary file with control cards instead of getting data from stdin, then the debugger is called in the script with the following statement:

dxladebug my_program &

When the debugger has opened the debugger window, give the following debugger command:

run -s < x.cards

where x.cards is the name of the temporary control card file. It is a good practice that the script writes a message with the run command to remind the user how to start the debugging session.

dxladebug opens a 2 view window similar to the VMS debug window. The program source code is listed in the upper view, in the lower view are typed the debugger commands and listed the debugger messages. User I/O is typed/listed in another window, the debugger I/O window opened when dxladebug is invoked with the -iow flags.

The debugger windows support several programmable menus and button panels that are described in the debugger manual. For normal debugger operation the only commonly used buttons are:

Interrupt

Interrupt program or debug without ending the debug session

Step

Step into a routine or go to the next line

Return

Execute up to the current routine end and stop in the caller at the next statement

Continue

Start or resume execution up to the next break

When the program completes execution normally during a debugging session, use rerun to rerun the same program, or load and rerun to run another program, or use the file menu to select graphically new debug arguments and options. Use run -s or rerun -s to set or change program arguments when starting or restarting a debugger session.

To interrupt program execution or to abort a debugger operation during a debugging session, click on the Interrupt button on the push-button panel. Clicking on Interrupt does not end the debugging session. Click on Continue to resume program execution.

To end a debugging session and terminate the debugger, choose File:Exit or enter quit from the command prompt.