Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (H-K)

Guardian Procedure Calls Reference Manual—522629-013

7-27

HIST_GETPRIOR_ Procedure

Summary

Syntax for C Programmers

Syntax for TAL Programmers

Parameters

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. See the

HIST_INIT_ procedure for an overview of how HIST_INIT_, HIST_FORMAT_, and

HIST_GETPRIOR_ can be used together to perform stack tracing. This procedure

displays RISC register contents for TNS/R code and IPF register contents for TNS/E

code.

Syntax for C Programmers

Syntax for TAL Programmers

Parameters

error returned value

INT

indicates the outcome of the operation:

0HIST_OK

The procedure executed successfully.

1 HIST_DONE

The procedure has reached the base of the stack trace.

-8 HIST_ERROR

The stack tracing mechanism failed.

-9 HIST_BAD_WORKSPACE

#include <histry.h>

short HIST_GETPRIOR_ ( NSK_histWorkspace *workspace );

?SOURCE $SYSTEM.SYSTEM.HHISTRY

error := HIST_GETPRIOR_ ( workspace ); ! i,o