Aller au contenu

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

  • OUTQ File d'attente en sortie obligatoire
  • MSGQ File d'attente de messages
  • FORMTYPE Options type d'imprimé
  • WTR Editeur
  • AUTOEND Options 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.