This option controls whether a program execution is to be monitored with the AID debugger. It can also determine certain characteristics of the AID debugger.
This option is not available in COBOL-BC.
Format
| |||||||||||||||
TEST-SUPPORT = *NONE
No debugging aid is requested. The compiler generates only ESD debugger information of the type compilation unit. This means that the module (or every module in the case of segmented programs) is assigned a symbolic name consisting of the first 8 characters of the name in the ID paragraph of the compilation unit. When debugging with AID, this name can be used to qualify the compilation unit.
TEST-SUPPORT = *AID(...)
This parameter is required if the program is to be monitored symbolically using AID. It causes the compiler to generate both LSD information and ESD debugger information, which means that symbolic names from the compilation unit can be used for debugging with AID (see description in “AID” manual [8]).
In segmented programs it is possible to generate LSD information - and thus create conditions for symbolic debugging with AID - only if the object module is written to a PLAM library.
STMT-REFERENCE = *LINE-NUMBER
The AID source references are formed using the line numbers generated by the compiler.
STMT-REFERENCE = *COLUMN-1-TO-6
The AID source references are created by means of the user-assigned sequence numbers in the compilation unit (columns 1 to 6).
Debugging with AID is useful only if the assigned sequence numbers are sorted in ascending numeric order.
PREPARE-FOR-JUMPS = *NO / *YES
YES must be specified if, during the AID debugging session,
the AID command %JUMP is to be used (see “AID” manual [8] and section "Advanced Interactive Debugger (AID)") or
test points are to be set selectively on paragraphs or chapters, e.g. when debugging nested GO TO loops (as generated by the COLUMBUS preprocessor COLCOB) in which several paragraph headings follow one another in immediate succession or follow after a section heading.
the AID command %TRACE is to be used to individually trace each COBOL statement (see “AID” manual [8]).
Use of this function increases the size of the object and lengthens the program run time.
VIRTUAL-NAMES = *NO / *YES
YES must be specified if, during the AID debugging session:
- FILLER-elements of structure are to be referenced.
- entries of SPECIAL-NAMES paragraph are to be displayed as elements of the virtual structure SPECIAL-NAMES.