Sets the behavior of the putenv() function. When
the value of_EDC_PUTENV_COPY is set to YES,
the putenv() string is copied into storage owned
by Language Environment. When the value of _EDC_PUTENV_COPY is not set,
or set to a value other than YES, then the putenv() string
is placed directly into the environment, so altering the string will
change the environment..
The
_EDC_PUTENV_COPY environment variable can
be set with the function
setenv("_EDC_PUTENV_COPY","YES", 1);
Notes: - Changes to z/OS specific environment variables beginning with _BPXK_, _CEE_ or _EDC_ may
not be processed if the environment variable is updated directly rather
than by using setenv() or putenv().
Results are unpredictable if these type of environment variables are
updated directly.
- For ASCII applications, the users string will be placed into the
environment. However, updates should only be made with setenv() or
putenv(). Results are unpredictable if the environment variable is
updated directly.
- If the user manually changes the environment, storage associated
with the original environment may never be freed.
- The __putenv_la() function will always make a
copy of the user string and perform as though _EDC_PUTENV_COPY=YES were
specified.
- _EDC_PUTENV_COPY may be updated during the life
of the application by setenv(), putenv()
or clearenv(). This will affect the behavior of any
subsequent call to putenv(), however it will not
change the state of existing environment variables. putenv() may
be used to update _EDC_PUTENV_COPY. The behavior
requested will not take effect until the next putenv() call.