QSYS2.HISTORY_LOG_INFO

À quoi ça sert

La fonction de table renvoie les messages du journal historique : identifiant, type, gravité, horodatage, utilisateur et travail d'origine, programme, bibliothèque et fichier de messages, texte du message et texte de second niveau. Les paramètres START_TIME (par défaut la veille) et END_TIME bornent la période lue, ce qui évite de parcourir tout l'historique.

Le paramètre GENERATE_SYSLOG ajoute les colonnes au format syslog (événement, origine, gravité, priorité), pratique pour envoyer ces messages à un outil de supervision. EOF_DELAY règle un délai en fin de fichier.

Le journal historique garde la trace des débuts et fins de travaux, des connexions et des événements système. L'exemple d'IBM s'appuie sur les messages CPF1124 (début de travail) et CPF1164 (fin de travail) pour calculer la durée des travaux utilisateurs : un calcul impossible à faire avec DSPLOG.

Résultat réel sur un IBM i 7.5

Ce que nous avons exécuté :

SELECT * FROM TABLE(QSYS2.HISTORY_LOG_INFO()) X

Ce que l'IBM i a renvoyé le 01/10/2026 (5 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

Calculer les 50 travaux utilisateur de plus longue durée, démarrés entre hier minuit et maintenant.

-- Description: Compute the 50 user jobs with the longest time span, 
     -- that started between yesterday (midnight) and now 
   WITH new_jobs(job_name, start_time) 
   AS (SELECT from_job, message_timestamp 
          FROM TABLE(qsys2.history_log_info()) x 
          WHERE message_id = 'CPF1124'), 
     ended_jobs(job_name, end_time) 
   AS (SELECT from_job, message_timestamp 
          FROM TABLE(qsys2.history_log_info()) x 
          WHERE message_id = 'CPF1164') 
   SELECT n.job_name, 
          TIMESTAMPDIFF(4, CAST(end_time - start_time AS CHAR(22))) AS execution_minutes 
          FROM new_jobs n INNER JOIN ended_jobs e ON n.job_name = e.job_name 
      WHERE n.job_name NOT LIKE '%/Q%/%' 
      ORDER BY execution_minutes DESC 
      FETCH FIRST 50 ROWS ONLY  ;

Paramètres

Colonnes renvoyées (21)