Aller au contenu

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

  • DEVTBL Table d'unités obligatoire
  • PGMTBL Table de programmes obligatoire
  • USRTBL Table d'utilisateurs
  • JOB Travail
  • JOBD Description de travail
  • MSGQ File 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.

Messages d'erreur

Messages *ESCAPE

CPF8382
Impossible de traiter le travail bancaire.

© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.