COBOL-IT Debugger  
                                       User’s Guide           Version 3.10 
              COBOL-IT® Debugger User’s Guide 
                               Version 3.10 
                                                                Page 1 
                                                            COBOL-IT Debugger  
                                                               User’s Guide                          Version 3.10 
            Acknowledgment 
            This documentation is derived from COBOL-IT Source code, parts of which are derived from 
            OpenCOBOL. 
            Copyright (C) 2002-2007 Keisuke Nishida 
            Copyright (C) 2007 Roger While 
            Copyright (C) 2008-2018 COBOL-IT 
            In 2008, COBOL-IT forked its own compiler branch, with the intention of developing a fully 
            featured product and offering professional support to the COBOL user industry. 
            Permission is granted to make and distribute verbatim copies of this manual provided the copyright 
            notice and this permission notice are preserved on all copies. 
            Permission is granted to copy and distribute modified versions of this manual under the conditions 
            for verbatim copying, provided that the entire resulting derived work is distributed under the terms 
            of a permission notice identical to this one. 
            Permission is granted to copy and distribute translations of this manual into another language, under 
            the above conditions for modified versions, except that this permission notice may be stated in a 
            translation approved by the Free Software Foundation. 
            Conventions used in the General Format diagrams: 
            Brackets [   ]        identify syntax elements that are supported but not required. 
            Curly Braces {   }    identify alternative syntax elements.  Among syntax elements described 
            within stacked curly braces, only one of the entries may be selected.    
            Ellipses (...)        indicate (optional) repetition. If the syntax element is a required element, then 
                                  it will be surrounded by curly braces. 
            Copyright 2008-2018 COBOL-IT S.A.R.L.  All rights reserved.  Reproduction of 
                 this document in whole or in part, for any purpose, without COBOL-IT's 
                                       express written consent is forbidden. 
            COBOL-IT® Developer Studio, COBOL-IT® Sort (CitSORT®), COBOL-IT® MF Command Line Emulator 
            (CitEMUL®), COBOL-IT® Lib Optimizer are registered trademarks of COBOL-IT, S.A.R.L All rights reserved. 
                                                                                                         Page 2 
                                                COBOL-IT Debugger  
                                                   User’s Guide                   Version 3.10 
          The CitSQL® family: COBOL-IT® Precompiler for MySQL, COBOL-IT® Precompiler for PostgreSQL. COBOL-IT® 
          Precompiler for Microsoft SQL Server, are registered trademarks of COBOL-IT. All rights reserved. 
          COBOL-IT® Precompiler for MySQL, COBOL-IT® Precompiler for PostgreSQL. COBOL-IT® Precompiler for 
          Microsoft SQL Server are licensed by COBOL-IT under exclusive license with the Raincode Company. 
          Third-Party software components embedded in the SOFTWARE and Services and submitted 
          to specific licenses: 
          VBISAM 
          * Copyright (C) 2003 Trevor van Bremen
          * Copyright (C) 2008-2018 COBOL-IT
          * License: LGPL
          GMP (GNU Multiprecision Library) 
          * Copyright 1991, 1996, 1999, 2000, 2007 Free Software Foundation, Inc.
          * License: LGPL
          GNU LIBICONV  
          The libiconv libraries and their header files are under LGPL. 
          Microsoft and Windows are registered trademarks of the Microsoft Corporation. UNIX is a 
          registered trademark of the Open Group in the United States and other countries. Other brand and 
          product names are trademarks or registered trademarks of the holders of those trademarks. 
          Contact Information: 
          COBOL-IT  
          The Lawn
          22-30 Old Bath Road Newbury, Berkshire, 
          RG14 1QN United Kingdom
          Tel: +44-0-1635-565-200
                                                                                     Page 3 
                                     COBOL-IT Debugger  
                                       User’s Guide           Version 3.10 
        ACKNOWLEDGMENT ........................................................................................................ 2 
        DEBUGGER USER’S GUIDE ............................................................................................. 7 
        Compile for debugging ..................................................................................................................................................... 7 
         –debugdb= ....................................................................................................................................... 7 
         -g .................................................................................................................................................................................... 8 
         -fdebugdb ....................................................................................................................................................................... 8 
        Compiler flags enabled by –g / -fdebug / -debugdb ....................................................................................................... 8 
         -fstack-check .................................................................................................................................................................. 8 
         -fmem-info ..................................................................................................................................................................... 8 
         -fsource-location ............................................................................................................................................................ 8 
        Compiler flags related to–g / -fdebug / -debugdb ........................................................................................................... 9 
         -fdebugging-line ............................................................................................................................................................. 9 
         support-debugging-line:[ok/error].................................................................................................................................. 9 
        Capturing information from a debugging session ......................................................................................................... 9 
         COB_DUMP= ............................................................................................................................................. 9 
         COB_ERROR_FILE= ............................................................................................................................... 10 
        File Tracing ..................................................................................................................................................................... 10 
         -fsimple-trace ............................................................................................................................................................... 10 
         -ftrace ........................................................................................................................................................................... 10 
         -ftraceall ....................................................................................................................................................................... 10 
        Compile for runtime error-checking ............................................................................................................................. 10 
         -debug .......................................................................................................................................................................... 10 
        Compiler Flags enabled by –debug ............................................................................................................................... 10 
         Runtime exception checking ........................................................................................................................................ 11 
        Compiler flags related to exception checking ............................................................................................................... 14 
         -ftrap-unhandled-exception .......................................................................................................................................... 14 
         CBL_ERROR_PROC .................................................................................................................................................. 15 
        Controlling the verbosity of the Compiler error report .............................................................................................. 16 
         -v .................................................................................................................................................................................. 16 
         -err  ..................................................................................................................................................................... 17 
         -save-temps (=) ................................................................................................................................................... 17 
        Compiling and Debugging Pre-processed Code ........................................................................................................... 17 
         -fdebug-exec ................................................................................................................................................................ 17 
         -fexpand-exec-copy ...................................................................................................................................................... 17 
         -fkeep-org-src-line ....................................................................................................................................................... 17 
        Syntax Only Checking .................................................................................................................................................... 17 
         -fexec-check ................................................................................................................................................................. 17 
         -fsyntax-only ................................................................................................................................................................ 18 
         -fvalidate-only .............................................................................................................................................................. 18 
        Guidelines for using the COBOL-IT Profiler............................................................................................................... 18 
         -fprofiling ..................................................................................................................................................................... 18 
                                                                Page 4