HLDWTR

Suspendre un éditeur de spoule

En bref

La commande HLDWTR (Suspendre un éditeur de spoule) permet d'arrêter un éditeur à la fin d'un enregistrement, d'un fichier spoule, ou d'une page imprimée.

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

Syntaxe minimale

HLDWTR WTR(…)

Paramètres

WTR Editeur obligatoire
OPTION Option de suspension

Astuce : dans une session 5250, tapez HLDWTR 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 HLDWTR (Suspendre un éditeur de spoule) permet d'arrêter un éditeur à la fin d'un enregistrement, d'un fichier spoule, ou d'une page imprimée. Si des exemplaires multiples sont imprimés, l'éditeur peut être suspendu lorsqu'il arrive à la fin de l'exemplaire en cours d'impression. Il n'est pas arrêté et l'unité à laquelle il est associé n'est pas disponible. Il reste inactif jusqu'à ce que les commandes RLSWTR (Libérer un éditeur de spoule) ou ENDWTR (Arrêter un éditeur de spoule) soient lancées. Aucune donnée n'est perdue.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
WTR	Editeur	Nom	Obligatoire, positionnel 1
OPTION	Option de suspension	IMMED, CNTRLD, *PAGEEND	Facultatif, positionnel 2

Editeur (WTR)

Indique l'éditeur de spoule en cours de suspension.

Ce paramètre est obligatoire.

nom: Indiquez le nom de l'éditeur à suspendre.

Option de suspension (OPTION)

Indique le moment où l'éditeur de spoule doit interrompre son traitement.

*IMMED: L'éditeur s'arrête immédiatement après avoir écrit le dernier enregistrement du bloc d'enregistrements en cours sur l'unité en sortie. A chaque fois que l'éditeur a fini de créer un bloc d'enregistrements sur une unité, il procède à une nouvelle demande d'E-S pour obtenir le bloc suivant du fichier en cours d'envoi sur l'unité. Si *IMMED est indiqué, l'éditeur ne s'arrête qu'après avoir écrit le dernier enregistrement du bloc en cours de traitement, qui représente, dans le cas d'une sortie disquette, l'écriture sur disquette d'un enregistrement de disquette complet.
Si *IMMED est indiqué pour la sortie imprimée, l'éditeur s'arrête à n'importe quel point de la ligne d'impression ou à la fin d'un bloc complet, ce qui peut ne pas correspondre à une fin de ligne. En effet, certains enregistrements de données (regroupés par blocs pour améliorer les performances) peuvent être scindés, une partie de l'enregistrement figurant à la fin d'un bloc et l'autre au début du bloc suivant. Si un seul exemplaire du fichier est généré, ou s'il s'agit du dernier exemplaire, le poste correspondant au fichier est supprimé de la file d'attente une fois la sortie terminée.
*CNTRLD: L'éditeur s'arrête à la fin de l'exemplaire en cours du fichier. Si un seul exemplaire est imprimé, ou si l'exemplaire en cours est le dernier, le poste du fichier spoule est supprimé de la file d'attente en sortie lorsque son impression est terminée.
*PAGEEND: L'éditeur est suspendu lorsqu'il arrive en fin de page. Cette valeur n'est admise que si l'éditeur de spoule est un éditeur imprimante.

Exemples

HLDWTR   WTR(PRINTER)  OPTION(*CNTRLD)

Cette commande permet d'arrêter l'éditeur PRINTER à la fin du fichier en cours. L'éditeur est suspendu jusqu'au lancement d'une commande RLSWTR (Libérer un éditeur) ou ENDWTR (Arrêter un éditeur).

Messages d'erreur

Messages *ESCAPE

CPF1340: Fonction de contrôle de travail non effectuée.
CPF3313: Editeur &1 non actif ni en file d'attente de travaux.
CPF3330: Ressource nécessaire non disponible.
CPF3331: Vous n'êtes pas autorisé à contrôler l'éditeur &3/&2/&1.
CPF3332: Editeur &3/&2/&1 déjà suspendu.
CPF3334: Editeur &3/&2/&1 en instance de suspension.
CPF3438: *PAGEEND incorrect pour l'éditeur &3/&2/&1.