Service SQL IBM i (AS/400) · Fonction table
QSYS2.MEMORY_POOL
Pools de mémoire du système
Renvoie l'état de chaque pool de mémoire (taille, travaux, pagination, défauts) avec option de remise à zéro des statistiques : un WRKSYSSTS détaillé.
À quoi ça sert
La fonction de table renvoie une ligne par pool de mémoire, avec une trentaine de colonnes : identifiant, nom, taille actuelle, réservée et définie, nombre maximal d'unités d'exécution actives, unités courantes et inéligibles, statut, sous-système et sa bibliothèque, description, option de pagination, temps écoulé et compteurs de défauts de page.
Le paramètre RESET_STATISTICS (défaut NO) permet de remettre les statistiques à zéro après la lecture, pour mesurer sur un intervalle précis. L'exemple d'IBM l'appelle avec 'YES' pour retourner toutes les informations disponibles.
On l'emploie pour analyser les performances : un pool trop petit, un taux de défauts de page élevé, une pagination mal réglée. Pour une simple lecture sans effet sur les compteurs, la vue QSYS2.MEMORY_POOL_INFO convient.
Résultat réel sur un IBM i 7.5
Ce que nous avons exécuté :
SELECT * FROM TABLE(QSYS2.MEMORY_POOL('YES')) XCe que l'IBM i a renvoyé le 01/10/2026 (5 lignes au plus) :
| SYSTEM_POOL_ID Identifiant du pool mémoire système | POOL_NAME Nom du pool mémoire | CURRENT_SIZE Taille courante | RESERVED_SIZE Taille réservée | DEFINED_SIZE Taille définie | MAXIMUM_ACTIVE_THREADS Nombre maximal d'unités d'exécution actives | CURRENT_THREADS Nombre actuel d'unités d'exécution | CURRENT_INELIGIBLE_THREADS Nombre actuel d'unités d'exécution inéligibles | STATUS Statut | SUBSYSTEM_LIBRARY_NAME Nom de la bibliothèque du sous-système | SUBSYSTEM_NAME Nom du sous-système | DESCRIPTION Description | PAGING_OPTION Option de pagination | ELAPSED_TIME Temps écoulé | ELAPSED_DATABASE_FAULTS Défauts de page de base de données écoulés | ELAPSED_NON_DATABASE_FAULTS Défauts de page hors base de données écoulés | ELAPSED_TOTAL_FAULTS Total des défauts de page écoulés | ELAPSED_DATABASE_PAGES Pages de base de données écoulées | ELAPSED_NON_DATABASE_PAGES Pages hors base de données écoulées | ELAPSED_ACTIVE_TO_WAIT Transitions écoulées de actif à attente | ELAPSED_WAIT_TO_INELIGIBLE Transitions écoulées de attente à inéligible | ELAPSED_ACTIVE_TO_INELIGIBLE Transitions écoulées de actif à inéligible | TUNING_PRIORITY Priorité de réglage | TUNING_MINIMUM_SIZE Taille minimale de réglage | TUNING_MAXIMUM_SIZE Taille maximale de réglage | TUNING_MINIMUM_FAULTS Nombre minimal de défauts de page de réglage | TUNING_MAXIMUM_FAULTS Nombre maximal de défauts de page de réglage | TUNING_THREAD_FAULTS Défauts de page par unité d'exécution de réglage | TUNING_MINIMUM_ACTIVITY Niveau d'activité minimal de réglage | TUNING_MAXIMUM_ACTIVITY Niveau d'activité maximal de réglage |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 | *MACHINE | 2103.04 | 1086.32 | 2103.04 | 2147483647 | 251 | 0 | ACTIVE | NULL | NULL | Utilisé par les fonctions internes du pool machine | *FIXED | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 4.69 | 100 | 10 | 10 | 0 | 0 | 0 |
| 2 | *BASE | 26954.82 | 9.76 | NULL | 1215 | 1363 | 0 | ACTIVE | NULL | NULL | Pool système par défaut | *CALC | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 19.99 | 100 | 12 | 200 | 1 | 5 | 32767 |
| 3 | *INTERACT | 3276.79 | 0 | 3276.79 | 406 | 9 | 0 | ACTIVE | NULL | NULL | Travail interactif | *CALC | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 10 | 100 | 12 | 200 | 1 | 5 | 32767 |
| 4 | *SPOOL | 327.67 | 0 | 327.67 | 5 | 0 | 0 | ACTIVE | NULL | NULL | Impression | *CALC | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 2 | 1 | 100 | 5 | 100 | 1 | 5 | 32767 |
| 5 | 1 | 8 | 0 | 8 | 2 | 0 | 0 | ACTIVE | BIBAPP560 | RCALLSBS | NULL | *FIXED | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | NULL | NULL | NULL | NULL | NULL | NULL | NULL | 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
Renvoyer toutes les informations disponibles sur les pools de mémoire.
-- Description: Return all available pool information.
SELECT * FROM TABLE(QSYS2.MEMORY_POOL('YES')) X;Bon à savoir
Avec RESET_STATISTICS => 'YES', la lecture remet à zéro les compteurs : si un autre outil de supervision lit les mêmes compteurs, ses mesures en seront faussées. Pour une lecture simple, laisse la valeur par défaut.
Paramètres
| Paramètre | Type | Par défaut | Signification |
|---|---|---|---|
RESET_STATISTICS |
VARCHAR(3) | 'NO' | Réinitialiser les statistiques |
Colonnes renvoyées (30)
Afficher les 30 colonnes
| Colonne | Type | Signification |
|---|---|---|
SYSTEM_POOL_ID |
INTEGER | Identifiant du pool mémoire système |
POOL_NAME |
VARCHAR(10) | Nom du pool mémoire |
CURRENT_SIZE |
DECIMAL(20, 2) | Taille courante |
RESERVED_SIZE |
DECIMAL(10, 2) | Taille réservée |
DEFINED_SIZE |
DECIMAL(20, 2) | Taille définie |
MAXIMUM_ACTIVE_THREADS |
INTEGER | Nombre maximal d'unités d'exécution actives |
CURRENT_THREADS |
INTEGER | Nombre actuel d'unités d'exécution |
CURRENT_INELIGIBLE_THREADS |
INTEGER | Nombre actuel d'unités d'exécution inéligibles |
STATUS |
VARCHAR(8) | Statut |
SUBSYSTEM_LIBRARY_NAME |
VARCHAR(10) | Nom de la bibliothèque du sous-système |
SUBSYSTEM_NAME |
VARCHAR(10) | Nom du sous-système |
DESCRIPTION |
VARCHAR(50) | Description |
PAGING_OPTION |
VARCHAR(10) | Option de pagination |
ELAPSED_TIME |
INTEGER | Temps écoulé |
ELAPSED_DATABASE_FAULTS |
DECIMAL(10, 1) | Défauts de page de base de données écoulés |
ELAPSED_NON_DATABASE_FAULTS |
DECIMAL(10, 1) | Défauts de page hors base de données écoulés |
ELAPSED_TOTAL_FAULTS |
DECIMAL(10, 1) | Total des défauts de page écoulés |
ELAPSED_DATABASE_PAGES |
DECIMAL(10, 1) | Pages de base de données écoulées |
ELAPSED_NON_DATABASE_PAGES |
DECIMAL(10, 1) | Pages hors base de données écoulées |
ELAPSED_ACTIVE_TO_WAIT |
DECIMAL(10, 1) | Transitions écoulées de actif à attente |
ELAPSED_WAIT_TO_INELIGIBLE |
DECIMAL(10, 1) | Transitions écoulées de attente à inéligible |
ELAPSED_ACTIVE_TO_INELIGIBLE |
DECIMAL(10, 1) | Transitions écoulées de actif à inéligible |
TUNING_PRIORITY |
INTEGER | Priorité de réglage |
TUNING_MINIMUM_SIZE |
DECIMAL(10, 2) | Taille minimale de réglage |
TUNING_MAXIMUM_SIZE |
DECIMAL(10, 2) | Taille maximale de réglage |
TUNING_MINIMUM_FAULTS |
DECIMAL(10, 2) | Nombre minimal de défauts de page de réglage |
TUNING_MAXIMUM_FAULTS |
DECIMAL(10, 2) | Nombre maximal de défauts de page de réglage |
TUNING_THREAD_FAULTS |
DECIMAL(10, 2) | Défauts de page par unité d'exécution de réglage |
TUNING_MINIMUM_ACTIVITY |
DECIMAL(10, 2) | Niveau d'activité minimal de réglage |
TUNING_MAXIMUM_ACTIVITY |
DECIMAL(10, 2) | Niveau d'activité maximal de réglage |