Customizing Debug Tool Utilities

Debug Tool Utilities is a group of ISPF applications that provides the following tools and functions:

• Program Preparation to help application programmers precompile, compile, and link their programs and then start Debug Tool. This includes using COBOL and CICS® Command Level Conversion Aid (CCCA) to help application programmers convert older COBOL programs to Enterprise COBOL programs.
• Debug Tool Setup File, which manages setup files. Setup files help application programmers prepare programs to debug them interactively or in batch mode.
• Code Coverage to help application programmers conduct coverage tests on their programs.
• IMS TM Functions 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.

  These functions also allow users to manage IMS message region templates. Message region templates are superseded by the IMS Transaction Isolation facility, and will be removed in a future release of Debug Tool.

  
• Load Module Analyzer to help users analyze load modules to determine the language translator that was used to compile or assemble each CSECT in the load module.
• Debug Tool 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 Problem Determination 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 Debug Tool 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 Debug Tool 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.
• Debug Tool Code Coverage to specify code coverage options, observation selections, and do viewing and reporting.
• Debug Tool 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.
• Debug Tool JCL Wizard is an ISPF edit macro (EQAJCL) that allows you to modify a JCL or procedure member and create statements to invoke Debug Tool in various environments.

The instructions in this section describe the following customization tasks:

• Choose a method to start Debug Tool Utilities
• Customize the data set names in EQASTART.
• Add Debug Tool Utilities to an ISPF menu so that your users can start Debug Tool Utilities from an ISPF menu.
• Modify Debug Tool Setup Utility so that your users can access procedure libraries.
• Customize the JCL for Batch Debugging interface.
• Customize the Problem Determination Tools interface.
• Customize Program Preparation so that users access the proper compilers and development utilities.
• Make changes so that users can access Coverage Utility and provide any defaults for Coverage Utility.
• If your users use the IMS TM Setup - Manage LE Runtime Options function in Debug Tool 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 Debug Tool load module, user exit module, debug information files, IMS subsystem IDs, and base JCLs.
• Customize the Debug Tool 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 Debug Tool Code Coverage.
• Install and customize Debug Tool JCL Wizard.