Customizing IBM z/OS Debugger Utilities

Note: This chapter is not applicable to IBM® Developer z/OS® (non-Enterprise Edition) or IBM Z and Cloud Modernization Stack (Wazi Code).

IBM z/OS Debugger Utilities is a group of ISPF applications that provide the following tools and functions:

  • Program Preparation to help application programmers precompile, compile, and link their programs and then start z/OS Debugger. This includes using COBOL and CICS® Command Level Conversion Aid (CCCA) to help application programmers convert older COBOL programs to Enterprise COBOL programs.
  • z/OS Debugger Setup File, which manages setup files. Setup files help application programmers prepare programs to debug them interactively or in batch mode.
  • IMS TM Debugging to help users edit the TEST runtime options that IMS programs use and to create private message regions for testing.

    The functions include the IMS Transaction Isolation facility, which allows users to select IMS transactions to debug in a private message-processing region.

  • z/OS Debugger User Exit Data Set to create and edit a data set that Language Environment user exits read to obtain the TEST runtime options string.
  • Other IBM Application Delivery Foundation for z/OS tools to help users start IBM File Manager for z/OS.
  • JCL for Batch Debugging to help users start a debug session when they run their application in a batch job.
  • IMS BTS Debugging to help users start a debug session when they run their IMS BTS applications.
  • Delay Debug Profile to create a delay debug profile data set that the z/OS Debugger delay debug pattern matching uses to start a debug session.
  • IMS Transaction and User ID Cross Reference Table to create a cross reference table entry that z/OS Debugger uses to associate a user ID to an IMS transaction.
  • Non-CICS Debug Session Start and Stop Message Viewer to browse debug session start and stop messages.
  • z/OS Debugger Code Coverage to specify code coverage options, observation selections, and do viewing and reporting.
  • z/OS Debugger Deferred Breakpoints to create and view a list of breakpoints prior to starting the debug session. It reduces the time spent on the debugging session and also the system resource usage.
  • z/OS Debugger JCL Wizard is an ISPF edit macro (EQAJCL) that allows you to modify a JCL or procedure member and create statements to invoke z/OS Debugger in various environments.

The instructions in this section describe the following customization tasks:

  • Choose a method to start IBM z/OS Debugger Utilities
  • Customize the data set names in EQASTART.
  • Add IBM z/OS Debugger Utilities to an ISPF menu so that your users can start IBM z/OS Debugger Utilities from an ISPF menu.
  • Modify z/OS Debugger Setup Utility so that your users can access procedure libraries.
  • Customize the JCL for Batch Debugging interface.
  • Customize the Other IBM Application Delivery Foundation for z/OS tools interface.
  • Customize Program Preparation so that users access the proper compilers and development utilities.
  • If your users use the IMS TM Setup - Manage LE Runtime Options function in IBM z/OS Debugger Utilities, make changes so that users can access this function in an IMSplex environment.
  • Customize IMS BTS Debugging with default values for the TEST runtime option and data set names for the z/OS Debugger load module, user exit module, debug information files, IMS subsystem IDs, and base JCLs.
  • Customize the z/OS Debugger User Exit Data Set utility.
  • Customize the Delay Debug Profile utility.
  • Customize the IMS Transaction and User ID Cross Reference Table utility.
  • Customize the Non-CICS Debug Session Start and Stop Message Viewer utility.
  • Customize z/OS Debugger Code Coverage.
  • Install and customize z/OS Debugger JCL Wizard.