WITH DEBUGGING MODE Clause

Activates a compile-time switch for debugging lines written in the source program.

A debugging line is a statement that is compiled only when the compile-time switch is activated. Debugging lines allow you, for example, to check the value of a data-name at certain points in a procedure.

The WITH DEBUGGING MODE clause causes any USE FOR DEBUGGING procedure to be compiled. Without this clause, these procedures are treated as comments and ignored.

To specify a debugging line in your program, code a 'D' or 'd' in column 7 (indicator area). You may include successive debugging lines, but each must have a 'D' or 'd' in column 7 and you may not break character strings across lines.

All your debugging lines must be written so that the program is syntactically correct, whether the debugging lines are compiled or treated as comments.

The presence or absence of the DEBUGGING MODE clause is determined after all COPY statements are processed. See COPY Statement for details.

You may code debugging lines in the Environment (after the OBJECT-COMPUTER paragraph), Data, or Procedure Divisions.

If a debugging line contains only spaces in Area A and in Area B, it is treated the same as a blank line.

If the WITH DEBUGGING MODE clause is omitted, debug lines are treated as comment lines.