__xhotl() — Set Up a Persistent C Environment (With Library)
Purpose
The function creates a persistent C environment that will use the
dynamic z/OS® XL C/C++ library functions. All library facilities are available
in this environment except:
- The RENT compiler option is not supported in the persistent environment described in this topic.
- Exception handling is not supported in persistent C environments.
For an extensive example of the use of __xhotl(), see Creating and using persistent C environments.
Format
#include <spc.h>
void *__xhotl(void *handle, int stack, int location);
The following parameters are fullwords (four bytes):
- handle
- the field for the token (or handle) which is returned
- stack
- the initial stack allocation required for the environment
- location
- location of the stack:
- 0
- Below the line
- 1
- Anywhere
Returned value
This routine 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.