Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (H-K)
Guardian Procedure Calls Reference Manual—522629-013
7-3
HEADROOM_ENSURE_ Procedure
FNUM is the integer returned from the call to FILE_OPEN_ or OPEN that opened the
particular communication line. HALTPOLL forces the immediate termination of an
outstanding nowait read operation within a point-to-point station, or it stops any polling
that is in progress within a multipoint station.
Related Programming Manuals
For programming information about the HALTPOLL procedure, refer to the data
communication manuals.
HEADROOM_ENSURE_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Considerations
Example
Summary
The HEADROOM_ENSURE_ procedure allows you to check that the current
stack has enough room for the needs of your process. The default value of 0D
indicates that the main stack can grow to 1 MB in the TNS/R enviroment and to 2
MB in the TNS/E environment. Note there are two stacks in the TNS/E
environment: the memory stack and the RSE backing store. For most processes,
the default value is adequate. This procedure can help you, for example, when
specifying parameters for the PROCESS_LAUNCH_ procedure.
Syntax for C Programmers
•
CEXTDECS (through the included file TNSINTH) defines 32-bit values as the
typedef __int32_t which for TNS and TNS/R compiles is defined as long and for
TNS/E compiles is defined as
int.
Note. This procedure can be called only from a native process. Its pTAL syntax is declared
only in the EXTDECS0 file.
#include <cextdecs(HEADROOM_ENSURE_)>
__int32_t HEADROOM_ENSURE_ ( __int32_t room );