Rational Developer for System z
Enterprise COBOL for z/OS, Version 4.1, Compiler and Runtime Migration Guide


Initiating Debug Tool

The way in which you initiate Debug Tool is different for Enterprise COBOL programs. When you use Debug Tool, the application program starts first and the Language Environment TEST runtime option controls the invocation of Debug Tool. (With VS COBOL II, you are required to invoke COBTEST first; it then starts the application to be debugged.)

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 on the Language Environment TEST option subparameters and suboptions, see 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 Language Environment Programming Reference.


Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)