STRDBRDR

Démarrer un lecteur BD

En bref

La commande STRDBRDR (Démarrer un lecteur à partir de la base de données) permet de démarrer un lecteur de spoule sur un fichier base de données.

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

Syntaxe minimale

STRDBRDR FILE(…)

Paramètres

FILE Fichier base de données obligatoire
MBR Membre
JOBQ File d'attente de travaux
MSGQ File d'attente de messages
RDR Lecteur

Astuce : dans une session 5250, tapez STRDBRDR 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 STRDBRDR (Démarrer un lecteur à partir de la base de données) permet de démarrer un lecteur de spoule sur un fichier base de données. Le lecteur lit le flot de travaux par lots en entrée dans la base de données, puis place les travaux dans une ou plusieurs files d'attente. La commande permet d'indiquer le nom du fichier base de données et du membre dans lequel s'effectue la lecture du flot de travaux, ainsi que le nom du lecteur et celui des files d'attente de messages et de travaux utilisées.

Plusieurs lecteurs peuvent être actifs en même temps (selon les spécifications définies dans la description de sous-système du spoule). Un seul nom peut être indiqué par lecteur de base de données et le fichier ou le membre indiqué doit être disponible. Le lecteur peut également être suspendu ou annulé à l'aide des commandes HLDRDR (Suspendre un lecteur) ou ENDRDR (Arrêter un lecteur).

Chaque lecteur fonctionnant indépendamment du travail qui l'a lancé, l'utilisateur peut passer à une autre tâche après avoir démarré le lecteur.

Restriction : Le fichier base de données indiqué doit être constitué d'enregistrements à zone unique, il doit disposer d'un chemin d'accès par ordre d'arrivée ou bien il doit s'agir d'un fichier base de données source standard.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
FILE	Fichier base de données	Nom d'objet qualifié	Obligatoire, positionnel 1
	Qualificatif 1: Fichier base de données	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
MBR	Membre	Nom, *FIRST	Facultatif, positionnel 2
JOBQ	File d'attente de travaux	Nom d'objet qualifié	Facultatif
	Qualificatif 1: File d'attente de travaux	Nom, QBATCH
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
MSGQ	File d'attente de messages	Valeurs uniques: REQUESTER Autres valeurs: Nom d'objet qualifié*	Facultatif
	Qualificatif 1: File d'attente de messages	Nom, QSYSOPR
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
RDR	Lecteur	Nom, *FILE	Facultatif

Fichier base de données (FILE)

Indique le fichier base de données à partir duquel s'effectue la lecture du flot de travaux en entrée. Le fichier doit être disponible avant le démarrage du lecteur de spoule.

Ce paramètre est obligatoire.

Qualificatif 1 : Fichier base de données

nom: Indiquez le nom du fichier contenant le flot de travaux en entrée lu par le lecteur.

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: Le fichier est recherché dans la bibliothèque en cours pour le travail.
nom: Indiquez la bibliothèque dans laquelle se trouve le fichier.

Membre (MBR)

Indique le membre du fichier désigné contenant le flot de travaux en entrée.

*FIRST: Le premier membre du fichier est utilisé.
nom: Indiquez le nom du membre contenant le flot de travaux en entrée à lire.

File d'attente de travaux (JOBQ)

Indique la file d'attente de travaux dans laquelle le lecteur de spoule va placer des postes. Cette valeur est utilisée si *RDR est indiqué au paramètre JOBQ (File d'attente de travaux) de la commande BCHJOB. (Notez qu'il peut y avoir une file d'attente différente pour chaque travail d'un même flot de travaux).

Qualificateur 1 : File d'attente de travaux

QBATCH: Le travail est placé dans la file d'attente QBATCH.
nom: Indiquez le nom de la file d'attente de travaux utilisée par le lecteur.

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 travaux est recherchée dans la bibliothèque en cours du travail.
nom: Indiquez le nom de la bibliothèque contenant la file d'attente de travaux.

File d'attente de messages (MSGQ)

Indique la file d'attente de messages dans laquelle sont envoyés les messages créés par le lecteur.

Valeurs uniques

*REQUESTER: Les messages sont envoyés dans la file d'attente de messages du poste de travail de l'utilisateur ayant démarré ce lecteur. Si cette valeur est utilisée pour un travail par lots, le message est envoyé dans la file d'attente de messages de l'opérateur système (QSYSOPR).

Qualificatif 1 : File d'attente de messages

QSYSOPR: Les messages sont envoyés dans la file d'attente de messages de l'opérateur système (QSYSOPR).
nom: Indiquez le nom de la file d'attente de messages dans laquelle vous voulez recevoir les messages.

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.

Lecteur (RDR)

Indique le lecteur à démarrer. Un même nom ne peut être indiqué pour plusieurs lecteurs.

*FILE: Le nom du lecteur est identique à celui du fichier base de données indiqué au paramètre FILE (Fichier base de données).
nom: Indiquez le nom désignant le lecteur à démarrer.

Exemples

STRDBRDR   FILE(QGPL/BILLING)

Cette commande permet de démarrer un lecteur de spoule qui lit ses données en entrée dans le fichier base de données nommé BILLING, dans la bibliothèque QGPL. Le nom du lecteur est également BILLING car le paramètre RDR n'est pas défini. Le premier membre du fichier BILLING contient le flot de travaux en entrée à traiter. La file d'attente de travaux par défaut QBATCH et la file d'attente de messages de l'opérateur système, QSYSOPR, fournie par le système, sont utilisées par le lecteur de base de données.

Messages d'erreur

Messages *ESCAPE

CPF1338: Erreurs dans la commande SBMJOB.
CPF2207: Non autorisé à utiliser objet &1 de &3 type *&2.
CPF3301: Lecteur &1 déjà démarré.
CPF3307: File d'attente de travaux &1 de &2 non trouvée.
CPF3330: Ressource nécessaire non disponible.
CPF3362: Objets dans QTEMP incorrects comme valeurs de paramètres.
CPF3363: File d'attente de messages &1 non trouvée dans &2.
CPF3364: Le fichier &1 de &2 n'est pas un fichier base de données ou DDM.
CPF9812: Fichier &1 non trouvé dans la bibliothèque &2.
CPF9815: Membre &5 du fichier &2 dans &3 non trouvé.