IBM z/OS Debugger IBM User's Guide Version 14.1.7 SC27-4642-05 IBM z/OS Debugger IBM User's Guide Version 14.1.7 SC27-4642-05 Note! Before using this information and the product it supports, be sure to read the general information under “Notices” on page 581. Sixth Edition (June 2019) This edition applies to IBM z/OS Debugger, Version 14.1.7 (Program Number 5724-T07 with the PTF for APAR | PH07787), which supports the following compilers: v AD/Cycle C/370 Version 1 Release 2 (Program Number 5688-216) v C/C++ for MVS/ESA Version 3 (Program Number 5655-121) v C/C++ feature of OS/390 (Program Number 5647-A01) v C/C++ feature of z/OS Version 1 (Program Number 5694-A01) v C/C++ feature of z/OS Version 2 (Program Number 5650-ZOS) v OS/VS COBOL, Version 1 Release 2.4 (5740-CB1) - with limitations v VS COBOL II Version 1 Release 3 and Version 1 Release 4 (Program Numbers 5668-958, 5688-023) - with limitations v COBOL/370 Version 1 Release 1 (Program Number 5688-197) v COBOL for MVS & VM Version 1 Release 2 (Program Number 5688-197) v COBOL for OS/390 & VM Version 2 (Program Number 5648-A25) v Enterprise COBOL for z/OS and OS/390 Version 3 (Program Number 5655-G53) v Enterprise COBOL for z/OS Version 4 (Program Number 5655-S71) v Enterprise COBOL for z/OS Version 5 (Program Number 5655-W32) v Enterprise COBOL for z/OS Version 6 Release 1 and 2 (Program Number 5655-EC6) v High Level Assembler for MVS & VM & VSE Version 1 Release 4, Version 1 Release 5, Version 1 Release 6 (Program Number 5696-234) v OS PL/I Version 2 Release 1, Version 2 Release 2, Version 2 Release 3 (Program Numbers 5668-909, 5668-910) - with limitations v PL/I for MVS & VM Version 1 Release 1 (Program Number 5688-235) v VisualAge PL/I for OS/390 Version 2 Release 2 (Program Number 5655-B22) v Enterprise PL/I for z/OS and OS/390 Version 3 (Program Number 5655-H31) v Enterprise PL/I for z/OS Version 4 (Program Number 5655-W67) v Enterprise PL/I for z/OS Version 5 Release 1 and 2 (Program Number 5655-PL5) This edition also applies to all subsequent releases and modifications until otherwise indicated in new editions or technical newsletters. You can access publications online at www.ibm.com/e-business/linkweb/publications/servlet/pbi.wss You can find out more about IBM z/OS Debugger by visiting the following IBM Web sites: v IBM Debug for z Systems: https://www.ibm.com/us-en/marketplace/debug-for-z-systems v IBM Developer for z Systems: https://www.ibm.com/us-en/marketplace/developer-for-z-systems v IBM Z Open Development: https://www.ibm.com/us-en/marketplace/z-open-development v IBM Z Open Unit Test: https://www.ibm.com/us-en/marketplace/z-open-unit-test © Copyright IBM Corporation 1992, 2019. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents About this document ........ xiii IBM z/OS Debugger Utilities: z/OS Debugger Who might use this document ........ xiii JCL Wizard ............. 10 Accessing z/OS licensed documents on the Internet xiii Starting IBM z/OS Debugger Utilities .... 10 How this document is organized ....... xiv Terms used in this document ........ xvii Chapter 2. Debugging a program in How to read syntax diagrams ....... xviii full-screen mode: introduction .... 11 Symbols .............. xviii Compiling or assembling your program with the Syntax items ............. xix proper compiler options .......... 11 Syntax examples ........... xix Starting z/OS Debugger .......... 12 How to send your comments ........ xx The z/OS Debugger full screen interface .... 13 Stepping through a program......... 14 Summary of changes........ xxiii Running your program to a specific line..... 14 Setting a breakpoint ........... 15 IBM z/OS Debugger as a component xxix Displaying the value of a variable ....... 15 Displaying memory through the Memory window 17 Changing the value of a variable ....... 17 Part 1. Getting started with z/OS Skipping a breakpoint ........... 18 Debugger ............. 1 Clearing a breakpoint ........... 18 Recording and replaying statements ...... 18 Chapter 1. z/OS Debugger: overview .. 3 Stopping z/OS Debugger.......... 19 z/OS Debugger interfaces .......... 4 Batch mode.............. 5 Part 2. Preparing your program for Full-screen mode ............ 5 debugging ............ 21 Full-screen mode using the Terminal Interface Manager............... 5 Remote debug mode........... 6 Chapter 3. Preparing to remote debug IBM z/OS Debugger Utilities ......... 7 in standard mode .......... 23 IBM z/OS Debugger Utilities: Job Card .... 7 IBM z/OS Debugger Utilities: Program Chapter 4. Planning your debug Preparation .............. 7 session .............. 25 IBM z/OS Debugger Utilities: z/OS Debugger Choosing compiler options for debugging .... 26 Setup File .............. 8 Choosing TEST or NOTEST compiler suboptions IBM z/OS Debugger Utilities: IMS TM Debugging 8 for COBOL programs .......... 27 IBM z/OS Debugger Utilities: Load Module Choosing TEST or NOTEST compiler suboptions Analyzer............... 8 for PL/I programs ........... 35 IBM z/OS Debugger Utilities: z/OS Debugger Choosing TEST or DEBUG compiler suboptions User Exit Data Set ........... 8 for C programs ............ 41 IBM z/OS Debugger Utilities: Other IBM Choosing TEST or DEBUG compiler suboptions Application Delivery Foundation for z Systems for C++ programs ........... 46 tools ................ 8 Understanding how hooks work and why you IBM z/OS Debugger Utilities: JCL for Batch need them .............. 50 Debugging .............. 8 Understanding what symbol tables do and why IBM z/OS Debugger Utilities: IMS BTS Debugging 9 saving them elsewhere can make your IBM z/OS Debugger Utilities: JCL to Setup File application smaller ........... 51 Conversion .............. 9 Choosing a debugging mode ........ 52 IBM z/OS Debugger Utilities: Delay Debug Profile 9 Debugging in browse mode ........ 54 IBM z/OS Debugger Utilities: IMS Transaction Choosing a method or methods for starting z/OS and User ID Cross Reference Table ...... 9 Debugger ............... 57 IBM z/OS Debugger Utilities: Non-CICS Debug Choosing how to debug old COBOL programs .. 60 Session Start and Stop Message Viewer .... 9 Creating deferred breakpoints for COBOL and PL/I IBM z/OS Debugger Utilities: z/OS Debugger programs ............... 61 Code Coverage ............ 9 IBM z/OS Debugger Utilities: z/OS Debugger Deferred Breakpoints .......... 9 © Copyright IBM Corp. 1992, 2019 iii Chapter 5. Updating your processes so Creating and storing debugging profiles with you can debug programs with z/OS CADP ................ 101 Debugger ............. 63 Starting z/OS Debugger for non-Language Environment programs under CICS ...... 102 Update your compilation, assembly, and linking Passing runtime parameters to z/OS Debugger process ................ 63 for non-Language Environment programs under Compiling your program without using IBM CICS ............... 102 z/OS Debugger Utilities ......... 63 Compiling your program by using IBM z/OS Debugger Utilities ........... 65 Chapter 11. Preparing an IMS program 105 Compiling a Enterprise PL/I program on an HFS Starting z/OS Debugger under IMS by using or zFS file system ........... 66 CEEUOPT or CEEROPT .......... 105 Compiling your C program with c89 or c++ .. 67 Managing runtime options for IMSplex users by Compiling a C program on an HFS or zFS file using IBM z/OS Debugger Utilities ...... 106 system ............... 67 Setting up the DFSBXITA user exit routine ... 106 Compiling a C++ program on an HFS or zFS file system ............... 68 Chapter 12. Specifying the TEST Update your library and promotion process ... 68 runtime options through the Make the modifications necessary to implement Language Environment user exit ... 109 your preferred method of starting z/OS Debugger . 69 Editing the source code of CEEBXITA ..... 110 Modifying the naming pattern....... 110 Chapter 6. Preparing a LangX COBOL Modifying the message display level .... 111 program .............. 73 Modifying the call back routine registration .. 112 Compiling your OS/VS COBOL program .... 73 Activate the cross reference function and Compiling your VS COBOL II program ..... 74 modifying the cross reference table data set Compiling your Enterprise COBOL program ... 74 name ............... 112 Creating the EQALANGX file for LangX COBOL Comparing the two methods of linking CEEBXITA 112 programs ............... 74 Linking the CEEBXITA user exit into your Link-editing your program ......... 76 application program ........... 113 Linking the CEEBXITA user exit into a private copy Chapter 7. Preparing an assembler of a Language Environment runtime module ... 113 program .............. 77 Creating and managing the TEST runtime options data set ............... 114 Before you assemble your program ...... 77 Creating and managing the TEST runtime Assembling your program ......... 77 options data set by using Terminal Interface Creating the EQALANGX file for an assembler Manager (TIM) ............ 115 program ............... 78 Creating and managing the TEST runtime Assembling your program and creating options data set by using IBM z/OS Debugger EQALANGX .............. 79 Utilities .............. 117 Link-editing your program ......... 80 Restrictions for link-editing your assembler program .............. 80 Part 3. Starting z/OS Debugger 119 Chapter 8. Preparing a DB2 program 81 Chapter 13. Writing the TEST run-time Processing SQL statements ......... 81 option string............ 121 Linking DB2 programs for debugging ..... 83 Special considerations while using the TEST Binding DB2 programs for debugging ..... 84 run-time option ............ 121 Defining TEST suboptions in your program .. 121 Chapter 9. Preparing a DB2 stored Suboptions and NOTEST ........ 121 procedures program ......... 85 Implicit breakpoints .......... 122 Primary commands file and USE file .... 122 Chapter 10. Preparing a CICS program 89 Running in batch mode ......... 122 Starting z/OS Debugger at different points .. 122 Link-editing EQADCCXT into your program ... 89 Session log ............. 123 Creating and storing a DTCN profile ...... 90 Precedence of Language Environment runtime Displaying a list of active DTCN profiles and options ..............