Adaptateur BizTalk pour la configuration DB2 - HIS

  • Article

Vue d’ensemble

L’adaptateur Microsoft BizTalk pour DB2 se connecte BizTalk Server aux données vitales stockées dans IBM mainframe DB2 pour z/OS, IBM midrange DB2 pour IBM i et IBM Server DB2 s’exécutant sur les systèmes d’exploitation Linux, UNIX et Windows. L’adaptateur est basé sur le fournisseur de données Microsoft ADO.NET pour DB2 et prend en charge un large éventail de fonctions, notamment les ports d’envoi et les ports de réception avec des transactions distribuées sur les connexions réseau SNA et TCP/IP. À l’aide des commandes SQL définies dans les Assistants configuration de port, les professionnels de l’informatique peuvent facilement créer des solutions qui intègrent efficacement des bases de données DB2 sans écrire de code.

L’adaptateur remplit deux fonctions main :

  • Pour les opérations d’envoi (à la fois unidirectionnel et sollicitation de réponse), l’adaptateur envoie des commandes SQL et des procédures stockées à un instance DB2, avec la possibilité de solliciter une réponse.

  • Pour les opérations de réception (unidirectionnel uniquement), l’adaptateur crée une commande SQL ou une procédure stockée qui interroge les objets DB2 et crée des messages par ligne, qui sont ensuite envoyés au système de messages BizTalk.

    En outre, l’adaptateur BizTalk pour DB2 utilise l’outil de suivi de l’adaptateur BizTalk standard comme mécanisme de résolution des problèmes.

Créer un port d’envoi DB2

Connectez-vous avec un compte membre du groupe BizTalk Server Administrateurs.

  1. Dans BizTalk Server Administration, développez Groupe BizTalk, Applications, puis sélectionnez votre application.

  2. Cliquez avec le bouton droit sur Ports d’envoi, sélectionnez Nouveau, puis Port d’envoi unidirectionnel statique.

  3. Dans Propriétés du port d’envoi, définissez le type de transport sur DB2. Sélectionnez Configurer, puis entrez les propriétés suivantes :

    Propriété Pour
    BulkCopyBatchSize La propriété BulkCopyBatchSize indique à l’adaptateur le nombre de lignes à traiter par transaction par lot. Cette propriété facultative accepte une valeur entière . La valeur par défaut est de 20 appareils. La valeur 0 indique à l’adaptateur de traiter toutes les lignes d’un même lot.
    CommandTimeout La propriété CommandTimeout définit le temps d’attente avant que l’adaptateur termine une tentative d’exécution d’une commande, puis génère une erreur. Cette propriété facultative accepte une valeur entière . La valeur par défaut est 30 secondes. La valeur 0 indique aucune limite (une tentative d’exécution d’une commande attendra indéfiniment).
    Chaîne de connexion Nom d’un chaîne de connexion utilisé pour se connecter à la base de données DB2.

    Pour configurer une chaîne de connexion nouvelle ou existante, cliquez sur les points de suspension (...). L’Assistant Source de données démarre.

    Pour accéder à l’aide, cliquez sur Aide dans les pages de l’Assistant, ou ouvrez l’aide de Host Integration Server et recherchez l’Assistant Source de données (DB2).
    DB2 Set Registers La propriété DB2 Set Registers indique à l’adaptateur d’exécuter une ou plusieurs instructions SQL SET. Cette propriété facultative accepte une valeur de chaîne . La valeur par défaut est une chaîne vide, qui indique aucune instruction. La syntaxe prise en charge est une liste délimitée par des points-virgules de commandes d’instruction SET avec une liste séparée par des virgules des valeurs d’instruction SET «< COMMANDE SET 1> espace <valeur SET 1> point-virgule ; <Commande SET 2> espace <la valeur SET une><virgule SET valeur b> point-virgule »). Par exemple, entrez « SET CURRENT PATH 'DSN8910', 'HISDEMO' ».
    Espace de noms cible du document Espace de noms cible utilisé dans les documents XML envoyés à DB2.
    Nom de l'élément racine de la réponse Nom de l’élément racine utilisé dans les documents XML reçus de DB2. (Cette propriété peut être vide pour un port unidirectionnel.)
    URI Identificateur de ressource uniforme. Nom permettant d’identifier l’emplacement du port d’envoi. La valeur par défaut est DB2 ://.
    UseBulkCopy La propriété UseBulkCopy indique à l’adaptateur de traiter les commandes INSERT du port d’envoi en mode de copie en bloc pour améliorer les performances. Cette propriété facultative accepte une valeur booléenne . La valeur par défaut est false.

  4. Sélectionnez OK pour enregistrer vos modifications.

  5. Pour le gestionnaire d’envoi, sélectionnez l’hôte instance exécuter l’adaptateur, puis sélectionnez le pipeline d’envoi.

  6. Sélectionnez OK pour enregistrer vos modifications.

  7. Dans le volet Ports d’envoi, cliquez avec le bouton droit sur votre nouveau port d’envoi, sélectionnez Inscrire , puis Démarrer.

Créer un port de réception DB2

Connectez-vous avec un compte membre du groupe BizTalk Server Administrateurs.

  1. Dans BizTalk Server Administration, développez Groupe BizTalk, Applications, puis sélectionnez votre application.

  2. Cliquez avec le bouton droit sur Ports de réception, sélectionnez Nouveau, puis Port de réception unidirectionnel. Configurez vos propriétés, puis sélectionnez OK.

  3. Cliquez avec le bouton droit sur Emplacements de réception, sélectionnez Nouveau, puis Sélectionnez Emplacement de réception unidirectionnel. Sélectionnez le port de réception que vous venez de créer, puis cliquez sur OK.

  4. Dans Propriétés de l’emplacement de réception, définissez le Type de transport sur DB2. Sélectionnez Configurer, puis entrez les propriétés suivantes :

    Propriété Pour
    CommandTimeout La propriété CommandTimeout définit le temps d’attente avant que l’adaptateur termine une tentative d’exécution d’une commande, puis génère une erreur. Cette propriété facultative accepte une valeur entière. La valeur par défaut est de 30 secondes. La valeur 0 indique aucune limite (une tentative d’exécution d’une commande attendra indéfiniment).
    Chaîne de connexion Entrez le nom d’un chaîne de connexion qui sera utilisé pour se connecter à la base de données DB2.

    Pour configurer une chaîne de connexion nouvelle ou existante, cliquez sur les points de suspension (...). L’Assistant Source de données démarre. Pour accéder à l’aide, cliquez sur Aide dans les pages de l’Assistant, ou ouvrez l’aide de Host Integration Server et recherchez l’Assistant Source de données (DB2).
    DB2 Set Registers La propriété DB2 Set Registers indique à l’adaptateur d’exécuter une ou plusieurs instructions SQL SET. Cette propriété facultative accepte une valeur au format chaîne. La valeur par défaut est une chaîne vide, qui indique aucune instruction. La syntaxe prise en charge est une liste délimitée par des points-virgules de commandes d’instruction SET avec une liste séparée par des virgules des valeurs d’instruction SET «< COMMANDE SET 1> espace <valeur SET 1> point-virgule ; <Commande SET 2> espace <la valeur SET une><virgule SET valeur b> point-virgule »). Par exemple, entrez « SET CURRENT PATH 'DSN8910', 'HISDEMO' ».
    Nom de l'élément racine du document Nom de l’élément racine utilisé dans les documents XML reçus de DB2.
    Espace de noms cible du document Espace de noms cible utilisé dans les documents XML reçus de DB2.
    Commande SQL Commande de sélection ou de procédure stockée exécutée une fois pour chaque intervalle d’interrogation.
    Update Command Commande exécutée après le traitement de chaque ligne de l’opération de réception. Il peut s’agir d’une instruction delete qui supprime la ligne de la table dans la commande SQL, ou d’une commande de mise à jour qui modifie statiquement une ou plusieurs lignes. Lorsque cette option est spécifiée, la commande SQL doit être une instruction Select et doit accéder à une table unique.
    URI Nom identifiant l’emplacement du port de réception. La valeur par défaut est DB2 ://.
    Intervalle d’interrogation Nombre d’unités entre les demandes d’interrogation. La plage autorisée est comprise entre 1 et 65535.
    Unité de mesure de l'interrogation Unité de mesure (secondes, minutes ou heures) utilisée entre les demandes d’interrogation. La valeur par défaut est en secondes.

  5. Sélectionnez OK pour enregistrer vos modifications.

  6. Pour le gestionnaire de réception, sélectionnez l’hôte instance pour exécuter l’adaptateur. Le gestionnaire de réception doit être exécuté sur cet hôte. Sélectionnez le pipeline de réception. . Sélectionnez OK pour enregistrer vos modifications.

  7. Dans emplacements de réception, cliquez avec le bouton droit sur l’emplacement de réception, puis activez.

