Debugging: cobcdebug and -g

Contents
Compile with -g
Run the debugger
DISPLAY as a poor man debugger

Compile with -g

Add -g when compiling to keep source lines in the object. Without it the debugger shows machine-level views only:

cobc -x -free -g -o payroll payroll.cob

Run the debugger

GnuCOBOL ships cobcdebug, a source-level debugger. Set breakpoints by paragraph name, step sentence by sentence, and print any working-storage field by name:

cobcdebug ./payroll break PROCESS-ROW run display WS-TOTAL-PAY

DISPLAY as a poor man debugger

In production shops, a temporary DISPLAY of the suspect field is still the fastest way to see a value. Remove it before release: stray DISPLAY lines are a classic mainframe audit finding.

Next: Encodings: EBCDIC, ASCII and UTF-8

Article author: Arthur Isaev

Related articles
COBOL
COBOL course: zero to hero in 50 lessons
What is COBOL and where it runs
Install COBOL and check the version
cobc: the COBOL compiler
Your first COBOL program
The four divisions
Variables and PICTURE clauses
Numbers: USAGE, COMP and COMP-3
Alphanumeric fields (strings)
Constants: level 78 and VALUE
Conditions and relation tests
IF, ELSE and EVALUATE
PERFORM loops
Tables: OCCURS arrays
INDEXED BY and OCCURS DEPENDING ON
Paragraphs and sections
STRING and UNSTRING
Files: SELECT and FD
Sequential files: READ and WRITE
Error handling: USE and DECLARATIVES
Copybooks and COPY
OO COBOL: classes and objects
Inheritance in OO COBOL
Intrinsic functions
COBOL idioms and clean code
Build tools: make and cobc flags
Testing COBOL programs
Debugging: cobcdebug and -g
Encodings: EBCDIC, ASCII and UTF-8
Date and time
JSON and XML
Calling C functions
Subprograms: CALL and USING
SQL with EXEC SQL
DISPLAY and formatting
ACCEPT and the SCREEN section
The Report Writer
Sorting with the SORT verb
Command-line arguments
Environment and RETURN-CODE
Logging to files
CSV parsing
CICS overview
Batch processing and JCL
File status and transactions
Db2 in practice
Capstone: CLI calculator
Capstone: fixed-width file processor
Performance: tuning COBOL
Modern COBOL tour (2014+)
Hero roadmap: the whole course on one page
Install COBOL on Windows 11
Install COBOL on Ubuntu
Install COBOL on Rocky Linux
Install COBOL on macOS
Install COBOL on FreeBSD
COBOL in Docker
COBOL on mainframes

Search this site

Channel @aofeed Chat @aofeedchat

Contacts and cooperation:
I recommend our hosting beget.com
Write to info@aredel.com if you:
1. Want to write an article for our site or translate an article into your native language.
2. Want to place thematically relevant ads on the site.
3. Ads on my site pass maximum censorship. If you see an ad block unsuitable for school-age children, shocking or misleading - please contact us by e-mail
4. Found a mistake, inaccuracy, bug, etc. on the site. ... .......
5. Articles can be shared on social media by clicking a network icon: