QSYS2.JOB_INFO

À quoi ça sert

La fonction de table renvoie une ligne par travail avec une soixantaine de colonnes : nom qualifié du travail et ses trois composantes, statut, type, sous-système, date du travail, description de travail, code de comptabilité, travail émetteur, etc. Elle couvre aussi les travaux qui ne sont pas actifs, par exemple ceux qui attendent dans une file d'attente des travaux, ce que ACTIVE_JOB_INFO ne montre pas.

Six paramètres de filtre limitent le volume et accélèrent la requête : JOB_STATUS_FILTER, JOB_TYPE_FILTER, JOB_SUBSYSTEM_FILTER, JOB_USER_FILTER (par défaut l'utilisateur courant), JOB_SUBMITTER_FILTER et JOB_NAME_FILTER (par défaut *ALL pour les autres). L'exemple d'IBM utilise JOB_STATUS_FILTER => '*JOBQ' pour repérer les travaux planifiés pour le lendemain.

Elle sert à retrouver un travail, qu'il soit en file, actif ou terminé, et à le décrire dans une requête que l'on peut trier, regrouper ou joindre à d'autres services, ce que WRKUSRJOB et WRKJOB ne permettent pas.

Résultat réel sur un IBM i 7.5

Ce que nous avons exécuté :

SELECT * FROM TABLE(QSYS2.JOB_INFO(JOB_STATUS_FILTER => '*ACTIVE', JOB_USER_FILTER => 'QSYS')) 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

Passer en revue les travaux planifiés pour s'exécuter demain.

-- Description: Review jobs that are scheduled to run tomorrow
 SELECT * 
   FROM TABLE(qsys2.job_info(job_status_filter => '*JOBQ')) x 
   WHERE job_scheduled_time BETWEEN DATE(CURRENT TIMESTAMP + 1 DAY) 
      AND DATE(CURRENT TIMESTAMP + 2 DAYS) 
   ORDER BY job_scheduled_time  ;

Paramètres

Colonnes renvoyées (72)