Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (H-K)

Guardian Procedure Calls Reference Manual—522629-013

7-11

HIST_FORMAT_ Procedure

Summary

Syntax for C Programmers

Syntax for TAL Programmers

Parameters

Considerations

Example Code

Example Traces: Case 1

Example Traces: Case 2

Example Traces: Case 3

Example Traces: Case 4

Summary

The HIST_FORMAT_ procedure produces an ASCII text representation of the process

state whose context is established by a previous call to the HIST_INIT_ procedure or

HIST_GETPRIOR_ procedure. 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 TNS/E code.

Syntax for C Programmers

Syntax for TAL Programmers

Parameters

ret-val returned value

INT

if the procedure is successful, returns the length of the output text in bytes or zero

(0) if there is no more text for the current context. If the procedure is unsuccessful,

ret-val contains a negative value as follows:

#include <histry.h>

short HIST_FORMAT_ ( NSK_histWorkspace *workspace

,char *text

,const uint16 limit );

?SOURCE $SYSTEM.SYSTEM.HHISTRY

ret-val := HIST_FORMAT_ ( workspace !i,o

,text !o

,limit ); !i