Service SQL IBM i (AS/400) · Procédure
QSYS2.DUMP_PLAN_CACHE_PROPERTIES
Propriétés du cache de plans SQL
Écrit dans une table les propriétés du cache de plans SQL, pour connaître sa configuration au moment de l'analyse.
À quoi ça sert
La procédure QSYS2.DUMP_PLAN_CACHE_PROPERTIES récupère les propriétés du cache de plans et les place dans la table FILENAME de la bibliothèque FILESCHEMA, deux paramètres obligatoires.
On l'utilise en complément de DUMP_PLAN_CACHE : l'instantané contient les plans, les propriétés disent dans quel contexte ils ont été obtenus. Elle crée une table de sortie et n'a pas de mode aperçu (PREVIEW).
Résultat réel sur un IBM i 7.5
Ce que nous avons exécuté :
CALL QSYS2.DUMP_PLAN_CACHE_PROPERTIES('JOBISQL', 'PCPROP');
SELECT * FROM JOBISQL.PCPROPCe que l'IBM i a renvoyé le 01/10/2026 (5 lignes au plus) :
| HEADING | VALUE | VALUE_UNITS | ENTRY_NUMBER | ENTRY_TYPE | GRAPHABLE | MINVALUE | MAXVALUE | DFTVALUE | CHANGE_WARNING |
|---|---|---|---|---|---|---|---|---|---|
| Heure du récapitulatif | 2026-10-01-09.11.14.438170 | 50 | DA | 1 | 2026-10-01-09.11.14.438171 | 2026-10-01-09.11.14.438172 | 2026-10-01-09.11.14.438172 | NULL | |
| Heure de création de la mémoire cache de plans | 2026-06-06-18.52.30.740267 | 16 | DA | 1 | 2026-06-06-18.52.30.740267 | 2026-06-06-18.52.30.740267 | 2026-06-06-18.52.30.740267 | NULL | |
| Récapitulatif des requêtes actives | 2 | HE | 0 | NULL | |||||
| Nombre de requêtes actives en cours | 30 | 3 | DA | 1 | 30 | 30 | 30 | NULL | |
| Nombre de requêtes exécutées depuis le début | 4130342 | 4 | DA | 1 | 4130342 | 4130342 | 4130342 | 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
Récupérer les propriétés du cache de plans.
-- Description: Retrieve the properties
CALL QSYS2.DUMP_PLAN_CACHE_PROPERTIES('SNAPSHOTS','PCP160217');Paramètres
| Paramètre | Type | Par défaut | Signification |
|---|---|---|---|
FILESCHEMA |
VARCHAR(10) | obligatoire | Bibliothèque du fichier |
FILENAME |
VARCHAR(10) | obligatoire | Nom du fichier |