Service SQL IBM i (AS/400) · Fonction scalaire
QSYS2.VERIFY_NAME
Validation d'un nom d'objet
Fonction scalaire qui vérifie qu'un nom respecte les règles du type de nom demandé, par exemple un nom système valide.
À quoi ça sert
VERIFY_NAME reçoit le nom à tester (NAME) et le type de nom attendu (NAME_TYPE), par exemple 'SYSTEM', et contrôle que le nom est valide pour ce type.
On l'utilise dans une application qui permet à l'utilisateur de saisir un nom de bibliothèque ou d'objet, pour le valider avant de créer l'objet et éviter une erreur plus loin. Dans l'exemple d'IBM, on teste le nom amIvalid comme nom système.
Comme les noms système sont limités en longueur et en caractères, le contrôle en amont évite des échecs de création difficiles à interpréter.
Résultat réel sur un IBM i 7.5
Ce que nous avons exécuté :
VALUES QSYS2.VERIFY_NAME('amIvalid', 'SYSTEM')Ce que l'IBM i a renvoyé le 01/10/2026 (1 ligne au plus) :
| 00001 |
|---|
| true |
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
Vérifier si un nom est un nom système valide.
-- Description: Check if a name is a valid system name.
VALUES QSYS2.VERIFY_NAME('amIvalid', 'SYSTEM');Paramètres
| Paramètre | Type | Par défaut | Signification |
|---|---|---|---|
NAME |
VARCHAR(258) | obligatoire | Nom |
NAME_TYPE |
VARCHAR(6) | obligatoire | Type de nom |