CHGWTR

Modifier un éditeur de spoule

En bref

La commande CHGWTR (Modifier un éditeur de spoule) permet de modifier les attributs suivants d'un éditeur actif :

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

Syntaxe minimale

CHGWTR WTR(…)

Paramètres

WTR Editeur obligatoire
OUTQ File d'attente en sortie
FORMTYPE Options type d'imprimé
FILESEP Nombre de séparateurs
SEPDRAWER Tiroir des séparateurs
OPTION Option de modification

Astuce : dans une session 5250, tapez CHGWTR 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 CHGWTR (Modifier un éditeur de spoule) permet de modifier les attributs suivants d'un éditeur actif :

le type d'imprimé,
le nombre de séparateurs de fichiers,
la file d'attente en sortie.

Cette commande vous permet de traiter ensemble tous les fichiers d'un type d'imprimé donné. Les fichiers spoule n'étant pas nécessairement classés par type d'imprimé au sein de la file d'attente en sortie, cette commande vous aide à mieux gérer vos sorties en vous évitant de changer continuellement d'imprimé. Elle vous permet également d'utiliser une autre file d'attente en sortie pour la même imprimante sans avoir à chaque fois à arrêter et démarrer l'éditeur.

Si des modifications sont effectuées alors que l'éditeur est à l'état suspendu (HLD), elles ne s'appliqueront qu'après la libération de l'éditeur. Elles seront alors effectuées selon la valeur indiquée au paramètre OPTION.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
WTR	Editeur	Nom, *SYSVAL	Obligatoire, positionnel 1
OUTQ	File d'attente en sortie	Valeurs uniques: SAME, DEV Autres valeurs: Nom d'objet qualifié	Facultatif, positionnel 2
	Qualificatif 1: File d'attente en sortie	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
FORMTYPE	Options type d'imprimé	Liste d'éléments	Facultatif, positionnel 3
	Élément 1: Type d'imprimé	Valeur caractère, SAME, ALL, STD, FORMS
	Élément 2: Option message	SAME, INQMSG, MSG, NOMSG, *INFOMSG
FILESEP	Nombre de séparateurs	0-9, SAME, FILE	Facultatif
SEPDRAWER	Tiroir des séparateurs	1-255, SAME, DEVD, *FILE	Facultatif
OPTION	Option de modification	NORDYF, FILEEND	Facultatif

Editeur (WTR)

Indique l'éditeur imprimante en cours de modification.

Ce paramètre est obligatoire.

*SYSVAL: Le nom de l'éditeur démarré sur l'imprimante par défaut doit être changé.
nom: Indiquez le nom de l'éditeur que vous désirez modifier.

File d'attente en sortie (OUTQ)

Indique la file d'attente en sortie que l'éditeur utilisera pour traiter les fichiers spoule. Celle-ci doit être disponible avant la modification de l'éditeur. Si elle se trouve dans un ASP principal ou secondaire, elle doit se trouver dans l'espace de nom de bibliothèque du travail de l'éditeur.

Valeurs uniques

*SAME: La file d'attente en sortie utilisée reste inchangée.

*DEV: Le système utilise la file d'attente en sortie associée à l'imprimante du fichier spoule.

Qualificatif 1 : File d'attente en sortie

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

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 cette dernière n'est pas précisée, QGPL est prise par défaut.
nom: Indiquez le nom de la bibliothèque contenant la file d'attente en sortie.

Options type d'imprimé (FORMTYPE)

Indique le type d'imprimé à utiliser par l'éditeur lors du traitement de la sortie. Le type d'imprimé d'un fichier correspond à celui qui a été utilisé pour générer le fichier spoule.

Remarque :Le message de chargement d'imprimé est émis lorsque le type d'imprimé du fichier spoule à traiter diffère de celui du dernier fichier spoule imprimé sur l'unité. Le dernier type d'imprimé utilisé est conservé à partir de la dernière commande STRPRTWTR, CHGWTR ou VRYCFG lancée.

Observez les exemples suivants :

Le type d'imprimé du dernier fichier spoule sorti sur l'imprimante PRT01 avait la valeur *STD.
L'utilisateur remplace par XYZ le type d'imprimé à utiliser sur PRT01 à l'aide de la commande suivante :
```
CHGWTR  PRT01  FORMTYPE(XYZ)
```
Aucun fichier spoule dont le type d'imprimé est XYZ n'est imprimé sur PRT01.
L'utilisateur envoie alors à PRT01 un fichier spoule dont le type d'imprimé a la valeur *STD. Le message de chargement d'imprimé n'est pas émis malgré l'intervention de la commande CHGWTR, parce que le type d'imprimé du dernier fichier spoule imprimé sur PRT01 était identique à celui du fichier spoule en cours d'impression.
Le message de chargement d'imprimé serait émis si un fichier spoule de type d'imprimé XYZ était imprimé sur PRT01.

