HP 3000 Manuals HP 3000 Manuals
STACK DUMP FACILITY
The stack dump facility is composed of two complementary, independent
features:
* A callable intrinsic (STACKDUMP) that enables any program to
selectively dump any part of the stack to the standard list device or
other file. This debugging aid provides a simple method that allows
the user to dynamically monitor any or all variables in a program.
* A mechanism (abort stack analysis) that can be enabled or disabled by
commands or intrinsics. This facility causes the following special
actions when the program aborts:
For a batch job, parts or all of the stack are dumped on the
standard list device.
For an interactive session, an automatic call to DEBUG is
generated.
The abort stack analysis mechanism can be enabled, in a batch job
or an interactive session, in three ways:
1. With the :SETDUMP command. (The :RESETDUMP command disables
the mechanism.)
2. With the SETDUMP intrinsic. (The RESETDUMP intrinsic disables
the mechanism.)
3. By specifying the DEBUG parameter of the CREATE intrinsic.
The stack dump facility provides the following features:
* Makes it simple for a user to obtain information necessary to
determine the cause of an abort.
* Allows the information to be formatted in a way that is clear to
read.
* Provides a means of limiting the amount of output in those cases
where the entire stack does not need to be dumped.
See Section IV for a description of how to use the stack dump facility.