Creating Preinitialized Environments for Authorized Programs

You can initialize environments with a call using the CELAAUTH macro. On this call, you can specify the characteristics of the environments you want to create, including the management characteristics, runtime options, and the number of environments. Environment initialization can only be performed in the home address space in TCB or SRB mode.

Restriction: Cross-memory mode initialization is not allowed.

Preinitialized Environments for Authorized Programs are based on the AMODE 64 version of Language Environment and have the following characteristics:
  • The linkage model is XPLINK.
  • The storage for the stack, user heap, and most Language Environment control blocks is allocated above the bar.
  • Only AMODE 64 runtime options are valid.
In order for authorized applications to use this support, it is required that they define SCEERUN2 and SCEERUN as authorized libraries. These libraries are part of the z/OS® program search order for the address space's cross-memory resource owning (CMRO) task. You can do this in one of the following ways:
  • Put SCEERUN2 and SCEERUN in the LNKLST.
  • Define SCEERUN2 and SCEERUN to be APF-authorized, and placing them in the application's TASKLIB or STEPLIB/JOBLIB concatenation.

Preinitialized Environments for Authorized Programs supports a subset of the C/C++ library functions. For a list of these functions, see z/OS XL C/C++ Runtime Library Reference.

Parent topic: Preinitialized Environments for Authorized Programs for AMODE 64 applications