Qp0zInitEnv()--Initialize Environment for Variables

#include <qp0z1170.h>

int Qp0zInitEnv(void);

The Qp0zInitEnv() function sets the external variable environ to a pointer to the current environment list. (On the AS/400 system, environ is initialized to NULL when an activation group is started.)

Note: Although it is possible for a user's program to directly read the environ array, use of the getenv() or Qp0zGetEnv() functions is recommended.

Parameters

None.

Return Value

0

Qp0zInitEnv() successfully initialized the environment.

-1

Qp0zInitEnv() was not successful. The errno variable is set to indicate the error.

Error Conditions

If Qp0zInitEnv() is not successful, errno indicates the following error.

[EUNKNOWN]

Unknown system state.

The operation failed because of an unknown system state. See any messages in the job log and correct any errors that are indicated, then retry the operation.

Related Information

• The <qp0z1170.h> file (see Header Files for UNIX-Type Functions)
• getenv()--Get Value of Environment Variable
• putenv()--Change or Add Environment Variable
• Qp0zDltEnv()--Delete an Environment Variable
• Qp0zDltSysEnv()--Delete a System-Level Environment Variable
• Qp0zGetAllSysEnv()--Get All System-Level Environment Variables
• Qp0zGetEnv()--Get Value of Environment Variable (Extended)
• Qp0zGetSysEnv()--Get Value of System-Level Environment Variable
• Qp0zPutEnv()--Change or Add Environment Variable (Extended)
• Qp0zPutSysEnv()--Change or Add a System-Level Environment