HP 3000 Manuals HP 3000 Manuals
Chapter 4 HOW TO USE THE STACK DUMP FACILITY The commands and intrinsics that comprise the stack dump facility of DEBUG allow you to dump all or portions of your data stack, provide a trace and analysis of the stack, and in interactive mode, allow you to use DEBUG commands to trace and possibly correct errors. The STACKDUMP intrinsic allows you to dump the stack at any time and send the dump to a file. The SETDUMP intrinsic or command provides a stack dump or stack marker analysis automatically in case your program terminates abnormally (aborts). The operation of SETDUMP differs depending on whether the program is executed interactively or is part of a batch job. If the :SETDUMP command is entered during an interactive session or a program containing a SETDUMP intrinsic is executed interactively, the stack is not dumped. When the program aborts, you are given a trace of the stack markers and placed in DEBUG mode so that you can enter any of the DEBUG commands described in Section III. If :SETDUMP is entered as a batch command in a job or if a program containing the SETDUMP intrinsic is executed in a batch job, a trace of the stack markers is provided when the program terminates and, optionally, a dump is provided of all or portions of the stack. Unless specified otherwise, the STACKDUMP intrinsic provides a trace of the stack markers in addition to the stack dump. The :RESETDUMP command or RESETDUMP intrinsic can be used to cancel the effect of the :SETDUMP command or SETDUMP intrinsic, respectively.