ENDWTR

Arrêter un éditeur de spoule

En bref

La commande ENDWTR (Arrêter un éditeur de spoule) permet d'arrêter l'éditeur indiqué et rend disponible l'unité de sortie qui lui est associée.

ENDWTR se lit END (Arrêter) + WTR. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

ENDWTR WTR(…)

Paramètres

WTR Editeur obligatoire
OPTION Option d'arrêt

Astuce : dans une session 5250, tapez ENDWTR 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 ENDWTR (Arrêter un éditeur de spoule) permet d'arrêter l'éditeur indiqué et rend disponible l'unité de sortie qui lui est associée. L'éditeur peut être arrêté immédiatement ou de manière contrôlée. S'il s'arrête immédiatement, il cesse l'écriture du fichier et ce dernier est à nouveau disponible dans la file d'attente en sortie. Si l'éditeur s'arrête de manière contrôlée, il finit d'écrire le fichier en cours (ou l'exemplaire du fichier), ou d'imprimer une page de fichier avant de s'arrêter.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
WTR	Editeur	Nom, ALL, PRT, RMT, SYSVAL	Obligatoire, positionnel 1
OPTION	Option d'arrêt	CNTRLD, IMMED, *PAGEEND	Facultatif, positionnel 2

Editeur (WTR)

Indique l'éditeur de spoule en cours d'arrêt. L'unité de sortie qui lui est associée sera alors disponible pour le système.

Ce paramètre est obligatoire.

nom: Indiquez le nom de l'éditeur à arrêter.
*ALL: Indique que tous les éditeurs doivent s'arrêter.
*PRT: Indique que tous les éditeurs d'imprimante doivent s'arrêter.
*RMT: Indique que tous les éditeurs éloignés doivent s'arrêter.
*SYSVAL: Si un éditeur est démarré pour l'imprimante par défaut du système (valeur système QPRTDEV), cet éditeur sera arrêté.

Option d'arrêt (OPTION)

Indique le moment où l'éditeur doit arrêter le traitement.

*CNTRLD: L'éditeur arrête le traitement de manière contrôlée. La sortie cesse à la fin du fichier spoule (ou de l'exemplaire du fichier) en cours d'écriture sur une unité de sortie.
*IMMED: L'éditeur arrête le traitement immédiatement. Le fichier spoule en cours d'impression reste dans la file d'attente en sortie.
*PAGEEND: L'éditeur est arrêté à la fin du traitement de la mémoire tampon en cours. Cette valeur n'est admise que si l'éditeur de spoule est un éditeur imprimante.

Exemples

Exemple 1 : Arrêter un éditeur spécifique

ENDWTR   WTR(PRINTER) OPTION(*CNTRLD)

Cette commande permet d'arrêter l'éditeur PRINTER à la fin du fichier spoule dont la sortie est en cours d'impression, puis de libérer cette unité sur le système.

Exemple 2 : Arrêter tous les éditeurs d'imprimante immédiatement

ENDWTR   WTR(*PRT) OPTION(*IMMED)

Cette commande permet de demander l'arrêt immédiat de tous les éditeurs d'imprimante. Les éditeurs éloignés ne sont pas affectés.

Messages d'erreur

Messages *ESCAPE

CPF1317: Aucune réponse du sous-système pour le travail &3/&2/&1.
CPF1340: Fonction de contrôle de travail non effectuée.
CPF1352: Fonction non exécutée. &3/&2/&1 en transition.
CPF1842: Impossible d'accéder à la valeur système &1.
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.
CPF3339: Demande précédente d'arrêt de l'éditeur &3/&2/&1 en instance.
CPF3438: *PAGEEND incorrect pour l'éditeur &3/&2/&1.