RMVENVVAR

Enlever variable d'environnement

Remove Environment Variable

En bref

La commande Retirer une variable d'environnement (RMVENVVAR) retire une variable d'environnement (ou toutes les variables d'environnement) existante. The Remove Environment Variable (RMVENVVAR) command removes an environment variable (or all environment variables) that exists.

RMVENVVAR se lit RMV (Retirer) + ENVVAR. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

RMVENVVAR ENVVAR(…)

Paramètres

ENVVAR Variable d'environnement Environment variable obligatoire
LEVEL Niveau

Astuce : dans une session 5250, tapez RMVENVVAR puis F4 pour l'invite de saisie, et F1 sur un paramètre pour son aide.

Aide IBM i de la commande

Texte du F1, IBM i 7.5 en français (bibliothèque QSYS)

Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Oui

Restriction : Vous devez posséder le droit spécial *JOBCTL pour utiliser cette commande afin de retirer des variables d'environnement de niveau système. Restriction: You must have *JOBCTL special authority to use this command to remove system-level environment variables.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
ENVVAR	Variable d'environnementEnvironment variable	Valeur caractère, *ALL	Obligatoire, positionnel 1
LEVEL	Niveau	JOB, SYS	Facultatif

Variable d'environnement (ENVVAR)Environment variable (ENVVAR)

Indique le nom de la variable d'environnement à retirer. Si aucune variable d'environnement de ce nom n'existe au niveau indiqué (paramètre LEVEL), le message d'erreur CPFA981 est émis. 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.

Si la valeur spéciale *ALL est indiquée, toutes les variables d'environnement du niveau indiqué (paramètre LEVEL) sont retirées. If the special value of *ALL is specified, then all environment variables at the specified level (LEVEL parameter) are removed.

Remarque : La casse est conservée lorsque des minuscules sont indiquées. Remarque :The case is preserved when lowercase characters are specified.

Si une apostrophe est voulue, deux apostrophes doivent être utilisées (''). If an apostrophe is intended, two apostrophes must be used ('').

Ce paramètre est obligatoire. This is a required parameter.

Niveau (LEVEL)

Indique le niveau de la variable d'environnement. Specifies the level of the environment variable.

Les valeurs possibles sont : The possible values are:

*JOB: Il s'agit d'une variable d'environnement de niveau travail. This is a job-level environment variable.
*SYS: Il s'agit d'une variable d'environnement de niveau système. This is a system-level environment variable.

Exemples

Exemple 1 : Retrait d'une variable d'environnement de niveau travail Example 1: Remove a Job-level Environment Variable

RMVENVVAR   ENVVAR(altdir)

Cette commande retire la variable d'environnement de niveau travail nommée altdir. This command removes the job-level environment variable named altdir.

Exemple 2 : Retrait d'une variable d'environnement de niveau système Example 2: Remove a System-level Environment Variable

RMVENVVAR   ENVVAR(home)  TYPE(*SYS)

Cette commande retire la variable d'environnement de niveau système nommée home. This command removes the system-level environment variable named home.

Exemple 3 : Retrait de toutes les variables d'environnement de niveau travail Example 3: Remove All Job-level Environment Variables

RMVENVVAR   ENVVAR(*ALL)

Cette commande retire toutes les variables d'environnement de niveau travail. This commands removes all job-level environment variables.

Exemple 4 : Retrait de toutes les variables d'environnement de niveau système Example 4: Remove All System-level Environment Variables

RMVENVVAR   ENVVAR(*ALL)  LEVEL(*SYS)

Cette commande retire toutes les variables d'environnement de niveau système. This commands removes all system-level environment variables.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

CPFA981: La variable d'environnement n'existe pas. Environment variable does not exist.
CPFA98E: Non autorisé à mettre à jour les variables d'environnement de niveau système. Not authorized to update system-level environment variables.