WRKJOBQ

Gérer les files de travaux

En bref

La commande WRKJOBQ (Gérer les files d'attente de travaux) permet d'afficher l'état général de toutes les files d'attente de travaux ou l'état détaillé de l'une d'entre elles.

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

Syntaxe minimale

WRKJOBQ

Paramètres

JOBQ File d'attente de travaux
OUTPUT Sortie

Astuce : dans une session 5250, tapez WRKJOBQ 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

La commande WRKJOBQ (Gérer les files d'attente de travaux) permet d'afficher l'état général de toutes les files d'attente de travaux ou l'état détaillé de l'une d'entre elles. Cette commande permet également de gérer l'état général de toutes les files d'attente de travaux correspondant au nom générique qualifié indiqué. L'état des files d'attente peut être modifié lors de l'exécution de la commande.

La vue QSYS2.JOB_QUEUE_INFO renvoie des informations similaires.

Paramètres

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

File d'attente de travaux (JOBQ)

Indique que toutes les files d'attente de travaux doivent être affichées, ou bien indique celle dont l'état doit être affiché.

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

Valeurs uniques

*ALL: L'état de toutes les files d'attente de travaux comprenant les informations relatives à chacune des files est affiché. 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 de travaux de chaque bibliothèque du système.

Qualificateur 1 : File d'attente de travaux

nom-générique: Indiquez le nom générique des files d'attente de travaux pour lesquelles des informations détaillées relatives à son état sont affichées. La liste de tous les travaux figurant dans cette file d'attente, ainsi que les informations détaillées sur chacun d'entre eux, sera affichée.
nom: Indiquez le nom de la file d'attente de travaux pour laquelle des informations détaillées relatives à son état sont affichées. La liste de tous les travaux figurant dans cette file d'attente, ainsi que les informations détaillées sur chacun d'entre eux, sera affichée.

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 recherche porte sur la bibliothèque en cours de l'unité d'exécution. Si aucune bibliothèque n'est définie comme bibliothèque en cours pour l'unité d'exécution, la recherche porte sur la bibliothèque QGPL.

*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 de travaux 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 de travaux.

Sortie (OUTPUT)

Indique si la sortie résultant de l'exécution de la commande s'affiche sur le poste de travail auteur de la demande ou si elle est imprimée avec la sortie spoule du travail.

*: Si la demande est émise par l'utilisateur d'un poste de travail, la sortie est affichée. Si elle provient d'un travail par lots, la sortie est imprimée.
*PRINT: La sortie est imprimée avec la sortie spoule du travail.

Exemples

Exemple 1 : Affichage des informations d'état d'une file d'attente de travaux spécifique

WRKJOBQ   JOBQ(QGPL/QBATCH)

Cette commande permet d'afficher les informations d'état détaillées de la file d'attente de travaux QBATCH de la bibliothèque QGPL. Chaque travail de la file d'attente QBATCH est identifié par son nom, son numéro et le nom de l'utilisateur ; la priorité et l'état du travail sont également affichés.

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

WRKJOBQ   JOBQ(QGPL/QBAT*)

Cette commande permet à l'utilisateur d'afficher et de gérer les informations d'état générales des files d'attente de travaux dont le nom commence par 'QBAT' et se trouvant 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.
CPF3307: File d'attente de travaux &1 de &2 non trouvée.
CPF3330: Ressource nécessaire non disponible.
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.