CALLERS

Edit online
Displays information for each generation in the program caller hierarchy.

Read syntax diagramSkip visual syntax diagramCALlerswindow*;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