Commande CL IBM i (AS/400)
SBMFNCJOB
Soumettre un travail bancaire
En bref
La commande SBMFNCJOB (Soumettre un travail bancaire) soumet un travail par lots qui permet à vos programmes d'application bancaires de communiquer avec les programmes d'application de votre contrôleur 4701 ou 4702.
SBMFNCJOB se lit SBM
(Soumettre) + FNCJOB.
Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.
Syntaxe minimale
SBMFNCJOB DEVTBL(…) PGMTBL(…)
Paramètres
-
DEVTBLTable d'unités obligatoire -
PGMTBLTable de programmes obligatoire -
USRTBLTable d'utilisateurs -
JOBTravail -
JOBDDescription de travail -
MSGQFile attente messages
Astuce : dans une session 5250, tapez SBMFNCJOB 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 SBMFNCJOB (Soumettre un travail bancaire) soumet un travail par lots qui permet à vos programmes d'application bancaires de communiquer avec les programmes d'application de votre contrôleur 4701 ou 4702.
Utilisez la commande SBMFNCJOB uniquement dans les conditions suivantes :
- Une communication avec un contrôleur 4701 ou 4702 est en cours.
- Une table d'unités et une table de programmes ont été définies à l'aide des commandes WRKDEVTBL (Gérer les tables d'unités) et WRKPGMTBL (Gérer les tables de programmes) ; la définition d'une table d'utilisateurs dans la commande WRKUSRTBL (Gérer tables d'utilisateurs) est facultative.
- Le programme d'application du contrôleur 4701 ou 4702 de l'utilisateur envoie des données (transactions), puis attend une réponse.
- Le programme d'application du contrôleur 4701 ou 4702 transmet des données au format approprié.
Restriction : cette commande est livrée avec le droit public *EXCLUDE.
Paramètres
| Mot-clé | Description | Valeurs possibles | Remarques |
|---|---|---|---|
| DEVTBL | Table d'unités | Nom | Obligatoire, positionnel 1 |
| PGMTBL | Table de programmes | Nom | Obligatoire, positionnel 2 |
| USRTBL | Table d'utilisateurs | Nom, *NONE | Facultatif, positionnel 3 |
| JOB | Travail | Nom, QFNCJOB | Facultatif |
| JOBD | Description de travail | Nom d'objet qualifié | Facultatif |
| Qualificatif 1: Description de travail | Nom, QFNC | ||
| Qualificatif 2: Biblio | Nom, *LIBL, *CURLIB | ||
| MSGQ | File attente messages | Valeurs uniques: *WRKSTN, *NONE Autres valeurs: Nom d'objet qualifié |
Facultatif |
| Qualificatif 1: File attente messages | Nom | ||
| Qualificatif 2: Biblio | Nom, *LIBL, *CURLIB |
Table d'unités (DEVTBL)
Indique le nom de la table d'unités utilisée par le travail bancaire pour déterminer quelles unités 4704 ou 3624 il doit contrôler. Ce paramètre est obligatoire.
Table de programmes (PGMTBL)
Indique le nom de la table de programmes utilisée par le travail bancaire pour déterminer, à partir de l'ID programme transmis dans le flux de données avec une transaction bancaire, quels programmes utilisateur traiteront la transaction bancaire. Ce paramètre est obligatoire.
Table d'utilisateurs (USRTBL)
Indique le nom de la table d'utilisateurs utilisée par le travail bancaire lors de la réception d'un signal d'ouverture de session sur une unité bancaire. Elle permet de vérifier qu'il s'agit d'un utilisateur autorisé.
Les valeurs possibles sont les suivantes :
- *NONE
- Pas de vérification des ID d'utilisateurs.
- nom-table-utilisateur
- Indiquez le nom de la table des utilisateurs qui définit les ID utilisateur sur l'unité 4700.
Travail (JOB)
Indique le nom du travail correspondant au travail bancaire soumis.
Les valeurs possibles sont les suivantes :
- QFNCJOB
- Le travail est soumis sous le nom QFNCJOB.
- nom-travail
- Indiquez le nom de travail défini par l'utilisateur correspondant au travail bancaire soumis.
Description de travail (JOBD)
Indique le nom et la bibliothèque de la description du travail utilisée par le travail bancaire.
Les valeurs possibles sont les suivantes :
- *QFNC
- Le travail bancaire soumis utilise la description de travail QFNC.
- nom-description-travail
- Indiquez la bibliothèque et le nom de la description de travail utilisée par le travail bancaire. (Si aucun nom de bibliothèque n'est indiqué, la description est recherchée dans la liste des bibliothèques utilisée par le travail dans lequel la commande SBMFNCJOB (Soumettre un travail bancaire) a été entrée.
Les valeurs de bibliothèque possibles sont :
- *LIBL
-
Le travail bancaire est recherché dans la liste des bibliothèques.
- *CURLIB
-
La description de travail utilisée par le travail bancaire est recherchée dans la bibliothèque en cours du travail. Si cette dernière n'est pas précisée, QGPL est prise par défaut.
- nom-bibliothèque
-
Indiquez la bibliothèque contenant le travail bancaire.
File attente messages (MSGQ)
Indique le nom de la file d'attente de messages à laquelle les messages peuvent être envoyés pendant l'exécution du travail bancaire.
Les valeurs possibles sont les suivantes :
- WRKSTN
- Les messages bancaires sont envoyés à la file d'attente de messages du poste de travail à partir duquel a été soumis le travail bancaire.
- *NONE
- Aucun envoi de messages bancaires à la file d'attente de messages.
- nom-file-attente-messages
- Indiquez la bibliothèque et le nom de la file d'attente de messages définie par l'utilisateur à laquelle sont envoyés les messages. Si aucun nom de bibliothèque n'est indiqué, la file est recherchée dans la liste des bibliothèques du travail qui a lancé la commande SBMFNCJOB (Soumettre un travail bancaire).
Les valeurs de bibliothèque possibles sont :
- *LIBL
- Le nom de la file d'attente de messages est recherché dans la liste des bibliothèques.
- *CURLIB
- Le nom de la file d'attente des messages est recherché dans la bibliothèque en cours du travail. Si cette dernière n'est pas précisée, QGPL est prise par défaut.
- nom-bibliothèque
- Indiquez le nom de la bibliothèque contenant le nom de la file d'attente de messages.
Exemples
Exemple 1 : soumission d'un travail par lots qui communique avec les unités qu'il acquiert
SBMFNCJOB DEVTBL(DEVTBL1) PGMTBL(PGMTBL1) USRTBL(USRTBL1)
Cette commande soumet le travail par lots QFNCJOB. Le travail communique avec toutes les unités qu'il acquiert de la table des unités DEVTBL1, permettant ainsi aux utilisateurs dont les ID se trouvent dans USRTBL1 de se connecter aux unités. Chaque transaction envoyée par les unités bancaires est traitée en définissant, dans PGMTBL1, le programme d'application à appeler, puis en l'appelant.
La description de travail utilisée par le travail bancaire dans cet exemple est QFNC. Les messages envoyés à la suite du travail bancaire sont envoyés à la file d'attente des messages du poste de travail à partir duquel le travail a été soumis.
Exemple 2 : ID utilisateur non vérifiés
SBMFNCJOB DEVTBL(DEVTBL2) PGMTBL(PGMTBL2)
JOB(CTFJOB) JOBD(CTFJOBD) MSGQ(*NONE)
Cette commande soumet chaque travail par lots CTFJOB. CTFJOB s'exécute sous la description CTFJOBD et n'envoie pas de messages à une file d'attente de messages du poste de travail en cours d'exécution. Aucune vérification des ID utilisateur n'est effectuée par le travail bancaire.
© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.