COBOL-IT Compiler Suite – Getting Started Version 3.9 COBOL-IT® Compiler Suite Enterprise Edition Getting Started Version 3.9 Page 1 COBOL-IT Compiler Suite – Getting Started Version 3.9 Contents ACKNOWLEDGMENT ........................................................................................................ 5 COMPILER, RUNTIME, AND DEBUGGER TOPICS .......................................................... 7 Introduction ...................................................................................................................................................................... 7 COBOL-IT License terms ................................................................................................................................................ 7 Installing COBOL-IT ....................................................................................................................................................... 8 The COBOL-IT Compiler Suite Distribution ................................................................................................................ 8 Installing the binary distributions (Linux/Unix)............................................................................................................. 9 Installing the binary distributions for the RuntimeOnly (Linux/Unix) ........................................................................ 10 cobol-it-setup.sh ........................................................................................................................................................... 10 Installing the binary distributions (Windows) .............................................................................................................. 11 setenv_cobolit.bat ( Windows 32 )............................................................................................................................... 14 setenv_cobolit.bat ( Windows x64 )............................................................................................................................. 14 Installing a “C” compiler ............................................................................................................................................. 15 Citlicense.xml .............................................................................................................................................................. 15 Highlighting Compiler and Runtime Options .............................................................................................................. 17 Source Format .............................................................................................................................................................. 17 Shared object or native executable ............................................................................................................................... 18 Locating copy files ....................................................................................................................................................... 19 Redirecting Output to another Directory ...................................................................................................................... 20 Calling subprograms .................................................................................................................................................... 21 Using data files ............................................................................................................................................................ 22 Options with multiple source files ............................................................................................................................... 23 Multiple source files to multiple shared objects .......................................................................................................... 23 Multiple source files to a single shared object ............................................................................................................. 23 Multiple COBOL source files to a single executable ................................................................................................... 24 Using compiled executables with compiled shared objects ......................................................................................... 24 COBOL source files and C source files to a single executable .................................................................................... 25 Separating the compile and link steps .......................................................................................................................... 25 Separate compile and link steps for multiple COBOL source files .............................................................................. 26 Linking “C” and COBOL objects ................................................................................................................................ 26 Building a shared library from COBOL and “C” routines ........................................................................................... 26 Linking a shared library with your main program ....................................................................................................... 27 USING THE COBOL-IT DEBUGGER ............................................................................... 28 Conventions Used............................................................................................................................................................ 28 The Debugger Prompt .................................................................................................................................................. 28 Source Location ........................................................................................................................................................... 28 Variables names ........................................................................................................................................................... 29 Usage of the COBOL-IT Debugger ............................................................................................................................... 29 command-line parameters ............................................................................................................................................ 29 program name ............................................................................................................................................................. 29 options .......................................................................................................................................................................... 29 Debugger Commands ..................................................................................................................................................... 31 break ( br ) ............................................................................................................................................................... 31 break [-t] label .............................................................................................................................................................. 31 Page 2 COBOL-IT Compiler Suite – Getting Started Version 3.9 break [-t] module!label ................................................................................................................................................ 32 break [-t] module!line-nr .............................................................................................................................................. 32 break [-t] module!0 ...................................................................................................................................................... 32 bt .................................................................................................................................................................................. 33 continue ........................................................................................................................................................................ 33 contreturn ..................................................................................................................................................................... 34 delete ( d ) <x> ............................................................................................................................................................ 34 frame ( f ) <frame-number> ........................................................................................................................................ 34 info ( i ) ........................................................................................................................................................................ 34 info break ..................................................................................................................................................................... 35 info locals ..................................................................................................................................................................... 35 info sources ................................................................................................................................................................. 35 info target ....................................................................................................................................................................