ADDENVVAR

La commande Ajouter une variable d'environnement (ADDENVVAR) ajoute une variable d'environnement constituée d'une chaîne de caractères de la forme 'nom de variable d'environnement=valeur de variable d'environnement'. Les variables d'environnement peuvent servir, par exemple, à fournir des valeurs de configuration aux programmes d'application sur les systèmes conformes à la Single UNIX Specification. The Add Environment Variable (ADDENVVAR) command adds an environment variable consisting of a character string in the form 'environment variable name=environment variable value'. Environment variables can be used, for example, to specify configuration values to application programs on systems that are compliant with the Single UNIX Specification.

Si vous n'êtes pas prêt à définir la valeur de la variable d'environnement, vous pouvez utiliser cette commande pour ajouter une variable d'environnement avec une valeur nulle. Vous pouvez ensuite utiliser la commande Ajouter une variable d'environnement (ADDENVVAR) ou Modifier une variable d'environnement (CHGENVVAR) pour associer la valeur d'environnement au nom de la variable d'environnement. If you are not ready to set the environment variable value, you can use this command to add an environment variable with a null value. You can then use the Add Environment Variable (ADDENVVAR) or Change Environment Variable (CHGENVVAR) command to associate the environment value with the environment variable name.

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

Paramètres

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

Indique le nom de la variable d'environnement à ajouter. Si une variable d'environnement portant ce nom existe déjà au niveau indiqué (paramètre LEVEL), le message d'erreur CPFA980 est émis, sauf si l'option REPLACE(*YES) est utilisée, auquel cas la variable prend la nouvelle valeur indiquée. Specifies the name of the environment variable to be added. If an environment variable by this name currently exists at the specified level (LEVEL parameter), error message CPFA980 is issued, unless the REPLACE(*YES) option is used, in which case the variable is set to the new value specified.

ADDENVVAR limite le nom de la variable d'environnement à 128 octets au maximum. Les valeurs valides incluent tous les caractères EBCDIC, à l'exception du signe égal (=), du terminateur nul (X'00') et du blanc (X'40'). Le nom doit être placé entre apostrophes s'il contient un caractère non alphanumérique. Si une apostrophe est voulue, il faut utiliser deux apostrophes (''). ADDENVVAR limits environment variable name to a maximum of 128 bytes in length. Valid values include all EBCDIC characters except the equal sign (=), the null-terminator (X'00') and blank (X'40'). The name must be enclosed in apostrophes if it contains any non-alphanumeric character. 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.

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:

*NULL

La valeur de la variable d'environnement est le caractère nul (X'00'). The value of the environment variable is the null character (X'00').

environment-variable-value

Indiquez la valeur de la variable d'environnement. ADDENVVAR limite la valeur à 1024 octets au maximum. Les valeurs valides incluent 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, il faut utiliser deux apostrophes (''). Specify the value of the environment variable. ADDENVVAR 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:

*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.

Remplacer l'entrée existante (REPLACE)Replace existing entry (REPLACE)

Indique si la valeur d'une variable d'environnement existante doit être réinitialisée à la nouvelle valeur. Specifies whether the value of an existing environment variable should be reset to the new value.

Les valeurs possibles sont : The possible values are:

*NO

Ne remplace pas. Si une variable d'environnement portant le nom indiqué (paramètre ENVVAR) existe au niveau indiqué (paramètre LEVEL), le message d'erreur CPFA980 est émis. Do not replace. If an environment variable with the specified name (ENVVAR parameter) exists at the specified level (LEVEL parameter), error message CPFA980 is issued.

*YES

Remplace. Si une variable d'environnement portant le nom indiqué (paramètre ENVVAR) existe au niveau indiqué (paramètre LEVEL), sa valeur est remplacée par la nouvelle valeur. Replace. If an environment variable with the specified name (ENVVAR parameter) exists at the specified level (LEVEL parameter), its value will be replaced by the new value.

Exemples

Exemple 1 : Ajout d'une variable d'environnement avec le CCSID 37 Example 1: Add an Environment Variable with CCSID 37

ADDENVVAR   ENVVAR(altdir)  VALUE('/mydir/dir2') CCSID(37)

Cette commande ajoute la variable d'environnement nommée altdir, de valeur /mydir/dir2, aux variables d'environnement du travail. La valeur 37 est stockée avec la variable d'environnement pour indiquer son CCSID. This command adds the environment variable named altdir with the value /mydir/dir2 to the environment variables for the job. The value 37 is stored with the environment variable to indicate its CCSID.

Exemple 2 : Définition d'une variable d'environnement à la valeur nulle Example 2: Set an Environment Variable to Null

ADDENVVAR   ENVVAR(LIBPATH)  VALUE(*NULL)

Cette commande ajoute la variable d'environnement nommée LIBPATH, avec la valeur de caractère nul (x'00), aux variables d'environnement du travail. This command adds the environment variable named LIBPATH with the null (x'00) character value to the environment variables for the job.

Exemple 3 : Ajout d'une variable d'environnement de niveau système Example 3: Add a System-level Environment Variable

ADDENVVAR   ENVVAR(homedir)  VALUE('/home')  LEVEL(*SYS)

Cette commande ajoute une variable d'environnement de niveau système nommée homedir, de valeur /home. This command adds a system-level environment variable named homedir with value /home.

Exemple 4 : Réinitialisation d'une variable d'environnement de niveau travail Example 4: Reset a Job-level Environment Variable

ADDENVVAR   ENVVAR(altdir)  VALUE('/mydir/dir3')  REPLACE(*YES)

Cette commande remplace la valeur existante de la variable altdir par la nouvelle valeur /mydir/dir3. This command replaces the existing value of the variable altdir with the new value of /mydir/dir3.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

CPFA980

Le nom de la variable d'environnement existe. Environment variable name exists.

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.