Freigeben über

BizTalk-Adapter für DB2-Konfiguration – HIS

  • Artikel

Überblick

Der Microsoft BizTalk-Adapter für DB2 verbindet BizTalk Server mit wichtigen Daten, die in IBM Mainframe DB2 for z/OS, IBM Midrange DB2 für IBM i und IBM Server DB2 unter Linux-, UNIX- und Windows-Betriebssystemen gespeichert sind. Der Adapter basiert auf dem Microsoft ADO.NET-Datenanbieter für DB2 und unterstützt eine breite Palette von Funktionen, einschließlich Sendeports und Empfangsports mit verteilten Transaktionen über SNA- und TCP/IP-Netzwerkverbindungen hinweg. Mithilfe von SQL-Befehlen, die in Portkonfigurations-Assistenten definiert sind, können IT-Experten problemlos Lösungen erstellen, die DB2-Datenbanken effizient integrieren, ohne Code zu schreiben.

Der Adapter verfügt über zwei Standard Funktionen:

  • Bei Sendevorgängen (sowohl One Way als auch Solicit Response) sendet der Adapter SQL-Befehle und gespeicherte Prozeduren an eine DB2-instance mit der Möglichkeit, eine Antwort anzufordern.

  • Für Empfangsvorgänge (nur one way) erstellt der Adapter einen SQL-Befehl oder eine gespeicherte Prozedur, die DB2-Objekte abruft und zeilenweise Nachrichten erstellt, die dann an das BizTalk-Nachrichtensystem übermittelt werden.

    Darüber hinaus verwendet der BizTalk-Adapter für DB2 das Standardmäßige BizTalk-Adapterablaufverfolgungstool als Problembehandlungsmechanismus.

Erstellen eines DB2-Sendeports

Melden Sie sich mit einem Konto an, das Mitglied der Gruppe BizTalk Server Administratoren ist.

  1. Erweitern Sie in BizTalk Server Verwaltungdie BizTalk-Gruppe, erweitern Sie Anwendungen, und wählen Sie dann Ihre Anwendung aus.

  2. Klicken Sie mit der rechten Maustaste auf Ports senden, wählen Sie Neu und dann Statischer Unidirektionalen Sendeport aus.

  3. Legen Sie in den Eigenschaften des Sendeports den Transporttyp auf DB2 fest. Wählen Sie Konfigurieren aus, und geben Sie die folgenden Eigenschaften ein:

    Option Aufgabe
    BulkCopyBatchSize Die BulkCopyBatchSize-Eigenschaft weist den Adapter an, wie viele Zeilen pro Batchtransaktion verarbeitet werden sollen. Diese optionale Eigenschaft akzeptiert einen ganzzahligen Wert. Der Standardwert ist 20. Der Wert 0 weist den Adapter an, alle Zeilen in einem einzelnen Batch zu verarbeiten.
    CommandTimeout Die CommandTimeout-Eigenschaft legt die Wartezeit fest, bevor der Adapter einen Versuch beendet, einen Befehl auszuführen und dann einen Fehler zu generieren. Diese optionale Eigenschaft akzeptiert einen ganzzahligen Wert. Der Standardwert ist 30 Sekunden. Der Wert 0 gibt kein Limit an (ein Versuch, einen Befehl auszuführen, wartet unbegrenzt).
    Verbindungszeichenfolge Der Name einer Verbindungszeichenfolge, die zum Herstellen einer Verbindung mit der DB2-Datenbank verwendet wird.

    Um eine neue oder vorhandene Verbindungszeichenfolge zu konfigurieren, klicken Sie auf die Auslassungspunkte (...). Dadurch wird der Datenquellen-Assistent gestartet.

    Um auf die Hilfe zuzugreifen, klicken Sie auf den Seiten des Assistenten auf Hilfe , oder öffnen Sie die Host Integration Server-Hilfe, und suchen Sie im Datenquellen-Assistenten (DB2) nach.
    DB2 Set Registers Die DB2 Set Registers-Eigenschaft weist den Adapter an, mindestens eine SQL SET-Anweisung auszuführen. Diese optionale Eigenschaft akzeptiert einen Zeichenfolgenwert . Der Standardwert ist eine leere Zeichenfolge, die keine Anweisung angibt. Die unterstützte Syntax ist eine durch Semikolon getrennte Liste von SET-Anweisungsbefehlen mit einer durch Kommas getrennten Liste von SET-Anweisungswerten "<SET-Befehl 1> Leerzeichen <SET-Wert 1> Semikolon; <SET-Befehl 2> Leerzeichen <SET-Wert ein> Komma <SET-Wert b> Semikolon"). Geben Sie beispielsweise "SET CURRENT PATH 'DSN8910', 'HISDEMO'" ein.
    Zielnamespace des Dokuments Der Zielnamespace, der in den XML-Dokumenten verwendet wird, die an DB2 gesendet werden.
    Stammelementname der Antwort Der Name des Stammelements, der in den XML-Dokumenten verwendet wird, die von DB2 empfangen werden. (Diese Eigenschaft kann für einen unidirektionalen Port leer sein.)
    URI Einheitlicher Ressourcenbezeichner. Ein Name zum Identifizieren des Sendeportspeicherorts. Der Standardwert ist DB2://.
    UseBulkCopy Die UseBulkCopy-Eigenschaft weist den Adapter an, Sendeport-INSERT-Befehle im Massenkopiermodus zu verarbeiten, um die Leistung zu verbessern. Diese optionale Eigenschaft akzeptiert einen booleschen Wert. Der Standardwert ist false.

  4. Klicken Sie auf OK, um die Änderungen zu speichern.

  5. Wählen Sie für den Sendehandler den Host instance aus, um den Adapter auszuführen, und wählen Sie die Sendepipeline aus.

  6. Klicken Sie auf OK, um die Änderungen zu speichern.

  7. Klicken Sie unter Sendeports mit der rechten Maustaste auf Ihren neuen Sendeport, und wählen Sie Enlist und dann Start aus.

