Service SQL IBM i (AS/400) · Fonction scalaire
SYSTOOLS.ERRNO_INFO
Décrire un numéro d'erreur errno
Renvoie la description d'un numéro d'erreur errno rencontré par une API ou une fonction de l'IFS, pour comprendre un code d'erreur.
À quoi ça sert
Quand une API C, une fonction de l'IFS ou un programme renvoie un code errno (3025, 3401…), ce code seul est peu parlant. Cette fonction scalaire prend le numéro dans le paramètre ERRNO et renvoie l'information qui s'y rapporte.
Elle se lance avec VALUES et sert au diagnostic : un journal d'erreurs d'une application ou d'un service web contient souvent un errno brut que l'on traduit ainsi, sans chercher dans la documentation des API.
Résultat réel sur un IBM i 7.5
Ce que nous avons exécuté :
VALUES SYSTOOLS.ERRNO_INFO(3025)Ce que l'IBM i a renvoyé le 01/10/2026 (1 ligne au plus) :
| 00001 |
|---|
| No such path or directory. |
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
Renvoyer l'information associée au numéro d'erreur errno 3025.
-- Description: Return information for errno 3025.
VALUES SYSTOOLS.ERRNO_INFO(3025);Paramètres
| Paramètre | Type | Par défaut | Signification |
|---|---|---|---|
ERRNO |
INTEGER | obligatoire | Numéro d'erreur (errno) |