Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (W-Z)
Guardian Procedure Calls Reference Manual—522629-013
16-43
XSTACKTEST Procedure
(Superseded by HEADROOM_ENSURE_
XSTACKTEST Procedure
(Superseded by HEADROOM_ENSURE_
Procedure )
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Considerations
Summary
XSTACKTEST, used with LASTADDRX and XBNDSTEST checks stack limits.
XSTACKTEST ensures that adequate stack space is available and returns a set of
constants to be used with the XBNDSTEST procedure.
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
status returned value
INT
returns one of the following file-system error numbers:
0 Adequate stack space available
2 Undefined
flags value
21
stackwords is less than 1
22 Bounds error on
firstparm or constants
Note. This procedure cannot be called by native processes. Although this procedure is
supported for TNS processes, it should not be used for new development.
#include <cextdecs(XSTACKTEST)>
short XSTACKTEST ( short _near *firstparam
,short stackwords
,short flags
,long long *constants );
status := XSTACKTEST ( firstparm ! i
,stackwords ! i
,flags ! i
,constants ); ! o