RLSWTR

Libérer un éditeur de spoule

En bref

La commande RLSWTR (Libérer un éditeur) permet de libérer un éditeur suspendu afin de permettre le traitement des fichiers figurant dans la file d'attente en sortie.

RLSWTR se lit RLS (Libérer) + WTR. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

RLSWTR WTR(…)

Paramètres

WTR Editeur obligatoire
OPTION Position de reprise
PAGE Page de début

Astuce : dans une session 5250, tapez RLSWTR 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 RLSWTR (Libérer un éditeur) permet de libérer un éditeur suspendu afin de permettre le traitement des fichiers figurant dans la file d'attente en sortie. Si l'éditeur est en train d'écrire un fichier au moment de sa suspension, il pourra être libéré soit pour reprendre l'écriture de celui-ci, soit pour commencer l'écriture d'un nouveau fichier. Les données en cours d'écriture au moment où la commande HLDWTR (Suspendre un éditeur) est lancée ne sont pas perdues.

Remarque :Vous devez indiquer une valeur soit au paramètre OPTION (Position de reprise) soit au paramètre PAGE (Page de début). Vous ne pouvez pas indiquer une valeur aux deux paramètres.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
WTR	Editeur	Nom	Obligatoire, positionnel 1
OPTION	Position de reprise	-32766-32766, CURRENT, BEGIN, *BYPASS	Facultatif
PAGE	Page de début	Entier	Facultatif

Editeur (WTR)

Indique l'éditeur de spoule à libérer. Après la libération, vous pouvez traiter les fichiers figurant dans la file d'attente en sortie (à condition que celle-ci ne soit pas suspendue).

Ce paramètre est obligatoire.

nom: Indiquez le nom de l'éditeur à libérer.

Position de reprise (OPTION)

Indique l'endroit du fichier où l'éditeur doit redémarrer. Seule l'option *CURRENT peut être indiquée lorsque l'éditeur n'imprime pas de fichier. Les trois dernières options (*BYPASS, +nombre, et -nombre) ne peuvent être indiquées que si l'éditeur a été suspendu pendant l'impression du fichier. La seule option admise pour un éditeur disquette est *CURRENT.

*CURRENT: L'éditeur est libéré à l'endroit où il a été suspendu par la commande HLDWTR (Suspendre un éditeur).
*BEGIN: L'éditeur est libéré au début du fichier en cours.
*BYPASS: L'éditeur est libéré au début du fichier suivant. Le fichier en cours est suspendu en file d'attente.
+nombre: L'éditeur est libéré n pages après l'endroit où il a été suspendu.
-nombre: L'éditeur doit être libéré n pages avant l'endroit où il a été suspendu.

Page de début (PAGE)

Indique la page où l'éditeur commence l'impression. Ce paramètre est incompatible avec le paramètre OPTION (Position de reprise) et n'est admis que pour un éditeur d'imprimante. Ce paramètre ne peut être indiqué que si l'éditeur est suspendu lors de l'impression du fichier.

entier: Indiquez le numéro de page où vous voulez que l'éditeur commence son impression.

Exemples

Exemple 1 : Libération d'un éditeur en début de fichier

RLSWTR   WTR(PRINTER)  OPTION(*BEGIN)

Cette commande permet de libérer l'éditeur PRINTER pour commencer à générer le fichier en cours à son début.

Exemple 2 : Libération d'un éditeur à un point spécifié

RLSWTR   WTR(PRTR)  OPTION(-3)

Cette commande permet de libérer l'éditeur PRTR pour reprendre l'impression trois pages avant le point auquel l'éditeur a été suspendu. Autrement dit, les trois dernières pages imprimées deviennent alors les trois premières pages imprimées.

Exemple 3 : Début de l'impression à la page dix

RLSWTR   WTR(PRTR)  PAGE(10)

Cette commande permet de libérer l'éditeur PRTR pour reprendre l'impression à la page dix.

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.
CPF3313: Editeur &1 non actif ni en file d'attente de travaux.
CPF3314: Paramètre PAGE admis uniquement pour les éditeurs imprimante.
CPF3316: Editeur &3/&2/&1 non libéré car non suspendu.
CPF3317: Valeur du paramètre OPTION incompatible avec éditeur disquette.
CPF3330: Ressource nécessaire non disponible.
CPF3331: Vous n'êtes pas autorisé à contrôler l'éditeur &3/&2/&1.
CPF3334: Editeur &3/&2/&1 en instance de suspension.