Service SQL IBM i (AS/400) · Fonction scalaire
SYSTOOLS.GETENV
Lire une variable d'environnement
Renvoie la valeur d'une variable d'environnement du travail courant, comme celles qu'on définit avec ADDENVVAR ou PUTENV.
À quoi ça sert
Cette fonction scalaire prend le nom d'une variable d'environnement (ENVIRONMENT_VARIABLE_NAME) et renvoie sa valeur dans le travail qui l'exécute. Elle ne voit que les variables du travail courant : une variable posée dans un autre travail n'y est pas visible.
On l'emploie pour paramétrer un traitement SQL ou un script (chemin d'un répertoire, mode d'exécution) sans le coder en dur. Elle se lance avec VALUES. Son pendant en écriture est SYSTOOLS.PUTENV.
Résultat réel sur un IBM i 7.5
Ce que nous avons exécuté :
VALUES SYSTOOLS.GETENV('MY_ENVVAR')Ce que l'IBM i a renvoyé le 01/10/2026 (1 ligne au plus) :
| 00001 |
|---|
| NULL |
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
Obtenir la valeur de la variable d'environnement MY_ENVVAR pour le travail courant.
-- Description: Get the value of MY_ENVVAR for the current job.
VALUES SYSTOOLS.GETENV('MY_ENVVAR');Paramètres
| Paramètre | Type | Par défaut | Signification |
|---|---|---|---|
ENVIRONMENT_VARIABLE_NAME |
VARCHAR(128) | obligatoire | Nom de la variable d'environnement |