Erstellen eines DB2-Empfangsports

Melden Sie sich mit einem Konto an, das Mitglied der Gruppe BizTalk Server Administratoren ist.

  1. Erweitern Sie in BizTalk Server Verwaltungdie BizTalk-Gruppe, erweitern Sie Anwendungen, und wählen Sie dann Ihre Anwendung aus.

  2. Klicken Sie mit der rechten Maustaste auf Empfangsports, wählen Sie Neu und dann Unidirektionalen Empfangsport aus. Konfigurieren Sie Ihre Eigenschaften, und wählen Sie OK aus.

  3. Klicken Sie mit der rechten Maustaste auf Empfangsorte, wählen Sie Neu und dann Unidirektionale Empfangsadresse aus. Wählen Sie den soeben erstellten Empfangsport aus, und klicken Sie dann auf OK.

  4. Legen Sie in den Eigenschaften des Empfangsspeicherorts den Transporttyp auf DB2 fest. Wählen Sie Konfigurieren aus, und geben Sie die folgenden Eigenschaften ein:

    Option Aufgabe
    CommandTimeout Die CommandTimeout-Eigenschaft legt die Wartezeit fest, bevor der Adapter einen Versuch beendet, einen Befehl auszuführen und dann einen Fehler zu generieren. Diese optionale Einstellung akzeptiert einen ganzzahligen Wert. Der Standardwert ist 30 Sekunden. Der Wert 0 gibt kein Limit an (ein Versuch, einen Befehl auszuführen, wartet unbegrenzt).
    Verbindungszeichenfolge Geben Sie den Namen einer Verbindungszeichenfolge ein, die zum Herstellen einer Verbindung mit der DB2-Datenbank verwendet wird.

    Um eine neue oder vorhandene Verbindungszeichenfolge zu konfigurieren, klicken Sie auf die Auslassungspunkte (...). Dadurch wird der Datenquellen-Assistent gestartet. Um auf die Hilfe zuzugreifen, klicken Sie auf den Seiten des Assistenten auf Hilfe , oder öffnen Sie die Host Integration Server-Hilfe, und suchen Sie im Datenquellen-Assistenten (DB2) nach.
    DB2 Set Registers Die DB2 Set Registers-Eigenschaft weist den Adapter an, mindestens eine SQL SET-Anweisung auszuführen. Diese optionale Eigenschaft akzeptiert einen Zeichenfolgenwert. Der Standardwert ist eine leere Zeichenfolge, die keine Anweisung angibt. Die unterstützte Syntax ist eine durch Semikolon getrennte Liste von SET-Anweisungsbefehlen mit einer durch Kommas getrennten Liste von SET-Anweisungswerten "<SET-Befehl 1> Leerzeichen <SET-Wert 1> Semikolon; <SET-Befehl 2> Leerzeichen <SET-Wert ein> Komma <SET-Wert b> Semikolon"). Geben Sie beispielsweise "SET CURRENT PATH 'DSN8910', 'HISDEMO'" ein.
    Stammelementname des Dokuments Der Name des Stammelements, der in den XML-Dokumenten verwendet wird, die von DB2 empfangen werden.
    Zielnamespace des Dokuments Der Zielnamespace, der in den XML-Dokumenten verwendet wird, die von DB2 empfangen werden.
    SQL-Befehl Der Befehl zum Auswählen oder Speichern der Prozedur, der einmal für jedes Abrufintervall ausgeführt wird.
    Befehl "Aktualisieren" Der Befehl, der nach jeder Zeile im Empfangsvorgang ausgeführt wird, wird verarbeitet. Es kann sich entweder um eine delete-Anweisung handeln, die die Zeile aus der Tabelle im SQL-Befehl löscht, oder um einen Updatebefehl, der eine oder mehrere Zeilen statisch ändert. Wenn diese Option angegeben ist, muss der SQL-Befehl eine Select-Anweisung sein und auf eine einzelne Tabelle zugreifen.
    URI Ein Name, der den Speicherort des Empfangsports identifiziert. Der Standardwert ist DB2://.
    Abfrageintervall Die Anzahl der Einheiten zwischen Abrufanforderungen. Zulässiger Bereich ist 1 bis 65535.
    Abrufmaßeinheit Die Maßeinheit (Sekunden, Minuten oder Stunden), die zwischen Abrufanforderungen verwendet wird. Der Standardwert ist Sekunden.

  5. Klicken Sie auf OK, um die Änderungen zu speichern.

  6. Wählen Sie für den Empfangshandler den Host instance aus, um den Adapter auszuführen. Der Empfangshandler muss auf diesem Host ausgeführt werden. Wählen Sie die Empfangspipeline aus. . Klicken Sie auf OK, um die Änderungen zu speichern.

  7. Klicken Sie unter Empfangsspeicherorte mit der rechten Maustaste auf den Empfangsspeicherort, und klicken Sie dann auf Aktivieren.

