STRRMTWTR
Démarrer un éditeur éloigné
En bref
La commande STRRMTWTR démarre un éditeur de spoule qui envoie des fichiers spoule d'une file d'attente en sortie vers un système éloigné.
STRRMTWTR se lit STR
(Démarrer) + RMTWTR.
Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.
Syntaxe minimale
STRRMTWTR OUTQ(…)
Paramètres
-
OUTQFile d'attente en sortie obligatoire -
MSGQFile d'attente de messages -
FORMTYPEOptions type d'imprimé -
WTREditeur -
AUTOENDOptions d'arrêt automatique
Astuce : dans une session 5250, tapez STRRMTWTR 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 STRRMTWTR démarre un éditeur de spoule qui envoie des fichiers spoule d'une file d'attente en sortie vers un système éloigné. L'éditeur de spoule, qui est un travail système, utilise SNADS (Services de distribution SNA) ou TCP/IP.
Lorsque le fichier spoule a été envoyé au système éloigné, il est soit supprimé, soit sauvegardé selon la valeur précisée pour l'attribut de fichier spoule SAVE.
Plusieurs éditeurs peuvent être actifs en même temps (selon la description du sous-système de spoule) et 10 éditeurs au maximum peuvent être actifs pour la même file d'attente en sortie. Chaque éditeur doit avoir un nom unique et un seul type (imprimante, éloigné ou disquette) peut être actif pour une file d'attente spécifique. Lorsqu'un éditeur a été démarré, il peut envoyer des sorties, ou attendre qu'un fichier soit placé dans la file d'attente en sortie. Vous pouvez demander que l'éditeur s'arrête automatiquement lorsqu'il a traité tous les fichiers de la file d'attente, ou bien modifier, suspendre ou annuler cet éditeur.
Une fois l'éditeur démarré, vous pouvez poursuivre d'autres tâches, puisque chaque travail s'exécute de façon indépendante. Le propriétaire de l'éditeur est l'utilisateur qui lance la commande STRRMTWTR.
Paramètres
| Mot-clé | Description | Valeurs possibles | Remarques |
|---|---|---|---|
| OUTQ | File d'attente en sortie | Valeurs uniques: *ALL Autres valeurs: Nom d'objet qualifié |
Obligatoire, positionnel 1 |
| Qualificatif 1: File d'attente en sortie | Nom | ||
| Qualificatif 2: Biblio | Nom, *LIBL, *CURLIB | ||
| MSGQ | File d'attente de messages | Valeurs uniques: *OUTQ, *REQUESTER Autres valeurs: Nom d'objet qualifié |
Facultatif, positionnel 3 |
| 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 | *NOMSG, *INQMSG, *MSG, *INFOMSG | ||
| WTR | Editeur | Nom, *OUTQ, *SYSGEN | Facultatif, positionnel 2 |
| AUTOEND | Options d'arrêt automatique | Liste d'éléments | Facultatif, positionnel 4 |
| Élément 1: Arrêt automatique de l'éditeur | *NO, *YES | ||
| Élément 2: Si oui, option d'arrêt | *NORDYF, *FILEEND |
File d'attente en sortie (OUTQ)
Indique la file d'attente en sortie contenant les fichiers spoule à écrire.
Valeurs uniques
- *ALL
- Démarre les éditeurs éloignés pour chaque file d'attente en sortie sur le système pour lesquels un système éloigné est précisé. Aucun éditeur ne peut être lancé si un autre type d'éditeur a déjà été démarré pour une file d'attente. L'attribut "Editeurs à démarrage automatique" de la file d'attente en sortie détermine le nombre d'éditeurs démarrés pour une file spécifique. Il détermine également le nombre de travaux d'éditeur éloigné qui enverront des fichiers spoule à partir d'une file d'attente en sortie spécifique vers un système éloigné.
Qualificatif 1 : File d'attente en sortie
- nom
- Indiquez le nom de la file d'attente en sortie utilisée par l'éditeur pour le traitement des fichiers de 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 recherche porte sur la bibliothèque en cours de l'unité d'exécution. Si aucune bibliothèque n'est définie comme bibliothèque en cours pour l'unité d'exécution, la recherche porte sur la bibliothèque QGPL.
- nom
- Indiquez le nom de la bibliothèque sur laquelle doit porter la recherche.
File d'attente de messages (MSGQ)
Indique la file d'attente de messages dans laquelle sont envoyés les messages créés par l'éditeur.
Valeurs uniques
- *OUTQ
- Les messages sont envoyés dans la file d'attente de messages associée à la file d'attente en sortie précisée au paramètre OUTQ.
- *REQUESTER
- Les messages sont envoyés dans la file d'attente de messages du poste de travail de l'utilisateur qui a démarré l'éditeur. La valeur *OUTQ est utilisée pour un travail par lots.
Qualificatif 1 : File d'attente de messages
- nom
- Indiquez le nom de la file d'attente de messages destinée à recevoir les messages créé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 recherche porte sur la bibliothèque en cours de l'unité d'exécution. Si aucune bibliothèque n'est définie comme bibliothèque en cours pour l'unité d'exécution, la recherche porte sur la bibliothèque QGPL.
- nom
- Indiquez le nom de la bibliothèque sur laquelle doit porter la recherche.
Options type d'imprimé (FORMTYPE)
Indique le type d'imprimé. L'éditeur utilise cette valeur pour sélectionner les fichiers spoule dans la file d'attente en sortie indiquée et les envoyer au système éloigné.
Remarque :Le type d'imprimé du fichier spoule est précisé dans le fichier unité qui génère ce dernier.
Elément 1 : Type d'imprimé
- *ALL
- Tous les types d'imprimé sont traités par l'éditeur.
- *FORMS
- L'éditeur sélectionne d'abord le premier fichier spoule disponible dans la file d'attente en sortie. Une fois le traitement de ce fichier terminé, tous les fichiers spoule utilisant le même type d'imprimé sont traités. L'éditeur répète ensuite l'opération sur le premier fichier spoule disponible de la file d'attente.
- *STD
- Seuls les fichiers spoule ayant un type d'imprimé standard sont sélectionnés.
- type-imprimé
- Indiquez le type d'imprimé correspondant aux fichiers spoule en cours de création.
Elément 2 : Option message
- *NOMSG
- Aucun message d'interrogation ni d'information n'est envoyé en file d'attente de messages.
- *INQMSG
- Un message d'interrogation est envoyé dans la file d'attente de messages lorsque le type d'imprimé d'un fichier spoule est différent du dernier type d'imprimé envoyé.
- *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é dans la file d'attente de messages lorsque le type d'imprimé d'un fichier spoule est différent du type d'imprimé utilisé sur l'unité éloignée. Un message d'information est envoyé lorsque la file d'attente en sortie ne contient plus aucun fichier spoule nécessitant ce type d'imprimé.
Editeur (WTR)
Indique l'éditeur de spoule en cours de démarrage. Chaque nom doit être unique.
- *OUTQ
- Le nom de l'éditeur est celui de la file d'attente en sortie indiqué au paramètre OUTQ. Si OUTQ(*ALL) est indiqué et que vous devez démarrer plus d'un éditeur, le nom de chacun des éditeurs supplémentaires est formé à l'aide des neuf premiers caractères de la file d'attente, suivis d'un chiffre. Ce dernier chiffre est attribué par ordre séquentiel, en commençant par 2 pour le deuxième éditeur, 3 pour le troisième et ainsi de suite jusqu'à 0 pour le dixième.
- *SYSGEN
- Le nom de l'éditeur est généré par le système, 'RMTW000001' étant attribué au premier éditeur démarré, 'RMTW000002' au deuxième et ainsi de suite.
- nom
- Indiquez le nom utilisé pour l'éditeur à démarrer.
Options d'arrêt automatique (AUTOEND)
Indique si l'éditeur s'arrête automatiquement.
Elément 1 : Option d'arrêt de l'éditeur
- *NO
- L'éditeur ne s'arrête pas lorsque le dernier fichier disponible a été retiré de la file d'attente en sortie. Il est en attente jusqu'à ce qu'un autre fichier spoule soit placé dans la file d'attente. Cette valeur est unique (l'élément 2 n'est pas spécifié).
- *YES
- L'éditeur s'arrête automatiquement lorsqu'il a atteint la condition indiquée dans l'élément 2 de ce paramètre.
Elément 2 : Conditions d'arrêt de l'éditeur
- *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 lorsqu'il a terminé le traitement d'un fichier spoule.
Exemples
STRRMTWTR OUTQ(RMTOUTQ) 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 RMTOUTQ et les envoie au système éloigné et à la file d'attente de l'imprimante spécifiés dans la file d'attente en sortie MTOUTQ. 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
- CPF330A
- RMTSYS égal à *NONE pour file attente en sortie &1.
- CPF3305
- File d'attente en sortie &1 de &2 affectée à un autre éditeur.
- CPF3310
- Editeur &1 déjà démarré.
- 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.
© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.