This chapter describes the minimal steps required to prepare your programs for use with IBM Problem Determination Tools products. For more detailed information, refer to 'Part 2. Preparing your program for debugging' of the Debug Tool for z/OS User's Guide, 'Part 2. Fault Analyzer Installation and Administration' of the Fault Analyzer for z/OS User's Guide, or 'Appendix B. Creating side files using CAZLANGX' of the Application Performance Analyzer for z/OS User’s Guide.
The purpose of this chapter is to provide instructions for a single compile method for organizations that are using some combination of Debug Tool for z/OS, Fault Analyzer for z/OS, and Application Performance Analyzer for z/OS. If your enterprise is only using Debug Tool for z/OS, you can alternatively refer to 'Part 2. Preparing your program for debugging' of the Debug Tool for z/OS User's Guide. If your enterprise is only using Fault Analyzer for z/OS, alternatively refer to 'Part 2. Fault Analyzer Installation and Administration' of the Fault Analyzer for z/OS User's Guide. If your enterprise is only using Application Performance Analyzer for z/OS, alternatively refer to 'Appendix B. Creating side files using CAZLANGX' of the Application Performance Analyzer for z/OS User’s Guide.
Debug Tool for z/OS, Fault Analyzer for z/OS and Application Performance Analyzer for z/OS are designed to use load modules and other files produced by IBM compilers. You must compile your programs with certain compiler options so that they produce load modules and files that these products can use.
This chapter uses the term ’source information files’ to refer to the types of files that are used by Debug Tool for z/OS, Fault Analyzer for z/OS and Application Performance Analyzer for z/OS. The different kinds of source information files that are the subject of discussion in this chapter include:
Be aware that different compilers generate different kinds of source information files. If you use more than one compiler, you might have more than one type of source information library.
When you compile your programs with the compiler options described in this chapter, you can use the load modules and source information files created by the compilers as follows:
When a program is compiled with the right options, the module that is produced by the compiler can be debugged and a source information file, which contains program statements, can be produced. When you use Debug Tool for z/OS to debug a program, Debug Tool for z/OS uses the source information file to display the program source statements in the source window.
Depending on the source language and compiler used, either the load module, source information file, or DWARF file contains information about statements and variables, such as offsets and lengths, and contains information that allows the debugger to locate statements and variables in storage. If you do not compile with the correct compile options, debugging is limited to something called ’disassembly’ mode, where machine code is displayed, but no source statements or variables.
[ Top of Page | Previous Page | Next Page | Contents | Index ]