SBMDKTJOB

Soumettre travaux disquette

En bref

La commande SBMDKTJOB (Soumettre des travaux à partir de disquette) vous permet de soumettre des travaux par lots à des files d'attente de travaux.

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

Syntaxe minimale

SBMDKTJOB DEV(…) LABEL(…)

Paramètres

DEV Unité disquette obligatoire
LABEL Label disquette obligatoire
VOL Volume
JOBQ File d'attente de travaux
MSGQ File attente messages
CRTDATE Date de création
CODE Code
DSPSBMJOB Affichage par WRKSBMJOB

Astuce : dans une session 5250, tapez SBMDKTJOB 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 SBMDKTJOB (Soumettre des travaux à partir de disquette) vous permet de soumettre des travaux par lots à des files d'attente de travaux. Le flot de travaux en entrée est lu à partir d'une disquette. La commande permet d'indiquer :

Le nom de l'unité de disquette
L'identificateur de label
L'identificateur de volume
La date de création
Le type d'échange (EBCDIC ou ASCII)
Le nom de la file d'attente de travaux
Le nom de la file d'attente de messages
Si les travaux soumis peuvent ou non être affichés à l'aide de la commande WRKSBMJOB (Gérer les travaux soumis).

L'opération de soumission de travaux à partir d'une disquette 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 SBMDKTJOB 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 STRDKTRDR (Démarrer un lecteur de disquette), la commande SBMDKTJOB s'exécute lors du traitement de la fonction demandeur et ne procède à aucune vérification syntaxique sur le flot de données.

Remarque :Cette commande ne peut pas être utilisée pour lire des fichiers de données sur disquettes en format sauvegarde/restauration.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
DEV	Unité disquette	Nom	Obligatoire, positionnel 1
LABEL	Label disquette	Valeur caractère	Obligatoire, positionnel 2
VOL	Volume	Valeurs uniques: NONE Autres valeurs (jusqu'à 50 répétitions): Valeur caractère*	Facultatif, positionnel 3
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 attente messages	Valeurs uniques: DEVD, REQUESTER Autres valeurs: Nom d'objet qualifié	Facultatif
	Qualificatif 1: File attente messages	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
CRTDATE	Date de création	Date, *NONE	Facultatif
CODE	Code	EBCDIC, ASCII	Facultatif
DSPSBMJOB	Affichage par WRKSBMJOB	YES, NO	Facultatif

Unité disquette (DEV)

Ce paramètre est obligatoire.

Indique le nom de l'unité de disquette utilisée pour la lecture du flot de travaux en entrée.

nom-unité-disquette: Indiquez le nom de l'unité de disquette.

Label disquette (LABEL)

Ce paramètre est obligatoire.

Indique le label du fichier de données sur la disquette contenant le flot de travaux en entrée. L'identificateur du fichier ne peut pas excéder 8 caractères.

identificateur-fichier-données: Indiquez le nom du fichier de données tel qu'il apparaît sur le label de la disquette.

Volume (VOL)

Indique les identificateurs de volume utilisés pour l'opération. Un volume peut comprendre une ou plusieurs disquettes.

Les valeurs possibles sont les suivantes :

*NONE: Aucun identificateur de volume n'est indiqué : le volume en cours est utilisé.
Identificateur-de-volume: Les identificateurs de volume des disquettes se présentent dans l'ordre où ces dernières seront placées sur l'unité de disquette, puis utilisées. Chaque identificateur contient 6 caractères au maximum. Un blanc est utilisé comme caractère de séparation pour les listes comportant plusieurs identificateurs.

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 SBMDKTJOB (Soumettre des travaux disquette) 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.

Les valeurs possibles sont les suivantes :

QBATCH: Le travail est placé dans la file d'attente QBATCH.
nom-file-attente-travaux: 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.

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

File attente messages (MSGQ)

Indique le nom de la file d'attente de messages dans laquelle doivent être envoyés les messages d'exploitation.

Les valeurs possibles sont les suivantes :

*DEVD: Les messages doivent être envoyés dans la file d'attente en sortie indiquée lors de la création de la description d'unité.
*REQUESTER: Les messages sont envoyés dans la file d'attente de messages du poste de travail de l'utilisateur ayant lancé l'opération. Cette valeur est *DEVD pour les travaux par lots.
nom-file-attente-messages: Indiquez le nom de la file d'attente de messages dans laquelle seront envoyés les messages d'exploitation.

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. Si celle-ci ne figure pas dans la liste des bibliothèques, QGPL est prise par défaut.
nom-bibliothèque: Indiquez le nom de la bibliothèque contenant la file d'attente de messages.

Date de création (CRTDATE)

Indique la date de création du fichier de données sur la disquette.

Remarque :N'indiquez cette date que si vous souhaitez que le système la compare à la date de création écrite sur la disquette.

Les valeurs possibles sont les suivantes :

*NONE: La date de création n'est pas indiquée : aucune vérification n'est effectuée.
date-création: Indiquez la date de création du fichier de données à lire. La date doit être au format utilisé par le système (par exemple, MMJJAA).

Code (CODE)

Indique le type de code caractères utilisé par l'unité de disquette.

Les valeurs possibles sont les suivantes :

*EBCDIC: Le code caractères EBCDIC est utilisé.

*ASCII: Le code caractères ASCII est utilisé.

Affichage par WRKSBMJOB (DSPSBMJOB)

Indique si les travaux soumis peuvent être affichés sur l'écran Affichage des Travaux Soumis. Si vous indiquez *YES, tous les travaux soumis pourront être affichés à l'aide de la commande WRKSBMJOB (Gérer les travaux soumis).

Les valeurs possibles sont les suivantes :

*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.

Exemples

SBMDKTJOB   DEV(QDKT)  LABEL(OCT24)  VOL(SALES)

Cette commande permet de soumettre des travaux à partir de données d'une disquette depuis l'unité QDKT. La fonction Soumettre des travaux à partir de la disquette utilise en entrée les données du fichier OCT24 ayant pour identificateur de volume SALES. La file d'attente de travaux par défaut QBATCH est utilisée comme file d'attente de réception lorsque le paramètre JOBQ(*RDR) se trouve dans la description du travail. Des messages d'exploitation sont envoyés dans la file d'attente de messages définie par l'unité.

Messages d'erreur

Messages *ESCAPE

CPF1751: Erreur pendant traitement du travail &3/&2/&1.
CPF1752: Type incorrect pour unité &1.
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.
CPF9814: Unité &1 non trouvée.
CPF9845: Erreur lors de l'ouverture du fichier &1.
CPF9846: Erreur lors du traitement du fichier &1 de &2.

*STATUS Messages

CPF1755: Lecture du travail &3/&2/&1 du vol &4.