Aller au contenu

Service SQL IBM i (AS/400) · Fonction table

QSYS2.SPOOLED_FILE_INFO

Liste des fichiers spoule

Liste les fichiers spoule avec leur statut, leur taille, leur file d'attente de sortie et le travail qui les a créés : l'équivalent SQL de WRKSPLF.

À quoi ça sert

SPOOLED_FILE_INFO est une fonction de table qui renvoie une ligne par fichier spoule : nom et numéro du fichier, statut, priorité de sortie, horodatage de création, données utilisateur, nombre de pages, nombre de copies, type de formulaire et file d'attente de sortie. Le travail d'origine est donné par JOB_NAME, JOB_USER et JOB_NUMBER.

Tous les paramètres sont facultatifs et servent de filtres : USER_NAME (par défaut *CURRENT), STARTING_TIMESTAMP et ENDING_TIMESTAMP pour borner la date de création, STATUS, JOB_NAME, OUTPUT_QUEUE, USER_DATA, FORM_TYPE et SYSTEM_NAME. Sans précision, la fonction ne renvoie que les fichiers spoule du profil courant.

On s'en sert pour repérer les files d'attente de sortie qui grossissent, retrouver les fichiers spoule d'un utilisateur ou d'un travail, ou préparer un nettoyage. Le SQL permet de trier par taille, de regrouper par file ou par utilisateur et de conserver le résultat dans une table pour suivre l'évolution.

Résultat réel sur un IBM i 7.5

Ce que nous avons exécuté :

SELECT SPOOLED_FILE_NAME, SPOOLED_FILE_NUMBER, STATUS, TOTAL_PAGES, CREATION_TIMESTAMP, QUALIFIED_JOB_NAME FROM TABLE(QSYS2.SPOOLED_FILE_INFO(OUTPUT_QUEUE => 'JOBISQL/DEMOOUTQ')) ORDER BY SPOOLED_FILE_NUMBER

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

SPOOLED_FILE_NAME Nom du fichier spoule SPOOLED_FILE_NUMBER Numéro du fichier spoule STATUS Statut TOTAL_PAGES Nombre total de pages CREATION_TIMESTAMP Horodatage de création QUALIFIED_JOB_NAME Nom qualifié du travail
QPRTOBJD 3176 READY 1 2026-10-01 09:05:31 966250/UTIL232/QPRTJOB
QPDSPFD 3177 READY 2 2026-10-01 09:05:54 966250/UTIL232/QPRTJOB

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 tous les fichiers spoule du travail courant.

-- Description: List all the spooled files for the current job. 
   SELECT * FROM TABLE(QSYS2.SPOOLED_FILE_INFO(JOB_NAME => '*'));

Bon à savoir

Par défaut, seuls les fichiers spoule du profil courant sont renvoyés : pour auditer tout le système, passez USER_NAME => '*ALL'. Sur un système qui conserve beaucoup de spoules, bornez la période avec les paramètres d'horodatage pour éviter une lecture longue.

Paramètres

ParamètreTypePar défautSignification
USER_NAME VARCHAR(219) '*CURRENT' Nom du profil utilisateur
STARTING_TIMESTAMP TIMESTAMP NULL Horodatage de début
ENDING_TIMESTAMP TIMESTAMP NULL Horodatage de fin
STATUS VARCHAR(98) '*ALL' Statut
JOB_NAME VARCHAR(28) '*ALL' Nom du travail
OUTPUT_QUEUE VARCHAR(439) '*ALL' File d'attente de sortie
USER_DATA VARCHAR(10) '*ALL' Données utilisateur
FORM_TYPE VARCHAR(10) '*ALL' Type de formulaire
SYSTEM_NAME VARCHAR(8) '*ALL' Nom du système

Colonnes renvoyées (20)

Afficher les 20 colonnes
ColonneTypeSignification
SPOOLED_FILE_NAME VARCHAR(10) Nom du fichier spoule
SPOOLED_FILE_NUMBER INTEGER Numéro du fichier spoule
STATUS VARCHAR(15) Statut
OUTPUT_PRIORITY INTEGER Priorité de sortie
CREATION_TIMESTAMP TIMESTAMP Horodatage de création
USER_DATA VARCHAR(10) Données utilisateur
SIZE BIGINT Taille
TOTAL_PAGES INTEGER Nombre total de pages
COPIES INTEGER Nombre de copies
QUALIFIED_JOB_NAME VARCHAR(28) Nom qualifié du travail
JOB_NAME VARCHAR(10) Nom du travail
JOB_USER VARCHAR(10) Profil utilisateur du travail
JOB_NUMBER VARCHAR(6) Numéro du travail
FILE_AVAILABLE VARCHAR(8) Fichier disponible
FORM_TYPE VARCHAR(10) Type de formulaire
OUTPUT_QUEUE_LIBRARY VARCHAR(10) Bibliothèque de la file d'attente de sortie
OUTPUT_QUEUE VARCHAR(10) File d'attente de sortie
ASP_NUMBER INTEGER Numéro de l'ASP
SYSTEM VARCHAR(8) Système
INTERNET_PRINT_PROTOCOL_JOB_ID INTEGER Identifiant du travail IPP (Internet Print Protocol)