Guardian Programming Reference Summary for pTAL and TAL

Procedure Calls Summary (G-N)
Guardian Programming Reference Summary for pTAL and TAL—522631-001
6-13
HIST_INIT_
Initializes a process history display or stack trace. It validates a parameter and
establishes the context to display and from which to begin tracing. HIST_INIT_ is used
with the HIST_FORMAT_ and HIST_GETPRIOR_ procedures to provide the ability to
display process state, including register contents and procedure activation history or
stack traces.
0HIST_OK
The procedure executed successfully.
-8 HIST_ERROR
The stack tracing mechanism failed.
-9 HIST_BAD_WORKSPACE
The workspace structure has an invalid version identifier. This error can occur if
HIST_GETPRIOR_ is called without first calling the HIST_INIT_ procedure or if the
workspace structure has become corrupted.
workspace, INT .EXT:ref:(HIST_WORKSPACE_TEMPLATE) input, output
?SOURCE $SYSTEM.SYSTEM.HHISTRY
error := HIST_INIT_ ( workspace
,version
,options
,context );
error, INT returned value
0HIST_OK
The procedure terminated normally.
-3 HIST_BAD_VERSION
An invalid value was specified for the version parameter.
-4 HIST_BAD_OPTION
An invalid value was specified for the options parameter. An undefined bit was set.
-5 HIST_BAD_CONTEXT
A null value was specified for the context parameter. The context parameter
must contain an address.
-6 HIST_NOT_IMPLEMENTED
A specified options bit is defined but not implemented.