COBOL Manual for TNS and TNS/R Programs

HP COBOL Manual for TNS and TNS/R Programs—522555-006
15-1
15 Debugging Tools
This section briefly describes the HP debugging tools and refers you to appropriate
sources for more information.
Topics:
•
Standard COBOL Debugging Tools
•
Run-Time Debuggers
•
CROSSREF Utility Program
•
FIXERRS Macro
Standard COBOL Debugging Tools
COBOL offers two batch-oriented debugging tools:
Debugging lines and debugging declaratives are compiled only if the source program
includes a DEBUGGING MODE clause (see SOURCE-COMPUTER Paragraph);
otherwise, they are handled as comments.
Debugging Lines
You can put debugging lines anywhere in a source program. You usually use them to
report values of data items at strategic points in the program.
A debugging line has the letter D or d in the indicator area (column 1 in Tandem
reference format, column 7 in ANSI reference format). If a debugging line contains a
COPY statement, every line that the COPY statement introduces inherits the D or d in
its indicator column.
Tool Applies to ...
Debugging Lines
Individual source program lines
Debugging Declaratives
Sections to be called when your program calls a
particular procedure or calls any procedure
Note. The code that the compiler generates when it compiles debugging lines and debugging
declaratives is not the same as the code that it generates when it ignores them. The additional
code that the compiler generates for the debugging lines and debugging declaratives can alter
the alignment of data items and cause the program to behave differently.