IBM z/OS Debugger Version 14.2.1 Reference and Messages IBM SC27-9582-01 Note! Before using this information and the product it supports, be sure to read the general information under “Notices” on page 527. Second Edition (December 2019) This edition applies to IBM® z/OS® Debugger, Version 14.2.1 (Program Number 5724-T07 with the PTF for PH17417), which supports the following compilers: • AD/Cycle C/370 Version 1 Release 2 (Program Number 5688-216) • C/C++ for MVS/ESA Version 3 (Program Number 5655-121) • C/C++ feature of OS/390® (Program Number 5647-A01) • C/C++ feature of z/OS Version 1 (Program Number 5694-A01) • C/C++ feature of z/OS Version 2 (Program Number 5650-ZOS) • OS/VS COBOL, Version 1 Release 2.4 (5740-CB1) - with limitations • VS COBOL II Version 1 Release 3 and Version 1 Release 4 (Program Numbers 5668-958, 5688-023) - with limitations • COBOL/370 Version 1 Release 1 (Program Number 5688-197) • COBOL for MVS™ & VM Version 1 Release 2 (Program Number 5688-197) • COBOL for OS/390 & VM Version 2 (Program Number 5648-A25) • Enterprise COBOL for z/OS and OS/390 Version 3 (Program Number 5655-G53) • Enterprise COBOL for z/OS Version 4 (Program Number 5655-S71) • Enterprise COBOL for z/OS Version 5 (Program Number 5655-W32) • Enterprise COBOL for z/OS Version 6 Release 1, Release 2, and Release 3 (Program Number 5655-EC6) • High Level Assembler for MVS & VM & VSE Version 1 Release 4, Version 1 Release 5, Version 1 Release 6 (Program Number 5696-234) • OS PL/I Version 2 Release 1, Version 2 Release 2, Version 2 Release 3 (Program Numbers 5668-909, 5668-910) - with limitations • PL/I for MVS & VM Version 1 Release 1 (Program Number 5688-235) • VisualAge® PL/I for OS/390 Version 2 Release 2 (Program Number 5655-B22) • Enterprise PL/I for z/OS and OS/390 Version 3 (Program Number 5655-H31) • Enterprise PL/I for z/OS Version 4 (Program Number 5655-W67) • Enterprise PL/I for z/OS Version 5 Release 1, Release 2, and Release 3 (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: • IBM Debug for z/OS: https://www.ibm.com/us-en/marketplace/debug-for-z-systems • IBM Developer for z/OS: https://www.ibm.com/us-en/marketplace/developer-for-z-systems • IBM Z Open Development: https://www.ibm.com/us-en/marketplace/z-open-development • IBM Z Open Unit Test: https://www.ibm.com/us-en/marketplace/z-open-unit-test © Copyright International Business Machines 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.............................................................................................xi Who might use this document.................................................................................................................... xi Accessing z/OS licensed documents on the Internet................................................................................ xi How this document is organized................................................................................................................xii Terms used in this document.....................................................................................................................xii How to read syntax diagrams....................................................................................................................xiv Symbols................................................................................................................................................ xiv Syntax items.........................................................................................................................................xiv Syntax examples................................................................................................................................... xv How to provide your comments................................................................................................................ xvi Summary of changes..........................................................................................xvii IBM z/OS Debugger as a component.................................................................... xix Chapter 1. z/OS Debugger runtime options.............................................................1 Non-Language Environment positional parameter.....................................................................................1 COUNTRY runtime option............................................................................................................................ 2 NATLANG runtime option............................................................................................................................ 2 NONLESP runtime option.............................................................................................................................2 TEST runtime option.................................................................................................................................... 3 Syntax of the TEST runtime option........................................................................................................ 3 TRAP runtime option....................................................................................................................................9 Chapter 2. Common syntax elements in z/OS Debugger commands.......................11 address.......................................................................................................................................................11 block_name................................................................................................................................................11 block_spec................................................................................................................................................. 12 condition.................................................................................................................................................... 12 compile_unit_name...................................................................................................................................13 cu_spec...................................................................................................................................................... 14 expression..................................................................................................................................................14 load_module_name...................................................................................................................................15 load_spec...................................................................................................................................................15 offset_spec.................................................................................................................................................15 references.................................................................................................................................................. 16 statement_id..............................................................................................................................................16 statement_id_range and stmt_id_spec....................................................................................................17 Specifying a range of statements........................................................................................................ 17 statement_label.........................................................................................................................................18 variable_name........................................................................................................................................... 18 Chapter 3. Syntax for assembler and disassembly expressions............................. 19 Common syntax elements.........................................................................................................................19 Operators................................................................................................................................................... 20 Operators that can be used in any expression.................................................................................... 20 Operators that can be used only in conditional expressions..............................................................22 Arithmetic expression evaluation..............................................................................................................22 iii Chapter 4. Syntax for LangX COBOL expressions.................................................. 23 Restrictions on LangX COBOL expressions...............................................................................................23 Common syntax elements.........................................................................................................................24 Operators................................................................................................................................................... 24 Operators that can be used in any expression...................................................................................