Abstract for Common Debug Architecture User's Guide

This information supports IBM® z/OS® (5650-ZOS) and contains information about z/OS Run-Time Library Extensions.

Purpose of this information
This information introduces the user to Common Debug Architecture (CDA). It provides the following information:
  • A high-level overview of CDA.
  • Explanations and examples that illustrate how to use the CDA libraries and utilities.
  • An example implementation, using the utilities that are shipped with CDA.
Note: Examples that illustrate the use of the libelf, libdwarf, and libddpi libraries are instructional examples, and do not attempt to minimize the runtime performance, conserve storage, or check for errors. The examples do not demonstrate all the uses of the libraries. Some examples are code fragments only, and cannot be compiled without additional code.
Who should read this information

This information is intended for programmers who will be developing program analysis applications and debugging applications for the IBM XL C/C++ compiler or Enterprise COBOL compiler on the z/OS operating system. The libraries provided by CDA allow applications to create DWARF debugging information in ELF object file format. They also allow applications to query DWARF debugging information from ELF object files or GOFF program object files on the z/OS operating system.

How to use this information
It is assumed that you have a working knowledge of the following items:
  • The z/OS operating system
  • The libdwarf APIs
  • The libelf APIs
  • The ELF ABI
  • Writing debugging programs in C, C++, or COBOL on z/OS
  • The IBM z/OS Language Environment®
  • POSIX on z/OS
  • z/OS UNIX System Services shell
Terminology used in this information
This document uses the following terminology:
ABI
Application binary interface. A standard interface by which an application gains access to system services, such as the operating-system kernel. The ABI defines the API plus the machine language for a central processing unit (CPU) family. The ABI ensures runtime compatibility between application programs and computer systems that comply with the standard.
API
Application programming interface. An interface that allows an application program that is written in a high-level language to use specific data or functions of the operating system or another program. An extension to a standard DWARF API can include:
  • Extensions to standard DWARF files, objects, or operations
  • Additional objects or operations
object
In object-oriented design or programming, a concrete realization (instance) of a class that consists of data and the operations associated with that data. An object contains the instance data that is defined by the class, but the class owns the operations that are associated with the data. Objects described in this document are generally a type definition or data structure, a container for a callback function prototype, or items that have been added to a DWARF file.
operation
In object-oriented design or programming, a service that can be requested at the boundary of an object. Operations can modify an object or disclose information about an object.
Technical support

Additional technical support is available at z/OS XL C/C++ Support page. This page provides a portal with search capabilities to a large selection of technical support FAQs and other support documents.

For the latest information about z/OS XL C/C++, visit Marketplace page for z/OS XL C/C++

For information about boosting performance, productivity and portability, visit C/C++ Compilers for IBM Z - Community & Forum.

The latest information about Enterprise COBOL for z/OS is available at Marketplace page for Enterprise COBOL for z/OS and Enterprise COBOL for z/OS documentation library.

For the latest technical tips and information about Enterprise COBOL, visit COBOL Cafe community .

If you cannot find what you need, you can e-mail: compinfo@cn.ibm.com