QSYS2.OUTPUT_QUEUE_ENTRIES

À quoi ça sert

Ce service, disponible sous forme de vue et de fonction de table, renvoie les entrées des files d'attente de sortie, comme WRKOUTQ. Chaque ligne décrit un fichier spoule : nom, profil, données utilisateur, statut, taille, nombre de pages et de copies, type de formulaire, travail d'origine, priorité, date d'expiration, ainsi que de nombreux attributs d'impression (police, superpositions, recto verso).

La fonction accepte la bibliothèque (OUTQ_LIB) et le nom (OUTQ_NAME) de la file, DETAILED_INFO ('NO' par défaut) pour limiter le détail et IGNORE_ERRORS ('YES' par défaut). La vue parcourt toutes les files.

Le SQL permet de totaliser l'espace spoule par profil, de repérer les fichiers qui vont expirer, ou d'historiser l'état des files.

Résultat réel sur un IBM i 7.5

Ce que nous avons exécuté :

SELECT * FROM TABLE(QSYS2.OUTPUT_QUEUE_ENTRIES('JOBISQL', 'DEMOOUTQ', '*NO'))

Ce que l'IBM i a renvoyé le 01/10/2026 (2 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 fichiers spoule qui expireront dans les deux semaines à venir.

-- Description: Find spool files that will expire within two weeks 
 SELECT * FROM QSYS2.OUTPUT_QUEUE_ENTRIES 
   WHERE EXPIRATION_DATE < CURRENT DATE + 14 DAYS 
   ORDER BY EXPIRATION_DATE DESC;

-- Description: Find the top 10 consumers of SPOOL storage 
 SELECT USER_NAME, SUM(SIZE) AS TOTAL_SPOOL_SPACE 
   FROM TABLE(QSYS2.OBJECT_STATISTICS('*ALLUSR   ', 'LIB    ')) AS S1, 
   LATERAL 
   (SELECT * FROM TABLE(QSYS2.OBJECT_STATISTICS(CAST(S1.objname AS CHAR(10)), 
                                                'OUTQ   ')) AS b) AS S2, 
   LATERAL 
   (SELECT * FROM TABLE(QSYS2.OUTPUT_QUEUE_ENTRIES(S1.objname, 
                                                   S2.objname, '*NO')) 
    AS c) AS S3 
   WHERE S1.OBJNAME NOT LIKE 'Q%' AND USER_NAME NOT LIKE 'Q%' 
   GROUP BY USER_NAME 
   ORDER BY TOTAL_SPOOL_SPACE DESC 
   LIMIT 10;

Paramètres

Colonnes renvoyées (56)