IBM z/OS Debugger Version 14.2.1 Customization Guide IBM SC27-9583-01 Note! Before using this information and the product it supports, be sure to read the general information under “Notices” on page 195. 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.............................................................................................ix Who might use this document.................................................................................................................... ix Accessing z/OS licensed documents on the Internet................................................................................ ix How this document is organized..................................................................................................................x Terms used in this document.......................................................................................................................x How to read syntax diagrams.....................................................................................................................xii Symbols.................................................................................................................................................xii Syntax items..........................................................................................................................................xii Syntax examples.................................................................................................................................. xiii How to provide your comments................................................................................................................ xiv Summary of changes............................................................................................xv IBM z/OS Debugger as a component................................................................... xvii Chapter 1. Customizing z/OS Debugger: checklist.................................................. 1 Chapter 2. Product Registration............................................................................. 7 Registering z/OS Debugger..........................................................................................................................7 Removing old registrations..........................................................................................................................8 Chapter 3. Installing the z/OS Debugger SVCs...................................................... 11 Installing the SVCs without using a system IPL........................................................................................11 Verifying the installation of the SVCs........................................................................................................ 12 Checking the level of the z/OS Debugger SVCs................................................................................... 12 Running the installation verification programs for SVCs.......................................................................... 12 Using the Authorized Debug facility for protected programs................................................................... 13 Chapter 4. Setting up the APF-authorized system link list data set (SEQABMOD)... 15 Chapter 5. Setting up the link list data set (SEQAMOD)......................................... 17 Chapter 6. Enabling debugging in full-screen mode using the Terminal Interface Manager.......................................................................................................... 19 How users start a full-screen mode debug session with the Terminal Interface Manager.................... 19 Enabling full-screen mode using the Terminal Interface Manager..........................................................20 Defining the VTAM EQAMVnnn APPL definition statements...............................................................21 Defining the Terminal Interface Manager APPL definition statements.............................................. 22 Starting the Terminal Interface Manager............................................................................................ 23 Verifying the enablement of full-screen mode using the Terminal Interface Manager..................... 24 Example: Defining the VTAM EQAMVnnn and Terminal Interface Manager APPL definition statements when z/OS Debugger runs on four LPARs.........................................................................25 Chapter 7. Debug Manager (DBGMGR).................................................................. 27 Debug Manager configuration................................................................................................................... 27 PARMLIB changes................................................................................................................................ 27 PROCLIB changes.................................................................................................................................28 Network configuration..........................................................................................................................28 Debug Manager security definitions.................................................................................................... 29 iii Verifying the DBGMGR started task.....................................................................................................31 Running the installation verification programs for Debug Manager................................................... 31 Debug Manager configuration reference...................................................................................................31 Understanding Debug Manager........................................................................................................... 31 Setting up AT-TLS.................................................................................................................................32 Debug Manager authentication............................................................................................................39 TCP/IP considerations..........................................................................................................................39 WLM considerations............................................................................................................................. 41 Tuning considerations..........................................................................................................................41 Troubleshooting configuration problems............................................................................................ 43 Operator commands............................................................................................................................ 43 Chapter 8. Specifying the TEST runtime options through the Language Environment user exit......................................................................................47