CALLERS

Returns information for each generation in the program caller hierarchy, including:

• Current execution location, as:
  • Memory location, in IDF symbolic format

        (module.CSECT)Stmt#nnnnn+offset

  • Logical location

        program-block-name+offset

• Save Area Header
• Save Area register values, if applicable

*

Return information for all caller generations.

program-caller-generation

A caller generation.

The program caller generations numbering convention is:

0

Current program

1

Parent (caller)

2

Grandparent (caller of caller), and so on

The SAREGS command (see SAREGS) is used to enable or disable the return of the Save Area header and registers in the CALLERS data. The Save Area registers are formatted according to the ROWSTYLE option setting.

The SALIMIT command (see SALIMIT) controls the maximum depth of the CALLERS data. This is intended to prevent problems when the program call chain is damaged, or is of unexpected depth (due to runaway recursion).

The name of the stemmed variable array defaults to LSM. and is set by the LANGUAGE STEM command (see LANGUAGE STEM).

The EXLIMIT command (see EXLIMIT) controls the maximum stemmed array index value.