You are here: Overview > Testing DAL Scripts > Using DALRUN

Testing DAL Scripts Using DALRUN

You can use the DALRUN utility to test scripts and trigger the interactive DAL Debugger. Debug messages, certain errors, and a dump of the symbol table at the end of the run are examples of output this utility will generate.

Note

When you create a DAL script in Documaker Studio, you can use the Syntax Check button to check the script.

Syntax

DALRW32 /X /INI /D /T /B

Parameter	Description
/X	This optional parameter supplies the name of a script to run. If you omit this option, you can use this INI option to provide the name of the script: < DALRun > Script = file name You can use any extension. The default is DAL.
/INI	This optional parameter supplies the name of an INI file to load. This INI file supplies additional parameters and options. If the DALRUN.INI file is present, the utility loads it by default. Here are the INI options you can include in the INI file: < DALRun > Title = title string(an override to the window title) Script = file name (the script to run) < DALFunctions > Keyword = DLLMOD->FunctionName Keyword2 = DLLMOD->FunctionName2 (and so on)
/D	The debug switch starts the DAL Debugger. When on, the script executes in single step mode and registers this DAL function: DEBUG("message"). The DEBUG function breaks execution, displays a message, and invokes the debugger in single step mode.
/T	This parameter sends certain text messages to the standard output device. These messages are not visible at runtime, but may be redirected when you run this utility.
/B	This parameter lets you run the utility in batch or command line mode. When you include this parameter, the Windows dialog shown when the utility terminates is suppressed.

Here is an example:

DALRW32 /ini=test /d /t > test.txt

This example tells the system to run the DALRUN utility using the TEST.INI file. The /D parameter tells the system to start the DAL debugger. The /T parameter tells the system to send messages to a file named TEST.TXT.