STRPRTWTR
Démarrer un éditeur imprimante
En bref
La commande STRPRTWTR (Démarrer un éditeur sur une imprimante) permet de démarrer un éditeur de spoule sur l'imprimante indiquée.
STRPRTWTR se lit STR
(Démarrer) + PRTWTR.
Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.
Syntaxe minimale
STRPRTWTR DEV(…)
Paramètres
-
DEVImprimante obligatoire -
OUTQFile d'attente en sortie -
MSGQFile d'attente de messages -
FORMTYPEOptions type d'imprimé -
FILESEPNombre de séparateurs -
SEPDRAWERTiroir des séparateurs -
WTREditeur -
AUTOENDOptions d'arrêt automatique -
ALWDRTPRTImpression directe possible -
ALIGNAlignement page -
INITInitialiser imprimante -
FILEFichier spoule -
JOBTravail -
SPLNBRNuméro de fichier spoule -
JOBSYSNAMENom de système de travail -
CRTDATEFichier spoule créé -
PAGEPage de début
Astuce : dans une session 5250, tapez STRPRTWTR 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 STRPRTWTR (Démarrer un éditeur sur une imprimante) permet de démarrer un éditeur de spoule sur l'imprimante indiquée. L'éditeur, qui est un travail système, prend les fichiers spoule dans une file d'attente en sortie, puis produit (écrit) la sortie sur l'imprimante. Cette commande permet d'indiquer le nom de l'imprimante, de la file d'attente de messages et de la file d'attente en sortie utilisées ainsi que le nom de l'éditeur.
Plusieurs éditeurs peuvent être actifs en même temps (en fonction des spécifications définies dans la description du sous-système spoule), et jusqu'à 10 éditeurs peuvent être actifs dans la même file d'attente en sortie. Chaque éditeur doit avoir un nom et une unité spécifiques, et un seul type d'éditeur (imprimante, éloigné ou disquette) peut être actif dans une même file d'attente en sortie. Un éditeur démarré peut être soit en cours d'écriture, soit en attente de fichier. Il peut être modifié, suspendu ou annulé à l'aide des commandes CHGWTR (Modifier un éditeur de spoule), HLDWTR (Suspendre un éditeur de spoule), ou ENDWTR (Arrêter un éditeur de spoule). Chaque éditeur fonctionnant indépendamment du travail qui l'a démarré, vous pouvez passer à une autre tâche après avoir lancé l'éditeur.
Paramètres
| Mot-clé | Description | Valeurs possibles | Remarques |
|---|---|---|---|
| DEV | Imprimante | Nom, *ALL, *SYSVAL | Obligatoire, positionnel 1 |
| OUTQ | File d'attente en sortie | Valeurs uniques: *DEV Autres valeurs: Nom d'objet qualifié |
Facultatif, positionnel 2 |
| Qualificatif 1: File d'attente en sortie | Nom | ||
| Qualificatif 2: Biblio | Nom, *LIBL, *CURLIB | ||
| MSGQ | File d'attente de messages | Valeurs uniques: *DEVD, *REQUESTER Autres valeurs: Nom d'objet qualifié |
Facultatif, positionnel 4 |
| Qualificatif 1: File d'attente de messages | Nom | ||
| Qualificatif 2: Biblio | Nom, *LIBL, *CURLIB | ||
| FORMTYPE | Options type d'imprimé | Liste d'éléments | Facultatif |
| Élément 1: Type d'imprimé | Valeur caractère, *ALL, *STD, *FORMS | ||
| Élément 2: Option message | *INQMSG, *MSG, *NOMSG, *INFOMSG | ||
| FILESEP | Nombre de séparateurs | 0-9, *FILE | Facultatif |
| SEPDRAWER | Tiroir des séparateurs | 1-255, *DEVD, *FILE | Facultatif |
| WTR | Editeur | Nom, *DEV | Facultatif, positionnel 3 |
| AUTOEND | Options d'arrêt automatique | Liste d'éléments | Facultatif, positionnel 5 |
| Élément 1: Arrêt automatique de l'éditeur | *NO, *YES | ||
| Élément 2: Si oui, option d'arrêt | *NORDYF, *FILEEND | ||
| ALWDRTPRT | Impression directe possible | *NO, *YES | Facultatif |
| ALIGN | Alignement page | *FILE, *WTR, *FIRST | Facultatif |
| INIT | Initialiser imprimante | *WTR, *FIRST, *ALL | Facultatif |
| FILE | Fichier spoule | Nom, *NONE, *LAST | Facultatif |
| JOB | Travail | Valeurs uniques: * Autres valeurs: Nom de travail qualifié |
Facultatif |
| Qualificatif 1: Travail | Nom | ||
| Qualificatif 2: Utilisat | Nom | ||
| Qualificatif 3: Numéro | 000000-999999 | ||
| SPLNBR | Numéro de fichier spoule | 1-999999, *ONLY, *LAST, *ANY | Facultatif |
| JOBSYSNAME | Nom de système de travail | Nom, *ONLY, *CURRENT, *ANY | Facultatif |
| CRTDATE | Fichier spoule créé | Valeurs uniques: *ONLY, *LAST Autres valeurs: Liste d'éléments |
Facultatif |
| Élément 1: Date de création | Date | ||
| Élément 2: Heure de création | Heure, *ONLY, *LAST | ||
| PAGE | Page de début | Entier, *BEGIN | Facultatif |
Imprimante (DEV)
Indique l'imprimante utilisée pour l'impression du fichier spoule. L'imprimante doit être disponible avant le lancement de l'éditeur.
Ce paramètre est obligatoire.
- *ALL
- Démarre un éditeur pour chaque imprimante configurée sur le système.
- *SYSVAL
- Démarre un éditeur pour l'imprimante système par défaut.
- nom
- Indiquez le nom désignant l'imprimante utilisée.
File d'attente en sortie (OUTQ)
Indique la file d'attente en sortie contenant les fichiers spoule traités par l'éditeur.
Valeurs uniques
- *DEV
- La file d'attente en sortie associée à l'imprimante indiquée au paramètre DEV (Imprimante) est utilisée.
Qualificatif 1 : File d'attente en sortie
- nom
- Indiquez le nom de la file d'attente en sortie contenant les fichiers spoule traités par l'éditeur.
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.
File d'attente de messages (MSGQ)
Indique le nom de la file d'attente de messages utilisée par cet utilisateur.
Valeurs uniques
- *DEVD
- Les messages sont envoyés dans la file d'attente de messages indiquée dans la description de l'imprimante.
- *REQUESTER
- Les messages sont envoyés dans la file d'attente de messages du poste de travail de l'utilisateur ayant lancé l'opération. Dans le cas d'un travail par lots, la valeur *DEVD est utilisée.
Qualificatif 1 : File d'attente de messages
- nom
- Indiquez le nom de la file d'attente de messages dans laquelle doivent être envoyés les messages de l'éditeur.
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 de messages 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 de messages.
Options type d'imprimé (FORMTYPE)
Indique le type d'imprimé choisi pour l'impression. Ce paramètre indique que seuls les fichiers avec ce type d'imprimé sont traités. Les autres sont disponibles dans la file d'attente en sortie. Si vous désirez modifier le type d'imprimé après le démarrage de l'éditeur, utilisez la commande CHGWTR (Modifier un éditeur de 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é
- *ALL
- Tous les fichiers disponibles dans la file d'attente en sortie seront traités, quel que soit leur type d'imprimé.
- *FORMS
- Tous les fichiers disponibles dans la file d'attente en sortie pour lesquels le type de papier est identique sont traités en un même groupe avant que l'éditeur passe au type de papier suivant. L'éditeur choisit le premier fichier disponible dans la file d'attente et, une fois celui-ci traité, passe aux autres fichiers associés à ce type de papier. Ensuite, il prend à 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é des fichiers spoule que vous voulez traiter.
Elément 2 : Option message
- *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 comment gérer le nombre de séparateurs de fichiers imprimés avant chaque fichier.
- *FILE
- Le nombre de séparateurs indiqué pour chaque fichier est utilisé.
- 0-9
- Indiquez le nombre de pages de séparation à imprimer. Chaque fois que vous répondez à un message indiquant qu'un nouveau type de papier est utilisé par l'imprimante, un message d'interrogation émis par l'éditeur vous demande combien de pages intercalaires doivent être imprimées avec ce nouveau type de papier.
Tiroir des séparateurs (SEPDRAWER)
Indique le tiroir utilisé pour l'impression des séparateurs de fichiers et de travaux.
- *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.
Editeur (WTR)
Indique le nom de l'éditeur de spoule à démarrer. Chaque nom doit être unique.
- *DEV
- Le nom de l'éditeur est identique à celui de l'imprimante indiquée au paramètre DEV (Imprimante).
- nom
- Indiquez le nom de l'éditeur à démarrer.
Options d'arrêt automatique (AUTOEND)
Indique si l'éditeur s'arrête automatiquement.
Elément 1 : Arrêt automatique de l'éditeur
- *NO
- L'éditeur ne s'arrête pas lorsque le dernier fichier disponible est enlevé de la file d'attente en sortie ; il attend qu'un autre fichier spoule soit placé dans la file d'attente.
- *YES
- L'éditeur s'arrête automatiquement lorsqu'il a atteint l'état indiqué dans la seconde partie de ce paramètre.
Elément 2 : Si oui, option d'arrêt
- *NORDYF
- L'éditeur s'arrête automatiquement lorsque aucun fichier n'est disponible (tous les fichiers disponibles ayant été supprimés de la file d'attente en sortie).
- *FILEEND
- L'éditeur s'arrête automatiquement dès qu'il a fini de traiter un fichier spoule.
Impression directe possible (ALWDRTPRT)
Précise si l'éditeur d'imprimante admet l'impression directe des fichiers sur l'imprimante. L'indication de la valeur SPOOL(*NO) pour un fichier imprimante permet de créer un fichier à impression directe. Lorsque l'impression directe est admise, le fichier est imprimé immédiatement si l'imprimante est disponible ; si elle est occupée, il reste en attente jusqu'à ce qu'elle soit disponible. Le délai d'attente maximal est indiqué au paramètre WAITFILE du fichier imprimante. Passé ce délai, le travail est automatiquement annulé. Seule la commande ENDJOB (Arrêter un travail) permet d'annuler un fichier imprimante non traité en différé.
- *NO
- L'imprimante n'admet pas les fichiers non traités en différé.
- *YES
- L'imprimante peut être utilisée pour imprimer des sorties traitées en différé ou non. Pour définir la valeur du paramètre WAITFILE, reportez-vous à l'aide sur les commandes CRTPRTF (Créer un fichier imprimante), CHGPRTF (Modifier un fichier imprimante) ou OVRPRTF (Substituer un fichier imprimante).
Remarque :Les fichiers non traités en différé restent en attente pendant 30 secondes, même si la valeur indiquée au paramètre WAITFILE est inférieure à cette durée.
Alignement page (ALIGN)
Indique comment gérer l'alignement du papier.
- *WTR
- L'éditeur assure le suivi des sorties imprimées et émet un message d'alignement de papier chaque fois que cela s'avère nécessaire.
- *FILE
- Le message d'alignement de papier est destiné à tous les fichiers pour lesquels *YES est indiqué en regard de l'invite Alignement page (paramètre ALIGN). Cette option est conseillée chaque fois que le contrôle automatique de l'alignement de papier effectué par l'éditeur ne s'avère pas satisfaisant.
- *FIRST
- Le message concernant l'alignement de papier s'affiche seulement lorsque le premier fichier est imprimé. Il ne s'affiche plus lorsque d'autres erreurs se produisent sur l'imprimante.
Initialiser imprimante (INIT)
Indique la fréquence d'initialisation de l'unité imprimante.
Remarque :Ce paramètre est ignoré si TRANSFORM(*YES) ou un programme de conversion utilisateur a été indiqué dans la description d'unité imprimante.
- *WTR
- L'éditeur initialise l'unité imprimante lorsque cela est nécessaire.
- *FIRST
- L'éditeur initialise l'unité imprimante uniquement avant l'impression du premier fichier ou en cas d'erreur au niveau de l'unité.
- *ALL
- L'éditeur initialise l'unité imprimante avant que chaque fichier et exemplaire de fichier ne soient imprimés.
Fichier spoule (FILE)
Indique le premier (ou l'unique) fichier spoule devant être imprimé. Si plusieurs fichiers sont disponibles dans la file d'attente en sortie, le premier fichier imprimé est celui dont le niveau de priorité est le plus élevé.
- *NONE
- Aucun nom de fichier spoule n'est indiqué ; le premier fichier spoule disponible dans la file d'attente en sortie est traité.
- *LAST
- L'impression du fichier spoule en cours lorsque l'éditeur s'est arrêté reprendra au redémarrage de ce dernier.
- nom
- Indiquez le nom du premier (ou de l'unique) fichier spoule à imprimer.
Travail (JOB)
Indique le nom du travail ayant créé le fichier spoule. Ce paramètre n'est admis que si un nom de fichier spoule est précisé au paramètre FILE (Fichier spoule).
Valeurs uniques
- *
- La commande STRPRTWTR (Démarrer un éditeur sur une imprimante) a été lancée par le travail ayant créé le fichier spoule.
Qualificatif 1 : Travail
- nom
- Indiquez le nom du travail ayant créé le fichier spoule. Si vous ne mentionnez aucun autre qualificatif pour le travail, tous les travaux du système sont passés en revue.
Qualificatif 2 : Utilisat
- nom
- Indiquez le nom d'utilisateur qui identifie le profil utilisateur sous lequel le travail est exécuté.
Qualificatif 3 : Numéro
- 000000-999999
- Indiquez le numéro de travail attribué par le système.
Numéro de fichier spoule (SPLNBR)
Indique le numéro du fichier spoule à traiter en priorité. Ce paramètre n'est admis que si un nom de fichier spoule est précisé en regard de l'invite Fichier spoule (paramètre FILE).
- *ONLY
- Un seul fichier spoule du travail porte le nom indiqué ; il n'est donc pas nécessaire de préciser son numéro.
- *LAST
- Le fichier spoule avec le nom indiqué et dont le numéro est le plus élevé est utilisé.
- *ANY
- Le numéro du fichier spoule n'est pas utilisé pour déterminer le fichier spoule en cours d'utilisation. Utilisez cette valeur pour donner la priorité au paramètre du nom du système de travail ou à celui de la date et heure de création du fichier spoule par rapport au le numéro de ce dernier lors de la sélection d'un fichier spoule.
- 1-999999
- Entrez le numéro du fichier à traiter en priorité dans la file d'attente en sortie indiquée.
Nom de système de travail (JOBSYSNAME)
Indique le nom du système où s'exécute le travail ayant créé le fichier spoule (paramètre JOB). Ce paramètre est considéré après que les conditions des paramètres nom du travail, de l'utilisateur, numéro du travail, nom et numéro du fichier spoule sont satisfaites.
- *ONLY
- Il y a un fichier spoule correspondant aux noms de travail, d'utilisateur, numéro de travail, nom et numéro de fichier spoule, date et heure de création de fichier spoule précisés.
- *CURRENT
- Le fichier spoule, créé sur le système en cours, avec ce nom de travail, d'utilisateur, ce numéro de travail, ce nom et numéro de fichier spoule, ces date et heure de création de fichier spoule, est utilisé.
- *ANY
- Le nom du système de travail n'est pas utilisé pour déterminer le fichier spoule en cours d'utilisation. Utilisez cette valeur pour donner la priorité au paramètre de date et heure de création du fichier spoule par rapport au nom du système de travail lors de la sélection d'un fichier spoule.
- nom
- Indiquez le nom du système où s'exécute le travail ayant créé le fichier spoule.
Fichier spoule créé (CRTDATE)
Indique la date et l'heure de création du fichier spoule. Ce paramètre est considéré après que les conditions des paramètres nom du travail, de l'utilisateur, numéro du travail, nom et numéro du fichier spoule et nom du système de travail sont satisfaites.
Valeurs uniques
- *ONLY
- Il y a un fichier spoule correspondant à ces noms de travail, d'utilisateur, numéro de travail, nom et numéro de fichier spoule et nom du système de travail précisés.
- *LAST
- Le fichier spoule, correspondant à la dernière date et heure de création de ces noms de travail, d'utilisateur, numéro de travail, nom et numéro de fichier spoule et nom du système de travail précisés, est utilisé.
Elément 1 : Date de création
- date
- Indiquez la date de création du fichier spoule.
Elément 2 : Heure de création
- *ONLY
- Il y a un fichier spoule correspondant à ces noms de travail, d'utilisateur, numéro de travail, nom et numéro de fichier spoule, nom du fichier de travail et date de création de fichier spoule précisés.
- *LAST
- Le fichier spoule, correspondant à la dernière heure de création de ces noms de travail, d'utilisateur, numéro de travail, nom et numéro de fichier spoule, nom du système de travail et date de création de fichier spoule précisés, est utilisé.
- heure
- Indiquez l'heure de création du fichier spoule.
Page de début (PAGE)
Indique le numéro de la première page devant être imprimée à partir du premier fichier. Ce paramètre n'est admis que si un nom de fichier spoule est précisé en regard de l'invite Fichier spoule (paramètre FILE).
- *BEGIN
- Première page à imprimer.
Remarque :Si cette valeur n'a pas été modifiée à l'aide de la commande CHGSPLFA (Modifier les attributs d'un fichier spoule), le fichier sera imprimé de la même façon que si *BEGIN était indiqué.
- entier
- Indiquez le numéro de la première page à imprimer. Ce nombre doit être compris dans le nombre de pages du fichier.
Exemples
STRPRTWTR DEV(QSYSPRT) OUTQ(QPRINTS) WTR(TOM)
Cette commande permet de démarrer un éditeur de spoule nommé TOM. Cet éditeur prend les données en sortie de la file d'attente en sortie nommée QPRINTS et les imprime sur l'imprimante nommée QSYSPRT. Les messages éditeur sont envoyés dans la file d'attente de messages de l'opérateur système et l'éditeur attend d'autres données en sortie lorsque la file d'attente est vide.
Messages d'erreur
Messages *ESCAPE
- CPF0906
- Nom de travail &3/&2/&1 dupliqué.
- CPF1338
- Erreurs dans la commande SBMJOB.
- CPF1764
- Editeur déjà démarré pour unité &1.
- CPF1842
- Impossible d'accéder à la valeur système &1.
- CPF2115
- Objet &1 de &2 type *&3 endommagé.
- CPF2207
- Non autorisé à utiliser objet &1 de &3 type *&2.
- CPF3303
- Fichier &1 non trouvé dans travail &5/&4/&3.
- CPF3305
- File d'attente en sortie &1 de &2 affectée à un autre éditeur.
- CPF3309
- Aucun fichier portant le nom &1 n'est actif.
- CPF3310
- Editeur &1 déjà démarré.
- CPF3330
- Ressource nécessaire non disponible.
- CPF3340
- Plusieurs fichiers du nom indiqué dans travail &5/&4/&3.
- CPF3342
- Travail &5/&4/&3 non trouvé.
- CPF3343
- Plusieurs travaux portant le même nom.
- CPF3347
- Unité &1 non trouvée.
- CPF3357
- File d'attente en sortie &1 de &2 non trouvée.
- CPF3362
- Objets dans QTEMP incorrects comme valeurs de paramètres.
- CPF3363
- File d'attente de messages &1 non trouvée dans &2.
- CPF3369
- L'unité &1 n'est pas une imprimante.
- CPF336B
- Programme d'exit de pilote &1 de &2 non trouvé ou non autorisé.
- CPF3418
- Fichier &1 numéro &2 trouvé dans le travail.
- CPF346A
- Programme d'exit de conversion &1 de &2 non trouvé ou utilisateur non autorisé.
- CPF346B
- Programme d'exit de pilote &1 de &2 non trouvé ou utilisateur non autorisé.
- 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.
- CPF3478
- Fichier &1 non trouvé dans travail &5/&4/&3 en file d'attente en sortie &6 de &7.
© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.