Service SQL IBM i (AS/400) · Fonction table
QSYS2.PRESTART_JOB_STATISTICS
Statistiques des travaux à démarrage anticipé
Renvoie les statistiques d'utilisation d'une entrée de travaux à démarrage anticipé : travaux en cours, pics, attentes et demandes rejetées.
À quoi ça sert
Cette fonction de table donne les statistiques d'une entrée de travaux à démarrage anticipé : nombre actuel, moyen et maximal de travaux, travaux en cours d'utilisation, demandes en attente et temps d'attente moyen, demandes acceptées et rejetées. On la désigne par le sous-système (SUBSYSTEM_NAME), la bibliothèque et le nom du programme.
Avec RESET_STATISTICS à 'YES', les compteurs sont remis à zéro après lecture. Ces chiffres aident à dimensionner l'entrée : des demandes rejetées ou des attentes élevées signalent un nombre maximal de travaux trop bas.
L'exemple d'IBM joint la fonction à PRESTART_JOB_INFO pour les obtenir pour toutes les entrées d'un sous-système.
Résultat réel sur un IBM i 7.5
Ce que nous avons exécuté :
SELECT PJ.PRESTART_JOB_NAME, STAT.*
FROM QSYS2.PRESTART_JOB_INFO PJ,
LATERAL (
SELECT * FROM TABLE
(QSYS2.PRESTART_JOB_STATISTICS(PJ.SUBSYSTEM_DESCRIPTION,
PJ.PRESTART_JOB_PROGRAM_LIBRARY,
PJ.PRESTART_JOB_PROGRAM))) AS STAT
WHERE PJ.SUBSYSTEM_ACTIVE = 'YES' AND
PJ.SUBSYSTEM_DESCRIPTION = 'QUSRWRK'
Ce que l'IBM i a renvoyé le 01/10/2026 (5 lignes au plus) :
| PRESTART_JOB_NAME | SUBSYSTEM_NAME Nom du sous-système | PRESTART_JOB_PROGRAM_LIBRARY Bibliothèque du programme du travail à démarrage anticipé | PRESTART_JOB_PROGRAM Programme du travail à démarrage anticipé | STATUS_TIMESTAMP Horodatage du statut | ELAPSED_TIME Temps écoulé | CURRENT_JOBS Nombre actuel de travaux | AVERAGE_JOBS Nombre moyen de travaux | PEAK_JOBS Pic de travaux | CURRENT_INUSE_JOBS Nombre actuel de travaux utilisés | AVERAGE_INUSE_JOBS Nombre moyen de travaux utilisés | PEAK_INUSE_JOBS Pic de travaux en cours d'utilisation | CURRENT_WAIT_REQUESTS Nombre actuel de demandes en attente | AVERAGE_WAIT_REQUESTS Nombre moyen de demandes en attente | PEAK_WAIT_REQUESTS Pic de demandes en attente | AVERAGE_WAIT_TIME Temps d'attente moyen | ACCEPTED_REQUESTS Nombre de requêtes acceptées | REJECTED_REQUESTS Nombre de demandes rejetées |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| QZSOSIGN | QUSRWRK | QSYS | QZSOSIGN | 2026-10-01 08:57:29.591039 | 100735475 | 4 | 2.1 | 9 | 0 | 0 | 7 | 0 | 0 | 1 | 0 | 65024 | 0 |
| QZSCSRVS | QUSRWRK | QSYS | QZSCSRVS | 2026-10-01 08:57:29.591177 | 10073075 | 2 | 1.8 | 7 | 0 | 0 | 5 | 0 | 0 | 1 | 0 | 22042 | 0 |
| QNPSERVS | QUSRWRK | QSYS | QNPSERVS | 2026-10-01 08:57:29.591274 | 10073075 | 1 | 1.8 | 14 | 0 | 0 | 12 | 0 | 0 | 0 | 0 | 73 | 0 |
| QZRCSRVS | QUSRWRK | QSYS | QZRCSRVS | 2026-10-01 08:57:29.591367 | 10073075 | 3 | 2.7 | 43 | 2 | 1.2 | 42 | 0 | 0 | 1 | 0 | 3737 | 0 |
| QZHQSSRV | QUSRWRK | QSYS | QZHQSSRV | 2026-10-01 08:57:29.591463 | 10073075 | 1 | 1.6 | 3 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 213 | 0 |
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 statistiques courantes de tous les travaux à démarrage anticipé du sous-système QUSRWRK.
-- Description: List the current statistics for all prestart jobs in the QUSRWRK
-- subsystem.
SELECT PJ.PRESTART_JOB_NAME, STAT.*
FROM QSYS2.PRESTART_JOB_INFO PJ,
LATERAL (
SELECT * FROM TABLE
(QSYS2.PRESTART_JOB_STATISTICS(PJ.SUBSYSTEM_DESCRIPTION,
PJ.PRESTART_JOB_PROGRAM_LIBRARY,
PJ.PRESTART_JOB_PROGRAM))) AS STAT
WHERE PJ.SUBSYSTEM_ACTIVE = 'YES' AND
PJ.SUBSYSTEM_DESCRIPTION = 'QUSRWRK';
Bon à savoir
Évitez RESET_STATISTICS => 'YES' dans une requête de supervision régulière : la remise à zéro fausse les mesures des autres consultations.
Paramètres
| Paramètre | Type | Par défaut | Signification |
|---|---|---|---|
SUBSYSTEM_NAME |
VARCHAR(10) | obligatoire | Nom du sous-système |
PRESTART_JOB_PROGRAM_LIBRARY |
VARCHAR(10) | obligatoire | Bibliothèque du programme du travail à démarrage anticipé |
PRESTART_JOB_PROGRAM |
VARCHAR(10) | obligatoire | Programme du travail à démarrage anticipé |
RESET_STATISTICS |
VARCHAR(3) | 'NO' | Réinitialiser les statistiques |
IGNORE_ERRORS |
VARCHAR(3) | 'YES' | Ignorer les erreurs |
Colonnes renvoyées (17)
Afficher les 17 colonnes
| Colonne | Type | Signification |
|---|---|---|
SUBSYSTEM_NAME |
VARCHAR(10) | Nom du sous-système |
PRESTART_JOB_PROGRAM_LIBRARY |
VARCHAR(10) | Bibliothèque du programme du travail à démarrage anticipé |
PRESTART_JOB_PROGRAM |
VARCHAR(10) | Programme du travail à démarrage anticipé |
STATUS_TIMESTAMP |
TIMESTAMP | Horodatage du statut |
ELAPSED_TIME |
INTEGER | Temps écoulé |
CURRENT_JOBS |
INTEGER | Nombre actuel de travaux |
AVERAGE_JOBS |
DECIMAL(10, 1) | Nombre moyen de travaux |
PEAK_JOBS |
INTEGER | Pic de travaux |
CURRENT_INUSE_JOBS |
INTEGER | Nombre actuel de travaux utilisés |
AVERAGE_INUSE_JOBS |
DECIMAL(10, 1) | Nombre moyen de travaux utilisés |
PEAK_INUSE_JOBS |
INTEGER | Pic de travaux en cours d'utilisation |
CURRENT_WAIT_REQUESTS |
INTEGER | Nombre actuel de demandes en attente |
AVERAGE_WAIT_REQUESTS |
DECIMAL(10, 1) | Nombre moyen de demandes en attente |
PEAK_WAIT_REQUESTS |
INTEGER | Pic de demandes en attente |
AVERAGE_WAIT_TIME |
DECIMAL(10, 1) | Temps d'attente moyen |
ACCEPTED_REQUESTS |
INTEGER | Nombre de requêtes acceptées |
REJECTED_REQUESTS |
INTEGER | Nombre de demandes rejetées |