__xhotc() — Set Up a Persistent C Environment (No Library)
Purpose
The function creates a persistent C environment that does not require the dynamic library facilities of z/OS® Language Environment® at run time.
For an extensive example of the use of __xhotc(), see Creating and using persistent C environments.
Format
#include <spc.h>
void *__xhotc(void *handle, int stack, int location);
The parameters are fullwords (four bytes).
- handle
- the field for the token (or handle) which is returned
- stack
- initial stack allocation required for the environment
- location
- location of the stack:
- 0
- Below the line
- 1
- Above the line
Returned value
__xhotc() returns a token (or handle) which is used in subsequent calls to __xhotu() and __xhott() to use or terminate a persistent C environment. This handle is found in both the first parameter passed and R15.
The RENT compiler option is not supported for routines called using this environment.