Aller au contenu

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ètreTypePar défautSignification
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
ColonneTypeSignification
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