Service SQL IBM i (AS/400) · Fonction scalaire
SYSTOOLS.IFS_UNLINK
Supprimer un objet de l'IFS
Supprime un fichier de l'IFS à partir de son chemin, directement depuis une requête SQL : l'équivalent de DEL ou RMVLNK.
À quoi ça sert
Cette fonction scalaire supprime l'objet désigné par le paramètre PATH_NAME. Elle se lance avec VALUES et convient aux traitements qui produisent un fichier temporaire (extraction, export) et doivent le nettoyer à la fin, sans passer par un appel de commande CL.
Combinée à SYSTOOLS.IFS_RENAME et SYSTOOLS.IFS_PATH, elle permet d'écrire en SQL toute la gestion du cycle de vie d'un fichier de l'IFS : construire le chemin, renommer, archiver puis supprimer.
Résultat réel sur un IBM i 7.5
Ce que nous avons exécuté :
CALL QSYS2.IFS_WRITE(PATH_NAME => '/tmp/jobisql/a-supprimer.txt', LINE => 'Fichier supprimé par IFS_UNLINK', OVERWRITE => 'REPLACE', FILE_CCSID => 1208);
VALUES SYSTOOLS.IFS_UNLINK(PATH_NAME => '/tmp/jobisql/a-supprimer.txt')Ce que l'IBM i a renvoyé le 01/10/2026 (1 ligne au plus) :
| 00001 |
|---|
| 0 |
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
Supprimer le fichier /usr/reportdata.txt.
-- Description: Unlink file /usr/reportdata.txt.
VALUES SYSTOOLS.IFS_UNLINK(PATH_NAME => '/usr/reportdata.txt');Bon à savoir
La suppression est définitive et ne passe pas par une corbeille. Vérifier le chemin et les droits du profil avec SYSTOOLS.IFS_ACCESS avant d'exécuter.
Paramètres
| Paramètre | Type | Par défaut | Signification |
|---|---|---|---|
PATH_NAME |
VARCHAR(5000) | obligatoire | Chemin |