Elément 1 : Type d'imprimé

*SAME: La valeur de type d'imprimé en cours reste inchangée.
*ALL: Tous les types d'imprimé sont traités par l'éditeur.
*FORMS: Tous les fichiers disponibles ayant le même type d'imprimé sont traités comme un seul groupe avant que l'éditeur ne passe au type d'imprimé suivant : il choisit d'abord le premier fichier disponible et, une fois celui-ci traité, il passe aux autres fichiers associés à ce type d'imprimé. Ensuite, il choisit à nouveau le premier fichier disponible dans la file d'attente et renouvelle l'opération.
*STD: L'éditeur traite les fichiers spoule dont le type d'imprimé est *STD.
type-papier: Indiquez le type d'imprimé que l'éditeur doit utiliser. Seuls les fichiers avec ce type d'imprimé sont traités.

Elément 2 : Option message

*SAME: L'attribut de message en cours reste inchangé.
*INQMSG: Un message d'interrogation est envoyé en file d'attente de messages lorsqu'un fichier spoule a un type d'imprimé différent de celui de l'imprimante.
*INFOMSG: Un message d'information est envoyé en file d'attente de messages lorsque aucun fichier spoule nécessitant ce type d'imprimé ne subsiste dans la file d'attente en sortie.
*MSG: Un message d'interrogation est envoyé en file d'attente de messages lorsqu'un fichier spoule a un type d'imprimé différent de celui de l'imprimante ; un message d'information est envoyé lorsque aucun fichier spoule nécessitant ce type d'imprimé ne subsiste dans la file d'attente en sortie.
*NOMSG: Aucun message d'interrogation ni d'information n'est envoyé en file d'attente de messages.

Nombre de séparateurs (FILESEP)

Indique le nombre de pages de séparation à imprimer avant chaque fichier.

*SAME: Le nombre de séparateurs de fichiers reste inchangé.
*FILE: Imprime le nombre de pages de séparation indiqué pour chaque fichier.
0-9: Indiquez le nombre de pages de séparation de fichiers à imprimer.

Tiroir des séparateurs (SEPDRAWER)

Indique le tiroir utilisé pour l'impression des séparateurs.

*SAME: Le tiroir indiqué pour les pages de séparation reste inchangé.
*DEVD: La valeur indiquée dans la description d'unité de l'imprimante est utilisée.
*FILE: Les pages de séparation sont imprimées à partir du même tiroir que le fichier spoule.
1: Les pages de séparation sont imprimées à partir du tiroir n°1.
2: Les pages de séparation sont imprimées à partir du tiroir n°2.
3: Les pages de séparation sont imprimées à partir du tiroir n°3.
1-255: Indiquez un nombre pour identifier le tiroir à utiliser pour l'impression des pages de séparation.
Remarque :Pour certaines imprimantes, le paramètre SEPDRAWER(3) implique la présence d'un tiroir d'enveloppes.

Option de modification (OPTION)

Indique le moment où la modification se produit.

*NORDYF: La modification se produit lorsque aucun des fichiers de la file d'attente en sortie ne correspond aux critères de sélection du type de papier en cours pour l'éditeur.
*FILEEND: La modification se produit à la fin du fichier en cours (par exemple, lorsque l'impression en cours est terminée).

Exemples

CHGWTR   WTR(MYWTR)  FORMTYPE(MYFORM *NOMSG)  OPTION(*FILEEND)

Cette commande permet de spécifier que l'éditeur MYWTR génère, au lieu de fichiers d'un autre type d'imprimé, des fichiers de type d'imprimé MYFORM en fin de fichier. Elle empêche également l'éditeur d'envoyer un message d'information lorsqu'il n'a plus de fichiers dont le type d'imprimé est MYFORM.

Messages d'erreur

Messages *ESCAPE

CPF1842: Impossible d'accéder à la valeur système &1.
CPF2207: Non autorisé à utiliser objet &1 de &3 type *&2.
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.
CPF3357: File d'attente en sortie &1 de &2 non trouvée.
CPF3456: Impossible de modifier éditeur &1 pour file de sortie &4 de &5.
CPF3457: Impossible de modifier l'éditeur &1.
CPF3458: Modification de l'éditeur &1 non admise. Arrêt en cours.
CPF3459: Editeur &1 ne peut pas être modifié.
CPF3460: Modification de l'éditeur &1 non admise.
CPF3463: File d'attente en sortie non trouvée pour unité &1.
CPF3464: Pas les droits requis sur la file d'attente en sortie &1 de &2.
CPF9803: Impossible d'allouer l'objet &2 de la bibliothèque &3.