Erstellen eines DB2-Adapterschemas

  1. Öffnen Sie Ihr BizTalk Visual Studio-Projekt.

  2. Klicken Sie mit der rechten Maustaste auf das Projekt, wählen Sie Hinzufügen, dann Generierte Elemente hinzufügen und dann Hinzufügen aus.

  3. Wählen Sie im Dialogfeld Generierte Elemente hinzufügen die Option Adaptermetadaten hinzufügen aus.

  4. Wählen Sie im Assistenten zum Hinzufügen von Adaptern auf der Seite Adapter auswählen die Option DB2 aus. Wählen Sie in der Liste Port einen konfigurierten Sendeport oder Empfangsspeicherort und dann Weiter aus.

  5. Führen Sie im Assistenten zum Generieren von DB2-Adapterschemas folgendes aus:

    1. Erstellen Sie unter Datenbankinformationen eine Verbindungszeichenfolge, oder wählen Sie eine vorhandene Verbindungszeichenfolge aus.

    2. Definieren Sie unter Schemainformationen den Standardnamespace, die Stammelemente und den Porttyp, die im Schema verwendet werden sollen.

      Wenn Sie Port empfangen auswählen, ist nur ein Name des Anforderungsdokumentstammelements erforderlich. Wenn Sie Port senden auswählen, sind sowohl die Namen des Anforderungs- als auch des Antwortdokumentstammelements erforderlich.

    3. Wählen Sie unter Anweisungstypinformationen den Typ des auszugebenden Datenbankbefehls aus.

      Wenn Sie auf der vorherigen Seite Empfangsports ausgewählt haben, können Sie entweder eine SELECT SQL-Anweisung oder eine gespeicherte Prozedur auswählen. Wenn Sie auf der vorherigen Seite Sendeports ausgewählt haben, können Sie ein Updategram, eine gespeicherte Prozedur oder eine SELECT-Anweisung ausgeben.

    4. Geben Sie unter Anweisungsinformationen die Details zur DB2-Datenbank ein. Abhängig von den zuvor eingegebenen Informationen stehen die folgenden Eigenschaften zur Verfügung:

      1. Empfangen Sie select-Anweisung im Dialogfeld Anweisungsinformationen , und geben Sie eine SQL SELECT-Anweisung in das Bearbeitungsfeld des SQL-Skripts ein. Klicken Sie optional auf Durchsuchen , um eine Textdatei mit einer -Anweisung zu laden.

      2. Empfangen einer gespeicherten Prozedur im Dialogfeld "Anweisungsinformationen " klicken Sie auf einen Namen der gespeicherten Prozedur. Klicken Sie in der Liste Parameter für jeden erforderlichen Parameter auf das Kontrollkästchen Wert .

      3. Updategram senden klicken Sie im Dialogfeld Anweisungsinformationen auf einen Tabellennamen. Klicken Sie in der Liste Parameter für jede erforderliche Spalte auf das Kontrollkästchen Wert . Wenn Sie BulkCopy verwenden, müssen Sie auf jedes Wert-Kontrollkästchen klicken, um alle Spalten auszuwählen.

      4. Gespeicherte Prozedur senden klicken Sie im Dialogfeld Anweisungsinformationen auf einen Namen der gespeicherten Prozedur. Klicken Sie in der Liste Parameter für jeden erforderlichen Parameter auf das Kontrollkästchen Wert .

      5. Select-Anweisung senden im Dialogfeld "Anweisungsinformationen" geben Sie sql SELECT-Anweisung in das Bearbeitungsfeld für SQL-Skripts ein. Klicken Sie optional auf Durchsuchen , um eine Textdatei mit einer -Anweisung zu laden.

  6. Wählen Sie Fertig stellen aus, um den Assistenten abzuschließen.

Sie verfügen jetzt über ein Schema.