WRKOUTQ

Gérer les files de sortie

En bref

La commande WRKOUTQ (Gérer les files d'attente en sortie) permet d'afficher l'état général de toutes les files d'attente en sortie ou de toutes les files d'attente correspondant au nom générique qualifié et pour lesquelles l'utilisateur possède des droits, ou encore l'état détaillé d'une file…

WRKOUTQ se lit WRK (Gérer) + OUTQ. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

WRKOUTQ

Paramètres

OUTQ File d'attente en sortie
OUTPUT Sortie

Astuce : dans une session 5250, tapez WRKOUTQ puis F4 pour l'invite de saisie, et F1 sur un paramètre pour son aide.

Aide IBM i de la commande

Texte du F1, IBM i 7.5 en français (bibliothèque QSYS)

Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Non

Les vues QSYS2.OUTPUT_QUEUE_ENTRIES et QSYS2.OUTPUT_QUEUE_ENTRIES_BASIC et la fonction de table QSYS2.OUTPUT_QUEUE_ENTRIES renvoient des informations similaires.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
OUTQ	File d'attente en sortie	Valeurs uniques: ALL Autres valeurs: Nom d'objet qualifié*	Facultatif, positionnel 1
	Qualificatif 1: File d'attente en sortie	Nom générique, nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB, *ALL
OUTPUT	Sortie	, PRINT	Facultatif, positionnel 2

File d'attente en sortie (OUTQ)

Affiche l'état de toutes les files d'attente en sortie ou des files correspondant au nom générique qualifié indiqué, ou l'état d'une seule file d'attente correspondant à un nom qualifié spécifique.

Remarque :Lorsqu'un nom générique de file d'attente en sortie est indiqué avec un nom qualifié de bibliothèque, l'état général de toutes les files d'attente correspondant au nom est affiché, même si une seule file est trouvée.

Valeurs uniques

*ALL: La liste de toutes les files d'attente en sortie est affichée, ainsi que les informations relatives à chacune des files. Si vous indiquez *ALL, aucune valeur ne pourra être précisée pour un nom de bibliothèque, car *ALL fournit une liste de toutes les files d'attente en sortie de chaque bibliothèque du système.

Qualificatif 1 : File d'attente en sortie

nom-générique: Indiquez le nom générique des files d'attente de travaux pour lesquelles des informations détaillées relatives à l'état doivent être affichées. La liste de tous les fichiers spoule contenus dans la file d'attente en sortie sera affichée, ainsi que les informations relatives à chacun d'entre eux.
nom: Indiquez le nom de la file d'attente en sortie dont les informations détaillées doivent être affichées. La liste de tous les fichiers spoule contenus dans la file d'attente en sortie sera affichée, ainsi que les informations relatives à chacun d'entre eux.

Qualificatif 2: Biblio

*LIBL: La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.

*CURLIB: La file d'attente en sortie est recherchée dans la bibliothèque en cours du travail.
*ALL: La recherche porte sur toutes les bibliothèques du système, y compris QSYS.
Remarque :Lorsque *ALL est indiqué pour la bibliothèque, l'état général des files d'attente en sortie est affiché, même si une seule file d'attente est trouvée.
nom: Indiquez le nom de la bibliothèque contenant la file d'attente en sortie.

Sortie (OUTPUT)

Indique si la sortie générée par la commande doit être affichée sur le poste de travail demandeur, ou imprimée avec la sortie spoule du travail.

*: La sortie est affichée (travail interactif) ou imprimée avec la sortie spoule du travail (travail par lots).
*PRINT: La sortie est imprimée avec la sortie spoule du travail.

Exemples

Exemple 1 : Gestion des informations d'état d'une file d'attente en sortie spécifique

WRKOUTQ   OUTQ(QGPL/QPRINT)

Cette commande permet d'afficher l'écran Gestion de file d'attente en sortie pour la file d'attente en sortie QPRINT de la bibliothèque QGPL. Cet écran affiche chaque fichier spoule de la file d'attente en sortie QPRINT.

Exemple 2 : Recherche de files d'attente en sortie portant un nom générique

WRKOUTQ   OUTQ(QGPL/QPRI*)

Cette commande permet d'afficher l'écran Gestion de toutes les files d'attente en sortie présentant une liste de toutes les files d'attente en sortie dont le nom commence par les lettres 'QPRI' et qui se trouvent dans la bibliothèque QGPL.

Messages d'erreur

Messages *ESCAPE

CPF2207: Non autorisé à utiliser objet &1 de &3 type *&2.
CPF3302: Substitution du fichier d'impression &1 par &2 incorrecte.
CPF3330: Ressource nécessaire non disponible.
CPF3357: File d'attente en sortie &1 de &2 non trouvée.
CPF7D41: Erreur lors de la consignation de la demande d'assistance pour commande.
CPF7D42: Erreur lors de l'exécution d'une opération de base de données.
CPF9845: Erreur lors de l'ouverture du fichier &1.
CPF9846: Erreur lors du traitement du fichier &1 de &2.
CPF9871: Erreur lors du traitement.