STRDKTWTR

Démarrer un éditeur disquette

En bref

La commande STRDKTWTR (Démarrer un éditeur sur une disquette) permet de démarrer un éditeur sur l'unité de disquette indiquée.

STRDKTWTR se lit STR (Démarrer) + DKTWTR. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

STRDKTWTR DEV(…) OUTQ(…)

Paramètres

DEV Unité disquette obligatoire
OUTQ File d'attente en sortie obligatoire
MSGQ File d'attente de messages
WTR Editeur
AUTOEND Options d'arrêt automatique
FILE Fichier spoule
JOB Travail
SPLNBR Numéro de fichier spoule

Astuce : dans une session 5250, tapez STRDKTWTR 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 STRDKTWTR (Démarrer un éditeur sur une disquette) permet de démarrer un éditeur sur l'unité de disquette indiquée. L'éditeur prend les fichiers spoule dans une file d'attente en sortie, puis écrit la sortie sur l'unité de disquette. Cette commande permet d'indiquer les noms de l'unité de disquette, de l'éditeur et des files d'attente de messages et de sortie utilisées.

Plusieurs éditeurs peuvent être actifs en même temps (selon les spécifications définies dans la description de sous-système du spoule). Un éditeur peut également être suspendu ou arrêté à l'aide des commandes 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é, l'utilisateur peut passer à une autre tâche après avoir lancé l'éditeur.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
DEV	Unité disquette	Nom	Obligatoire, positionnel 1
OUTQ	File d'attente en sortie	Nom d'objet qualifié	Obligatoire, positionnel 2
	Qualificatif 1: File d'attente en sortie	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
MSGQ	File d'attente de messages	Valeurs uniques: REQUESTER, DEVD Autres valeurs: Nom d'objet qualifié	Facultatif, positionnel 4
	Qualificatif 1: File d'attente de messages	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
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
FILE	Fichier spoule	Nom, *NONE	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	Facultatif

Unité disquette (DEV)

Ce paramètre est obligatoire.

Indique le nom de l'unité de disquette destinée à recevoir la sortie spoule.

nom-unité-disquette: Indiquez le nom de l'unité de disquette vers laquelle sera envoyée la sortie spoule.

File d'attente en sortie (OUTQ)

Ce paramètre est obligatoire.

Indique le nom de la file d'attente en sortie à partir de laquelle l'éditeur traite les fichiers spoule. Cette file doit être disponible lors du démarrage de l'éditeur.

Pour la bibliothèque, les valeurs possibles sont les suivantes :

*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.
nom-bibliothèque: Indiquez 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 dans laquelle doivent être envoyés les messages créés par l'éditeur disquette.

Les valeurs possibles sont les suivantes :

*DEVD: Les messages sont envoyés dans la file d'attente de messages indiquée dans la description d'unité désignée en regard de l'invite Unité disquette (paramètre DEV).
*REQUESTER: Les messages doivent être envoyés dans la file d'attente de messages du poste de travail de l'utilisateur ayant démarré l'éditeur. Cette valeur n'est pas admise pour les travaux par lots.
nom-file-attente-messages: Indiquez le nom de la file d'attente de messages dans laquelle doivent être envoyés les messages de l'éditeur disquette.

Pour la bibliothèque, les valeurs possibles sont les suivantes :

*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.
nom-bibliothèque: Indiquez le nom de la bibliothèque contenant la file d'attente de messages.

Editeur (WTR)

Indique le nom de l'éditeur que vous démarrez. Chaque nom doit être unique.

Les valeurs possibles sont les suivantes :

*DEV: Le nom de l'éditeur doit être identique à celui de l'unité de disquette indiqué en regard de l'invite Unité disquette (paramètre DEV).
nom-éditeur: Indiquez le nom de l'éditeur à démarrer.

Options d'arrêt automatique (AUTOEND)

Indique si l'éditeur disquette s'arrête automatiquement lorsqu'il ne reste plus de fichiers spoule à écrire sur l'unité de disquette.

Elément 1 : Option d'arrêt de l'éditeur

*NO: L'éditeur ne s'arrête pas lorsque le dernier poste disponible est supprimé de la file d'attente en sortie ; il attend qu'un autre fichier spoule soit créé dans celle-ci.
*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 : 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 automatiquement dès qu'il a fini de traiter un fichier spoule.

Fichier spoule (FILE)

Indique le nom du premier (ou unique) fichier spoule traité par l'éditeur de spoule et écrit sur la disquette.

Les valeurs possibles sont les suivantes :

*NONE: Aucun nom de fichier spoule n'est indiqué ; le premier fichier spoule disponible dans la file d'attente en sortie est traité.
nom-fichier-spoule: Indiquez le nom du premier (ou unique) fichier spoule écrit sur la disquette.

Travail (JOB)

Indique le nom du travail ayant créé le fichier spoule écrit sur la disquette. Ce paramètre ne sera pas pris en compte si *NONE est indiqué en regard de l'invite Fichier spoule (paramètre FILE).

Les valeurs possibles sont les suivantes :

*: Le fichier spoule a été créé par le travail ayant lancé la commande STRDKTWTR (Démarrer un éditeur sur une disquette).
nom-travail: Indiquez le nom du travail ayant créé le fichier spoule.
nom-utilisateur: Indiquez le nom de l'utilisateur qui identifie le profil utilisateur sous lequel le travail s'exécute.
numéro-travail: 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 indiqué en regard de l'invite Fichier spoule (paramètre FILE).

Les valeurs possibles sont les suivantes :

*ONLY: Un seul fichier spoule porte le nom indiqué dans la file d'attente désignée ; le numéro du fichier spoule n'est pas obligatoire.
*LAST: Le fichier spoule à traiter en priorité est celui qui porte le numéro le plus élevé parmi les fichiers du travail figurant dans la file d'attente désignée et répondant au nom indiqué.
numéro-fichier-spoule: Entrez le numéro du fichier à traiter en priorité dans la file d'attente en sortie indiquée.

Exemples

STRDKTWTR   DEV(QDKT)  OUTQ(QDKT)  AUTOEND(*YES)

Cette commande permet de démarrer un éditeur de spoule sur l'unité de disquette. Les fichiers écrits sur les disquettes se trouvent dans la file d'attente en sortie QDKT fournie par IBM. Une fois tous les fichiers écrits (plus aucune entrée ne se trouve dans la file d'attente en sortie QDKT), l'éditeur est automatiquement arrêté et l'unité de disquette est disponible.

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.
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.
CPF3367: &1 n'est pas une unité de disquette.
CPF3418: Fichier &1 numéro &2 trouvé dans le travail.
CPF3463: File d'attente en sortie non trouvée pour unité &1.
CPF3478: Fichier &1 non trouvé dans travail &5/&4/&3 en file d'attente en sortie &6 de &7.