Every function of an application is allocated space in the stack.
This space is referred to as a stack frame, or dynamic storage area (DSA). ddpi_stackstate operations
create, format, and terminate objects in order to read and write stack-frame
information. Ddpi_StackState objects store different elements
of the stack frame.
Description
The CDA library provides three types of APIs to manage stack
frame information:
- Ddpi_StackState APIs
- The ddpi_stackstate operations:
- Create Ddpi_StackState objects to contain different elements
of the stack frame.
- Use the Ddpi_Stackstate_Fn object when they call a program
analysis application (user-supplied) stack-state handler function to load
the stack-state information.
- Use the program analysis application stack-state handler functions to
load the information. Stack-state handler functions identify the stack type
and extract stack-state information.
- Ddpi_Stackstate_Fn APIs
- The ddpi_stackstate_fn operations:
- Create the Ddpi_Stackstate_Fn object.
- Register the stack-state handler functions that are available in the program
analysis application by adding them to the Ddpi_Stackstate_Fn object.
- Standard stack state-handler APIs for Language Environment
- Stack-state handlers collect stack-frame information as they walk the
stack, and load it into the Ddpi_StackState objects. The
CDA library provides two operations that read the stack frames that conform
to Language Environment. You can use these operations as prototypes to create
other stack-state handling functions.
Note: For more information about z/OS stack frames, see z/OS
Language Environment Vendor Interfaces, SA22-7568.