Initiating Debug Tool

When you use Debug Tool, the application program starts first and the Language Environment® TEST runtime option controls the invocation of Debug Tool.

You can also invoke Debug Tool directly from your application by using the Language Environment callable service CEETEST. A brief description of these two methods follows.

TEST runtime option

The Language Environment TEST runtime option is used to determine if Debug Tool is to be invoked when an application program is run with Language Environment. Invocation can be immediate or deferred, depending on the option subparameters.

The IBM®-supplied default is NOTEST. This specifies that Debug Tool is not to be initialized to process the initial command string nor is it to be initialized for any program condition that might arise when you run the program. However, if debugging services are needed, you can invoke Debug Tool by using the library service CEETEST.

For detailed information about the Language Environment TEST option subparameters and suboptions, see the Language Environment Programming Reference.

CEETEST

Language Environment provides callable service CEETEST to allow Debug Tool to gain control, and to specify a string of commands to be passed to Debug Tool. Calling this service, causes Debug Tool to be initialized and invoked. (If Debug Tool is already initialized, then this re-entry is similar to a breakpoint.)

When using CEETEST to invoke Debug Tool, the string parameter containing a command list is optional. If you do use a command list, the commands are passed to Debug Tool and executed. If the command list does not contain any GO, GOTO, STEP, or QUIT commands, commands will then be requested from the terminal or the primary commands file. If the GO command is encountered at any point (command list, terminal, or commands file), Debug Tool returns to the application program at the point following the service call and your program continues running.

For detailed information and examples of the Language Environment callable service CEETEST, see the Language Environment Programming Reference.