Guardian Programming Reference Summary for pTAL and TAL

Procedure Calls Summary (G-N)
Guardian Programming Reference Summary for pTAL and TAL—522631-001
6-12
HIST_FORMAT_
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.
HIST_GETPRIOR_
Establishes a previous procedure call as the process context for display by the next
HIST_FORMAT_ procedure call.
?SOURCE $SYSTEM.SYSTEM.HHISTRY
ret-val := HIST_FORMAT_ ( workspace
,text
,limit );
ret-val, INT returned value
-2 HIST_BAD_WIDTH
The value of the limit parameter is less than the minimum width for output defined
by the Hist_MinWidth literal in the HHISTRY header file.
-9 HIST_BAD_WORKSPACE
The workspace structure has an invalid version identifier. This error can occur if
HIST_FORMAT_ is called without first calling the HIST_INIT_ procedure or if the
workspace structure has become corrupted.
-10 HIST_BAD_FORMAT_CALL
Nothing to format. This error can occur if you call HIST_FORMAT_ again after a
previous call returned zero indicating no more text for the current context.
workspace, INT .EXT:ref:(HIST_WORKSPACE_TEMPLATE) input, output
text, STRING .EXT:ref:* output
limit, INT:value input
?SOURCE $SYSTEM.SYSTEM.HHISTRY
error := HIST_GETPRIOR_ ( workspace );
error, INT returned value