FPUTENV : Attribuer une valeur à une variable d'environnement

Comment :

Systèmes d'exploitation disponible : IBM i (appelé auparavant i5/OS), Tandem, UNIX, Windows

Langages disponibles : reporting

La fonction FPUTENV affecte une chaîne de caractères à une variable d'environnement. Utilisez FPUTENV pour indiquer des valeurs utilisées quelque part ailleurs dans le système.

Limite : vous ne pouvez pas utiliser FPUTENV pour indiquer ou modifier FOCPRINT, FOCPATH, ou USERPATH; une fois démarrées, ces variables sont gardées en mémoire et ne sont pas relues depuis l'environnement.


Haut de page

x
Syntaxe : Attribuer une valeur à une variable d'environnement
FPUTENV (varname_length,'varname',value_length, 'value', output)

où :

varname_length

Entier

est le nombre maximum de caractères dans le nom d'une variable d'environnement.

varname

Alphanumérique

est le nom de la variable d'environnement, entouré par des guillemets simples. Le nom doit être justifié à droite et complété avec des espaces vides à la longueur maximale spécifiée par varname_length.

value_length

est la longueur maximale pour la valeur de la variable.

Remarque : la somme de varname_length et value_length ne peut excéder 64.

value

Alphanumérique

est la valeur que vous souhaitez affecter à la variable d'environnement. La chaîne doit être justifiée à droite et ne peut contenir d'espaces vides. Les chaînes qui contiennent des espaces vides sont tronquées à partir du premier espace vide.

output

Entier

est le code de renvoi. Il peut s'agir du nom de champ qui contient le résultat, ou le format de la valeur de sortie entre guillemets simples. Si la variable est indiquée sans erreur, le code de retour est 0. Tout autre valeur indique qu'une erreur est survenue.



Exemple : Attribution d'une valeur à une variable d'environnement

FPUTENV affecte la valeur FOCUS/Shell à la variable PS1 et la stocke dans un champ au format A12 :

-SET &RC = FPUTENV(3,'PS1', 12 'FOCUS/Shell:', 'I4');

La requête affiche l'invite suivante quand l'utilisateur lance la commande de shell UNIX SH :

FOCUS/Shell:

Information Builders