SBMDBJOB

Soumettre des travaux BD

En bref

La commande SBMDBJOB (Soumettre des travaux à partir de la base de données) vous permet de soumettre des travaux par lots à des files d'attente de travaux.

SBMDBJOB se lit SBM (Soumettre) + DBJOB. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

SBMDBJOB FILE(…)

Paramètres

FILE Fichier base de données obligatoire
MBR Membre
JOBQ File d'attente de travaux
DSPSBMJOB Affichage par WRKSBMJOB

Astuce : dans une session 5250, tapez SBMDBJOB 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 SBMDBJOB (Soumettre des travaux à partir de la base de données) vous permet de soumettre des travaux par lots à des files d'attente de travaux. Le flot de données en entrée est lu soit à partir d'un fichier base de données physique, soit à partir d'un fichier base de données logique ayant un seul format d'enregistrement. Cette commande vous permet d'indiquer le nom du fichier base de données, son membre, le nom de la file d'attente de travaux utilisée, et de préciser si le travail soumis peut être affiché ou non par la commande WRKSBMJOB (Gérer les travaux soumis).

Une opération de soumission de travaux à partir de la base de données lit le fichier une fois et s'arrête lorsqu'elle détecte le caractère de fin de fichier ou la commande ENDINP. Cette dernière (délimiteur) n'est pas reconnue si elle se trouve dans un fichier spoule en entrée se terminant par des caractères autres que des caractères de fin par défaut (comme indiqué au paramètre ENDCHAR de la commande DATA). L'opération SBMDBJOB peut être annulée par l'annulation de la demande à partir du menu d'appel système, ou du travail dans lequel le traitement s'exécute.

A la différence du lecteur de spoule démarré par la commande STRDBRDR (Démarrer un lecteur de base de données), la commande SBMDBJOB s'exécute lors du traitement de la fonction demandeur et ne procède à aucune vérification syntaxique sur le flot de données.

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, positionnel 3
	Qualificatif 1: File d'attente de travaux	Nom, QBATCH
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
DSPSBMJOB	Affichage par WRKSBMJOB	YES, NO	Facultatif

Fichier base de données (FILE)

Indique le fichier base de données à partir duquel est lu le flot de travaux en entrée.

Ce paramètre est obligatoire.

Qualificatif 1 : Fichier base de données

nom: Indiquez le nom du fichier base de données contenant le flot de travaux en entrée que vous voulez lire.

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. Si celle-ci ne figure pas dans la liste des bibliothèques, QGPL est prise par défaut.
nom: Indiquez la bibliothèque dans laquelle se trouve le fichier.

Membre (MBR)

Indique le membre du fichier précisé contenant le flot de travaux en entrée à lire.

*FIRST: Aucun nom de membre n'est indiqué : 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 sont placés les postes travaux. Un poste travail est placé dans cette file d'attente pour chaque travail du flot de travaux en entrée pour lequel la valeur JOBQ(*RDR) est indiquée dans la commande BCHJOB (Travail par lots). Si *RDR n'est pas spécifié avec la commande BCHJOB, la file d'attente de travaux spécifiée avec la commande BCHJOB ou dans la description de travail est utilisée (la file d'attente de travaux peut être différente pour chaque travail du flot en entrée). Ce paramètre n'est admis que si la valeur ACTION(*SUBMIT) est indiquée dans le poste travaux du réseau existant ou dans une commande CHGNETJOBE (Modifier un poste travaux du réseau) ultérieure.

Remarque :Si l'utilisateur identifié dans la description du travail en cours de lecture et l'utilisateur lançant la commande SBMDBJOB (Soumettre des travaux BD) ne disposent pas de droits sur la file d'attente dans laquelle le travail doit être placé, ce dernier s'arrête et un message de diagnostic est placé dans l'historique du travail. Le traitement du flot de travaux en entrée se poursuit avec le travail suivant. Si l'un des utilisateurs dispose de droits sur la file d'attente de travaux, le travail s'exécute sans erreur.

Qualificateur 1 : File d'attente de travaux

QBATCH: Le travail doit être placé dans la file d'attente QBATCH, qui est la file d'attente de travaux par défaut. C'est le cas si *RDR est indiqué au paramètre JOBQ (File d'attente de travaux) de la commande BCHJOB (Travail par lots). Cette commande fait partie du flot de travaux en entrée.
nom: Indiquez le nom de la file d'attente de travaux dans laquelle seront envoyés les travaux constituant le flot de travaux en entrée. C'est le cas si *RDR est indiqué au paramètre JOBQ de la commande BCHJOB (Travail par lots).

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.

Affichage par WRKSBMJOB (DSPSBMJOB)

Indique si les travaux en cours de soumission sont affichés sur l'écran Affichage des travaux soumis. Si *YES est indiqué pour ce paramètre, les travaux soumis pourront être affichés à l'aide de la commande WRKSBMJOB (Gérer les travaux soumis).

*YES: Ce travail peut être affiché à l'aide de la commande WRKSBMJOB (Gérer les travaux soumis).
*NO: Ce travail ne peut être affiché sur aucun écran obtenu à partir de la commande WRKSBMJOB (Gérer les travaux soumis).

Exemples

SBMDBJOB   FILE(QGPL/BILLING)

Cette commande permet de soumettre des travaux en utilisant les données en entrée du fichier base de données nommé BILLING, se trouvant dans la bibliothèque QGPL. Le premier membre du fichier BILLING contient le flot de travaux en entrée à traiter. La file d'attente de travaux par défaut fournie par le système est QBATCH.

Messages d'erreur

Messages *ESCAPE

CPF1751: Erreur pendant traitement du travail &3/&2/&1.
CPF1754: Le fichier &1 de &2 n'est pas un fichier base de données ou DDM.
CPF1760: Commande de soumission de travaux non admise.
CPF2207: Non autorisé à utiliser objet &1 de &3 type *&2.
CPF3307: File d'attente de travaux &1 de &2 non trouvée.
CPF3330: Ressource nécessaire non disponible.
CPF3363: File d'attente de messages &1 non trouvée dans &2.
CPF9802: Non autorisé à l'objet &2 de &3.
CPF9812: Fichier &1 non trouvé dans la bibliothèque &2.
CPF9815: Membre &5 du fichier &2 dans &3 non trouvé.
CPF9845: Erreur lors de l'ouverture du fichier &1.
CPF9846: Erreur lors du traitement du fichier &1 de &2.

*STATUS Messages

CPF1762: Lecture du travail &3/&2/&1.