__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.