HLDOUTQ

Suspendre une file de sortie

En bref

HLDOUTQ se lit HLD (Suspendre) + OUTQ. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

HLDOUTQ OUTQ(…)

Paramètres

OUTQ File d'attente en sortie obligatoire

Astuce : dans une session 5250, tapez HLDOUTQ 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 HLDOUTQ (Suspendre une file d'attente en sortie) permet d'empêcher le traitement par un éditeur de spoule de tous les fichiers spoule en attente et de tous ceux qui sont ajoutés à la file d'attente en sortie après le lancement de la commande. Cette commande n'a aucune incidence sur les travaux en cours d'exécution ni sur les fichiers spoule ajoutés à la file d'attente en sortie. Elle n'affecte pas non plus les données en cours d'impression (par un éditeur de spoule) lors du lancement de la commande. Lorsque tous les exemplaires du fichier en sortie en cours sont achevés, l'éditeur ne peut reprendre la sortie des autres fichiers qu'une fois la file d'attente libérée.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
OUTQ	File d'attente en sortie	Nom d'objet qualifié	Obligatoire, positionnel 1
	Qualificatif 1: File d'attente en sortie	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB

File d'attente en sortie (OUTQ)

Indique le nom de la file d'attente en sortie dont les fichiers spoule (actuels et futurs) ne seront plus traités.

Ce paramètre est obligatoire.

Qualificatif 1 : File d'attente en sortie

nom: Indiquez le nom de la file d'attente en sortie à suspendre.

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. Si celle-ci ne figure pas dans la liste des bibliothèques, QGPL est prise par défaut.
nom: Indiquez le nom de la bibliothèque contenant la file d'attente en sortie.

Exemples

HLDOUTQ   OUTQ(QPRINT)

Cette commande permet d'empêcher le traitement des fichiers spoule se trouvant dans la file d'attente QPRINT et de tous les fichiers spoule qui sont ajoutés à cette file. Ils sont suspendus jusqu'à ce que la file d'attente soit libérée ou mise à blanc. Chaque travail (avec ses fichiers spoule) peut également être arrêté par la commande ENDJOB, qui supprime les fichiers spoule de la file d'attente en sortie.

Messages d'erreur

Messages *ESCAPE

CPF2207: Non autorisé à utiliser objet &1 de &3 type *&2.
CPF3330: Ressource nécessaire non disponible.
CPF3357: File d'attente en sortie &1 de &2 non trouvée.
CPF3426: File d'attente en sortie &1 de &2 déjà suspendue.