CHGENVVAR

Modifier variable d'environnement

Change Environment Variable

En bref

La commande Modification de variable d'environnement (CHGENVVAR) modifie la valeur d'une variable d'environnement existante. The Change Environment Variable (CHGENVVAR) command changes the value for an existing environment variable.

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

Syntaxe minimale

CHGENVVAR ENVVAR(…)

Paramètres

ENVVAR Variable d'environnement Environment variable obligatoire
VALUE Nouvelle valeur
CCSID ID codé de jeu de caractères
LEVEL Niveau

Astuce : dans une session 5250, tapez CHGENVVAR 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 modifier des variables d'environnement de niveau système. Restriction: You must have *JOBCTL special authority to use this command to change system-level environment variables.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
ENVVAR	Variable d'environnementEnvironment variable	Valeur caractère	Obligatoire, positionnel 1
VALUE	Nouvelle valeur	Valeur caractère, SAME, NULL	Facultatif, positionnel 2
CCSID	ID codé de jeu de caractères	1-65535, JOB, HEX, *SAME	Facultatif, positionnel 3
LEVEL	Niveau	JOB, SYS	Facultatif

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

Indique le nom de la variable d'environnement à modifier. 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 changed. If an environment variable by this name does not exist at the specified level (LEVEL parameter), error message CPFA981 is issued.

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.

Valeur initiale (VALUE)

Indique la valeur de la variable d'environnement. Specifies the environment variable value.

Les valeurs possibles sont : The possible values are:

*SAME: La valeur ne change pas. The value does not change.
*NULL: La valeur de la variable d'environnement est le caractère nul (X'00'). Cette valeur peut servir à interrompre l'association de la valeur actuelle de la variable d'environnement avec le nom de variable d'environnement indiqué. The value of the environment variable is the null character (X'00'). This value can be used to stop the association of the current environment variable value with the specified environment variable name.
environment-variable-value: Indiquez la valeur de la variable d'environnement. CHGENVVAR limite la longueur de la valeur à 1024 octets. Les valeurs valides comprennent tous les caractères EBCDIC. La valeur doit être placée entre apostrophes si elle contient un caractère non alphanumérique ou des blancs. Si une apostrophe est voulue, deux apostrophes doivent être utilisées (''). Specify the value of the environment variable. CHGENVVAR limits value to a maximum of 1024 bytes in length. Valid values include all EBCDIC characters. The value must be enclosed in apostrophes if it contains any non-alphanumeric character or blanks. If an apostrophe is intended, two apostrophes must be used ('').

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

ID codé de jeu de caractères (CCSID)

Indique l'identificateur de jeu de caractères codés (CCSID) du texte fourni dans les paramètres ENVVAR et VALUE. Cette valeur est stockée avec la variable d'environnement. Specifies the coded character set identifier (CCSID) of the text supplied on the ENVVAR and the VALUE parameters. This value is stored with the environment variable.

Les valeurs possibles sont : The possible values are:

*SAME: La valeur ne change pas. The value does not change.
*JOB: Le CCSID du texte est supposé être le CCSID du travail qui exécute cette commande. The CCSID of the text is assumed to be the CCSID of the job running this command.
*HEX: Le CCSID 65535 est stocké avec cette variable d'environnement. The CCSID of 65535 is stored with this environment variable.
coded-character-set-identifier: Indiquez le CCSID à stocker avec la variable d'environnement. Les valeurs valides vont de 1 à 65535. Specify the CCSID to be stored with the environment variable. Valid values range from 1 through 65535.

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.

Remarque :Cette zone sert uniquement à indiquer le niveau de la variable d'environnement modifiée et ne peut pas servir à changer le niveau de la variable d'environnement. Remarque :This field is only used to specify the level of the environment variable that is being changed, and cannot be used to change the level of the environment variable.

Exemples

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

CHGENVVAR   ENVVAR(altdir)  VALUE('/mydir/test')

Cette commande remplace la valeur de la variable d'environnement de niveau travail nommée altdir par la valeur /mydir/test. Le CCSID stocké avec la variable d'environnement n'est pas modifié. This command changes the value of the job-level environment variable named altdir to the value /mydir/test. The CCSID that is stored with the environment variable is not changed.

Exemple 2 : Modification du CCSID d'une variable d'environnement Example 2: Change the CCSID of an Environment Variable

CHGENVVAR   ENVVAR(altdir)  CCSID(273)

Cette commande remplace par 273 le CCSID de la variable d'environnement de niveau travail nommée altdir. La valeur de la variable d'environnement n'est pas modifiée. This command changes the CCSID of the job-level environment variable named altdir to 273. The environment variable value is not changed.

Exemple 3 : Mise à nul d'une variable d'environnement Example 3: Set an Environment Variable to Null

CHGENVVAR   ENVVAR(LIBPATH)  VALUE(*NULL)

Cette commande remplace la valeur de la variable d'environnement de niveau travail nommée LIBPATH par le caractère nul (x'00'). This command changes the value of the job-level environment variable named LIBPATH to the null (x'00') character.

Exemple 4 : Modification d'une variable d'environnement de niveau système Example 4: Change a System-level Environment Variable

CHGENVVAR   ENVVAR(home)  VALUE('/usr/home') LEVEL(*SYS)

Cette commande remplace la valeur de la variable d'environnement de niveau système nommée home par /usr/home. This command changes the value of the system-level environment variable named home to /usr/home.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

CPFA981: La variable d'environnement n'existe pas. Environment variable does not exist.
CPFA982: Caractère ENVVAR non valide. ENVVAR character not valid.
CPFA983: Une erreur inattendue s'est produite. Unexpected error occurred.
CPFA984: Le nombre maximal de variables d'environnement est atteint. Maximum number of environment variables exist.
CPFA98E: Non autorisé à mettre à jour les variables d'environnement de niveau système. Not authorized to update system-level environment variables.
CPF3BCA: CCSID &1 non pris en charge. CCSID &1 not supported.