QSYS2.GET_JOB_INFO

À quoi ça sert

La fonction prend un nom de travail qualifié (V_JOB_NAME) et renvoie une ligne : statut du travail, type, priorité d'exécution, profil, sous-système, temps processeur, stockage temporaire en Mo, E/S auxiliaires, défauts de page, ainsi que les informations d'identification du client (poste, application, adresse IP). Elle donne aussi le texte de l'instruction SQL en cours (V_SQL_STATEMENT_TEXT), son statut et son horodatage de début, et pour les travaux prédémarrés le nombre de réutilisations.

Le paramètre V_IGNORE_ERRORS (défaut NO) contrôle le comportement quand le travail est introuvable ou inaccessible. Dans l'exemple d'IBM, la fonction est appelée en jointure latérale pour chaque travail de ACTIVE_JOB_INFO, ce qui permet de repérer les travaux dont une instruction SQL tourne en ce moment, triés par durée.

Le SQL apporte ici la jointure : on enchaîne ACTIVE_JOB_INFO pour la sélection, puis GET_JOB_INFO pour le détail du SQL, sans écran de visualisation de travail à ouvrir un par un.

Résultat réel sur un IBM i 7.5

Ce que nous avons exécuté :

WITH ACTIVE_USER_JOBS (Q_JOB_NAME, CPU_TIME, RUN_PRIORITY) AS ( 
 SELECT 
  JOB_NAME, CPU_TIME, RUN_PRIORITY 
  FROM TABLE (ACTIVE_JOB_INFO()) x 
 WHERE JOB_TYPE <> 'SYS' 
 ) SELECT Q_JOB_NAME, CPU_TIME, RUN_PRIORITY, V_SQL_STATEMENT_TEXT, 
 ABS( CURRENT TIMESTAMP - V_SQL_STMT_START_TIMESTAMP ) AS SQL_STMT_DURATION, B.* 
 FROM ACTIVE_USER_JOBS, TABLE(QSYS2.GET_JOB_INFO(Q_JOB_NAME)) B 
 WHERE V_SQL_STMT_STATUS = 'ACTIVE' 
 ORDER BY SQL_STMT_DURATION DESC

Ce que l'IBM i a renvoyé le 01/10/2026 (3 lignes au plus) :

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

Trouver les travaux dont une instruction SQL est en cours d'exécution.

-- Description: Find the jobs with SQL statements executing 
 WITH ACTIVE_USER_JOBS (Q_JOB_NAME, CPU_TIME, RUN_PRIORITY) AS ( 
 SELECT 
  JOB_NAME, CPU_TIME, RUN_PRIORITY 
  FROM TABLE (ACTIVE_JOB_INFO()) x 
 WHERE JOB_TYPE <> 'SYS' 
 ) SELECT Q_JOB_NAME, CPU_TIME, RUN_PRIORITY, V_SQL_STATEMENT_TEXT, 
 ABS( CURRENT TIMESTAMP - V_SQL_STMT_START_TIMESTAMP ) AS SQL_STMT_DURATION, B.* 
 FROM ACTIVE_USER_JOBS, TABLE(QSYS2.GET_JOB_INFO(Q_JOB_NAME)) B 
 WHERE V_SQL_STMT_STATUS = 'ACTIVE' 
 ORDER BY SQL_STMT_DURATION DESC;

Paramètres

Colonnes renvoyées (22)