Aller au contenu

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

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 :

  1. Le type d'imprimé du dernier fichier spoule sorti sur l'imprimante PRT01 avait la valeur *STD.
  2. L'utilisateur remplace par XYZ le type d'imprimé à utiliser sur PRT01 à l'aide de la commande suivante :

    CHGWTR  PRT01  FORMTYPE(XYZ)
    

  3. Aucun fichier spoule dont le type d'imprimé est XYZ n'est imprimé sur PRT01.
  4. 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.