Service SQL IBM i (AS/400) · Fonction table
SYSTOOLS.CHECK_PRODUCT_OPTIONS
Vérifier les produits installés
Contrôle l'intégrité des produits et options installés, avec signature, et signale les problèmes : l'équivalent SQL de CHKPRDOPT.
À quoi ça sert
Cette fonction de table exécute pour tous les produits sous licence installés une vérification de type CHKPRDOPT et renvoie une ligne par produit et option : PRODUCT_ID, PRODUCT_OPTION, LOAD_ID, RELEASE_LEVEL, le résultat dans CHECK_SUCCESSFUL, et en cas d'échec le message (FAILURE_MESSAGE_ID, FAILURE_MESSAGE_TEXT). La colonne CHKPRDOPT_COMMAND donne la commande correspondante.
Le paramètre CHECK_SIGNATURE vaut *SIGNED par défaut. On s'en sert après une installation de PTF ou une restauration, ou avant une mise à niveau, pour repérer des objets endommagés ou des signatures invalides.
En SQL, on peut ne garder que les lignes en échec (CHECK_SUCCESSFUL différent de succès) pour produire un rapport court.
Résultat réel sur un IBM i 7.5
Ce que nous avons exécuté :
SELECT * FROM TABLE(SYSTOOLS.CHECK_PRODUCT_OPTIONS( ))Ce que l'IBM i a renvoyé le 01/10/2026 (5 lignes au plus) :
| PRODUCT_ID Identifiant du produit | PRODUCT_OPTION Option du produit | LOAD_ID Identifiant de chargement | RELEASE_LEVEL Niveau de release | CHECK_SUCCESSFUL Vérification réussie | FAILURE_MESSAGE_ID Identifiant du message d'échec | FAILURE_MESSAGE_TEXT Texte du message d'échec | CHKPRDOPT_COMMAND Commande CHKPRDOPT |
|---|---|---|---|---|---|---|---|
| AJDGP01 | *BASE | 5050 | V7R5M0 | YES | NULL | NULL | QSYS/CHKPRDOPT PRDID(AJDGP01) RLS(V7R5M0) OPTION(*BASE) LODID(5050) CHKSIG(*SIGNED) DETAIL(*FULL) |
| AJDG301 | *BASE | 5050 | V7R5M0 | YES | NULL | NULL | QSYS/CHKPRDOPT PRDID(AJDG301) RLS(V7R5M0) OPTION(*BASE) LODID(5050) CHKSIG(*SIGNED) DETAIL(*FULL) |
| AJDG401 | *BASE | 5050 | V7R5M0 | YES | NULL | NULL | QSYS/CHKPRDOPT PRDID(AJDG401) RLS(V7R5M0) OPTION(*BASE) LODID(5050) CHKSIG(*SIGNED) DETAIL(*FULL) |
| AJEAA01 | *BASE | 5050 | V7R5M0 | YES | NULL | NULL | QSYS/CHKPRDOPT PRDID(AJEAA01) RLS(V7R5M0) OPTION(*BASE) LODID(5050) CHKSIG(*SIGNED) DETAIL(*FULL) |
| AJEAR01 | *BASE | 5050 | V7R5M0 | YES | NULL | NULL | QSYS/CHKPRDOPT PRDID(AJEAR01) RLS(V7R5M0) OPTION(*BASE) LODID(5050) CHKSIG(*SIGNED) DETAIL(*FULL) |
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
Lister les problèmes éventuels sur l'ensemble des produits logiciels installés.
-- Description: List any potential problems with all installed software products.
SELECT * FROM TABLE(SYSTOOLS.CHECK_PRODUCT_OPTIONS( ));Bon à savoir
La vérification relit les objets de tous les produits : prévoir un temps d'exécution notable et la lancer hors des heures de charge.
Paramètres
| Paramètre | Type | Par défaut | Signification |
|---|---|---|---|
CHECK_SIGNATURE |
VARCHAR(7) | '*SIGNED' | Vérification de la signature |
Colonnes renvoyées (8)
Afficher les 8 colonnes
| Colonne | Type | Signification |
|---|---|---|
PRODUCT_ID |
VARCHAR(7) | Identifiant du produit |
PRODUCT_OPTION |
VARCHAR(5) | Option du produit |
LOAD_ID |
VARCHAR(4) | Identifiant de chargement |
RELEASE_LEVEL |
VARCHAR(10) | Niveau de release |
CHECK_SUCCESSFUL |
VARCHAR(3) | Vérification réussie |
FAILURE_MESSAGE_ID |
CHAR(7) | Identifiant du message d'échec |
FAILURE_MESSAGE_TEXT |
GRAPHIC VARYING | Texte du message d'échec |
CHKPRDOPT_COMMAND |
VARCHAR(1000) | Commande CHKPRDOPT |