Créer un schéma d’adaptateur DB2

  1. Ouvrez votre projet BizTalk Visual Studio.

  2. Cliquez avec le bouton droit sur le projet, sélectionnez Ajouter, Ajouter des éléments générés, puis Ajouter.

  3. Dans la boîte de dialogue Ajouter des éléments générés , sélectionnez Ajouter des métadonnées d’adaptateur.

  4. Dans l’Assistant Ajout d’adaptateur, dans la page Sélectionner un adaptateur , sélectionnez DB2. Dans la liste Port, sélectionnez un port d’envoi ou un emplacement de réception configuré, puis sélectionnez Suivant.

  5. Dans l’Assistant Génération de schéma d’adaptateur DB2 :

    1. Dans Informations de base de données, créez un chaîne de connexion ou sélectionnez un chaîne de connexion existant.

    2. Dans Informations de schéma, définissez l’espace de noms par défaut, les éléments racine et le type de port à utiliser dans le schéma.

      Si vous sélectionnez Port de réception, seul un nom d’élément racine de document de requête est nécessaire. Si vous sélectionnez Envoyer le port, les noms d’éléments racine du document de demande et de réponse sont obligatoires.

    3. Dans Informations sur le type d’instruction, sélectionnez le type de commande de base de données à émettre.

      Si vous avez sélectionné des ports de réception sur la page précédente, vous pouvez choisir une instruction SELECT SQL ou une procédure stockée. Si vous avez sélectionné des ports d’envoi sur la page précédente, vous pouvez choisir d’émettre une mise à jour, une procédure stockée ou une instruction SELECT.

    4. Dans Informations sur l’instruction, entrez les détails de la base de données DB2. Selon les informations que vous avez entrées précédemment, les propriétés suivantes sont disponibles :

      1. Recevez l’instruction Select dans la boîte de dialogue Informations sur l’instruction , tapez une instruction SQL SELECT dans la zone d’édition du script SQL . Si vous le souhaitez , cliquez sur Parcourir pour charger un fichier texte contenant une instruction.

      2. Recevez la procédure stockée dans la boîte de dialogue Informations sur l’instruction , cliquez sur un nom de procédure stockée. Dans la liste Paramètres, cliquez sur la case Valeur pour chaque paramètre requis.

      3. Envoyer le programme de mise à jour dans la boîte de dialogue Informations sur l’instruction , cliquez sur un nom de table. Dans la liste Paramètres , cliquez sur la case à cocher Valeur pour chaque colonne requise. Lorsque vous utilisez BulkCopy, vous devez cliquer sur chaque case Valeur pour sélectionner toutes les colonnes.

      4. Envoyer une procédure stockée dans la boîte de dialogue Informations sur l’instruction , cliquez sur un nom de procédure stockée. Dans la liste Paramètres , cliquez sur la case Valeur pour chaque paramètre requis.

      5. Envoyer l’instruction Select dans la boîte de dialogue Informations sur l’instruction, tapez INSTRUCTION SELECT SQL dans la zone d’édition du script SQL. Si vous le souhaitez , cliquez sur Parcourir pour charger un fichier texte contenant une instruction.

  6. Sélectionnez Terminer pour terminer l’Assistant.

Vous disposez maintenant d’un schéma.