Guardian Procedure Calls Reference Manual

HIST_GETPRIOR_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameter
Returned Value
Considerations
Example
Summary
The HIST_GETPRIOR_ procedure establishes a previous procedure call as the process context for
display by the next HIST_FORMAT_ procedure call.
For an overview of how HIST_INIT_, HIST_FORMAT_, and HIST_GETPRIOR_ can be used together
to perform stack tracing, see the HIST_INIT_ Procedure (page 716). This procedure displays RISC
register contents for TNS/R code and IPF register contents for TNS/E code.
Syntax for C Programmers
#include <histry.h>
short HIST_GETPRIOR_ ( NSK_histWorkspace *workspace );
Syntax for TAL Programmers
?SOURCE $SYSTEM.SYSTEM.HHISTRY
error := HIST_GETPRIOR_ ( workspace ); ! i,o
Parameter
workspace
input, output
INT .EXT:ref:(HISTWORKSPACE_TEMPLATE)
identifies the context and format of the process state to be displayed by the next HIST_FORMAT_
procedure call. On input, it must have already been initialized by a previous call to the
HIST_INIT_ procedure and might have been modified by previous calls to HIST_GETPRIOR_.
On output, it identifies the previous unsuppressed context. See Considerations.
Returned Value
INT
Outcome of the call:
HIST_OK0
The procedure executed successfully.
HIST_DONE1
The procedure has reached the base of the stack trace.
HIST_BAD_VERSION-3
HIST_GETPRIOR_ is called without first calling the HIST_INIT_ procedure.
714 Guardian Procedure Calls (H-K)