Native Inspect Manual (H06.07+)

Syntax of Native Inspect Commands
Native Inspect Manual—528122-006
4-34
frame command, select-frame command
frame command, select-frame command
Selects a stack frame and prints information about the selected stack frame. The
selected stack frame becomes the frame relative to which program state is displayed.
The select-frame command, the “silent” version of the frame command, does not print
out information about the selected frame.
Alias: f
number
is the number of the frame you want to select. To display frame numbers, use the
bt command. The frame at which execution is currently halted is numbered 0, and
frame numbers continue consecutively to the base frame from which execution
began.
If you do not include any arguments, the frame command displays information
about the current stack frame, which can be useful for determining your current
program location.
Considerations
The currently selected frame (specified in the frame command) is distinguished from
the current program location (the frame at which execution is suspended):
•
Most Native Inspect commands operate on the currently selected frame.
•
Execution-control commands, such as step and next, operate on the current
program location.
•
For COBOL programs, the CALL stack records the history of active program unit
invocations. By default, Native Inspect shows the program state relative to the
most recently invoked program unit.
•
You can use the frame command to view program state relative to some other
frame.
Examples
To display the current frame:
[ frame | select-frame ] [ number ]
Note. PERFORM invocations are not listed on the CALL stack.
(eInspect 6,679): frame
#0 test_complexTypes() () at \SYS04.$D0117.SYMBAT1.SCXXTST:424
424 printf( "%s test_complexTypes\n", getStepPrefix( 1 ) );