Remove Environment Variable (RMVENVVAR)

The Remove Environment Variable (RMVENVVAR) command removes an environment variable (or all environment variables) that exists.

Restriction: You must have *JOBCTL special authority to use this command to remove system-level environment variables.

Parameters

Keyword Description Choices Notes
ENVVAR Environment variable Character value, *ALL Required, Positional 1
LEVEL Level *JOB, *SYS Optional

Environment variable (ENVVAR)

Specifies the name of the environment variable to be removed. If an environment variable by this name does not exist at the specified level (LEVEL parameter), error message CPFA981 is issued.

If the special value of *ALL is specified, then all environment variables at the specified level (LEVEL parameter) are removed.

Note: The case is preserved when lowercase characters are specified.

If an apostrophe is intended, two apostrophes must be used ('').

This is a required parameter.

Level (LEVEL)

Specifies the level of the environment variable.

The possible values are:

*JOB
This is a job-level environment variable.
*SYS
This is a system-level environment variable.

Examples

Example 1: Remove a Job-level Environment Variable

RMVENVVAR   ENVVAR(altdir)

This command removes the job-level environment variable named altdir.

Example 2: Remove a System-level Environment Variable

RMVENVVAR   ENVVAR(home)  TYPE(*SYS)

This command removes the system-level environment variable named home.

Example 3: Remove All Job-level Environment Variables

RMVENVVAR   ENVVAR(*ALL)

This commands removes all job-level environment variables.

Example 4: Remove All System-level Environment Variables

RMVENVVAR   ENVVAR(*ALL)  LEVEL(*SYS)

This commands removes all system-level environment variables.

Error messages

*ESCAPE Messages

CPFA981
Environment variable does not exist.
CPFA98E
*JOBCTL special authority required to update system-level environment variables.