SYSTOOLS.PUTENV

À quoi ça sert

Cette fonction scalaire définit la variable ENVIRONMENT_VARIABLE_NAME avec la valeur ENVIRONMENT_VARIABLE_VALUE dans le travail qui l'exécute. La variable reste visible par ce travail et par les programmes qu'il lance ; elle disparaît à la fin du travail.

On s'en sert pour paramétrer un script ou une application avant un appel (chemin, mode, drapeau de trace). Pour relire la valeur, utiliser SYSTOOLS.GETENV.

Résultat réel sur un IBM i 7.5

Ce que nous avons exécuté :

VALUES (SYSTOOLS.PUTENV('JOBI_DEMO', 'Valeur posée par PUTENV'), SYSTOOLS.GETENV('JOBI_DEMO'))

Ce que l'IBM i a renvoyé le 01/10/2026 (1 ligne au plus) :

Données anonymisées : les noms de système, de profils, de bibliothèques, de postes et les adresses IP ont été remplacés. Les objets du schéma JOBISQL sont des objets de démonstration créés pour ce site.

L'exemple d'IBM

Définir la valeur de MY_ENVVAR pour le travail courant.

-- Description: Set the value of MY_ENVVAR for the current job. 
    VALUES SYSTOOLS.PUTENV('MY_ENVVAR', 'My job''s value for the environment variable');

Paramètres