Displays information for each generation in the program caller
hierarchy.
.-*--------------.
>>-CALlers--+--------+--+----------------+---------------------><
'-window-' | .-;----------. |
| V | |
'---generation-+-'
- window
- A LSM Information window.
Select by a Window Specification, or by
placing the cursor in the window.
If supplied, the window must be an LSM Information window.
If omitted, and the cursor is not in an
LSM Information window, uses the first LSM Information window.
If no LSM Information window is open, one is opened.
- *
- Information is shown for all caller generations,
beginning with the current location and followed by all previous
generations along the save area chain until either:
- the save area back link is zero
- the save area back link contains an invalid address
- the generation specified by the SALIMIT command is reached
- generation
- A program caller generation.
The program caller generations numbering convention is:
- 0
- Current program
- 1
- Parent (caller)
- 2
- Grandparent (caller of caller), and so on
When supplied,
information is displayed for only the nominated caller generations.
The information displayed for each generation
in the program caller hierarchy
includes:
- Current execution location, as:
- Memory location, in IDF symbolic format
(module.CSECT)Stmt#nnnnn+offset
- Logical location
program-block-name+offset
This location is only provided when extract data was loaded,
for the program. Extra information may also be
used from data areas in the program's storage.
- Save Area Header
- Save Area register values, if applicable
Use the SAREGS command to enable and
disable the display of the Save
Area header and registers in the CALLERS display.
The Save Area registers are formatted according to the IDF ROWSTYLE
option setting.
Use the SALIMIT command to control the maximum depth of the
CALLERS display.
This is intended to prevent problems when the program call chain is
damaged, or is of unexpected depth (due to runaway recursion).
The calling hierarchy information display persists until:
- A CALLERS command without arguments is issued when the current Call
Hierarchy command has no arguments.
- The window is closed with a CLOSE command.
- Another IDF Language command such as VARIABLE, STRUCTURE, ARRAY,
TYPE, PLOCATES, LANGUAGE STATUS,
or MAP is issued, which directs IDF to
update the LSM Information window with new information.
- The target program completes execution.
Examples
CALLERS
CALLERS 0;99