Freigeben über

BizTalk-Adapter für DB2-Konfiguration – HIS

Überblick

Der Microsoft BizTalk Adapter für DB2 verbindet BizTalk Server mit wichtigen Daten, die in IBM Mainframe DB2 für z/OS, IBM midrange DB2 für IBM i und IBM Server DB2 gespeichert sind, die auf Linux-, UNIX- und Windows-Betriebssystemen ausgeführt werden. Der Adapter basiert auf dem Microsoft ADO.NET-Datenanbieter für DB2 und unterstützt eine breite Palette von Funktionen, einschließlich Sendepunkte und Empfangspunkte mit verteilten Transaktionen für SNA- und TCP/IP-Netzwerkverbindungen. 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 dient zwei Hauptfunktionen:

  • Bei Sendevorgängen (Einweg- und Solicit-Response) sendet der Adapter SQL-Befehle und gespeicherte Prozeduren an eine DB2-Instanz, wobei die Möglichkeit besteht, eine Antwort anzufordern.

  • Bei Empfangsvorgängen (nur One Way) erstellt der Adapter einen SQL-Befehl oder eine gespeicherte Prozedur, die DB2-Objekte abruft und nachrichten pro Zeile erstellt, die dann an das BizTalk-Nachrichtensystem übermittelt werden.

    Darüber hinaus verwendet der BizTalk-Adapter für DB2 das standardmäßige BizTalk Adapter-Ablaufverfolgungstool 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 der 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" aus, und wählen Sie dann "Statischer Unidirektionale Sendeport" aus.

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

    Verwenden Sie diese Aktion
    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 beträgt 30 Sekunden. Ein Wert von 0 gibt keinen Grenzwert an (ein Versuch, einen Befehl auszuführen, wartet auf unbestimmte Zeit).
    Verbindungszeichenfolge Der Name einer Verbindungszeichenfolge, die zum Herstellen einer Verbindung mit der DB2-Datenbank verwendet wird.

    Klicken Sie auf das Auslassungszeichen (...), um eine neue oder vorhandene Verbindungszeichenfolge zu konfigurieren. Dadurch wird der Datenquellen-Assistent gestartet.

    Um auf die Hilfe zuzugreifen, klicken Sie auf den Assistentenseiten auf "Hilfe", oder öffnen Sie die Hilfe zum Hostintegrationsserver, und suchen Sie im Datenquellen-Assistenten (DB2).
    DB2-Satzregister Die DB2 Set Registers-Eigenschaft weist den Adapter an, eine oder mehrere SQL SET-Anweisungen 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 Semikolons getrennte Liste von SET-Anweisungsbefehlen mit einer kommagetrennten 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 z. B. "SET CURRENT PATH 'DSN8910', 'HISDEMO'" ein.
    Dokument-Ziel-Namespace Der Zielnamespace, der in den XML-Dokumenten verwendet wird, die an DB2 gesendet werden.
    Name des Antwortstammelements Der Stammelementname, der in den XML-Dokumenten verwendet wird, die von DB2 empfangen werden. (Diese Eigenschaft kann für einen unidirektionalen Port leer sein.)
    URI Einheitlicher Bezeichner für Ressourcen Ein Name zum Identifizieren des Sendeportstandorts. Der Standardwert ist DB2://.
    UseBulkCopy Die UseBulkCopy-Eigenschaft weist den Adapter an, Port INSERT-Befehle im Massenkopiemodus 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 die Hostinstanz 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 in den Sendeports mit der rechten Maustaste auf den neuen Sendeport, und wählen Sie "Enlist" und dann "Start" aus.

Erstellen Sie einen DB2-Empfangsport

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

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

  2. Klicken Sie mit der rechten Maustaste auf "Empfangsport", wählen Sie " Neu" aus, und wählen Sie dann " Unidirektionale 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" aus, und wählen Sie dann " Standort für einmaliges Empfangen" aus. Wählen Sie den soeben erstellten Empfangsport aus, und klicken Sie dann auf "OK".

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

    Verwenden Sie diese Aktion
    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. Ein Wert von 0 gibt keinen Grenzwert an (ein Versuch, einen Befehl auszuführen, wartet auf unbestimmte Zeit).
    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 Auslassungszeichen (...). Dadurch wird der Datenquellen-Assistent gestartet. Um auf die Hilfe zuzugreifen, klicken Sie auf den Assistentenseiten auf "Hilfe", oder öffnen Sie die Hilfe zum Hostintegrationsserver, und suchen Sie im Datenquellen-Assistenten (DB2).
    DB2 Registereinstellungen Die DB2 Set Registers-Eigenschaft weist den Adapter an, eine oder mehrere SQL SET-Anweisungen 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 Semikolons getrennte Liste von SET-Anweisungsbefehlen mit einer kommagetrennten 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 z. B. "SET CURRENT PATH 'DSN8910', 'HISDEMO'" ein.
    Name des Dokumentstammelements Der Stammelementname, der in den XML-Dokumenten verwendet wird, die von DB2 empfangen werden.
    Ziel-Namespace des Dokuments Der Zielnamespace, der in den XML-Dokumenten verwendet wird, die von DB2 empfangen werden.
    SQL-Befehl Der Befehl "Auswählen" oder "Gespeicherte Prozedur", der für jedes Abrufintervall einmal ausgeführt wird.
    Befehl aktualisieren Der Befehl, der nach jeder Zeile im Empfangsvorgang ausgeführt wird, wird verarbeitet. Dabei kann es sich entweder um eine Delete-Anweisung handeln, die die Zeile aus der Tabelle im SQL-Befehl löscht, oder ein Aktualisierungsbefehl, 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 Empfangsportstandort identifiziert. Der Standardwert ist DB2://.
    Abrufintervall Die Anzahl von Einheiten zwischen Abfrageanforderungen. Zulässiger Bereich ist 1 bis 65535.
    Erfassungseinheit der Maßeinheit Die Maßeinheit (Sekunden, Minuten oder Stunden), die zur Messung des Zeitintervalls 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 die Hostinstanz 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 in den Empfangsspeicherorten mit der rechten Maustaste auf den Empfangsspeicherort, und aktivieren Sie dann.

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 " DB2 aus. Wählen Sie in der Portliste einen konfigurierten Sende- oder Empfangsstandort und dann "Weiter" aus.

  5. Im Assistenten für die Generierung des DB2-Adapterschemas:

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

    2. Definieren Sie in "Schemainformationen" den Standardnamespace, die Stammelemente und den Porttyp, der im Schema verwendet werden soll.

      Wenn Sie Receive port auswählen, ist nur der Name des Stammbereichs des Anforderungsdokuments erforderlich. Wenn Sie Sendeport auswählen, sind sowohl Anforderungs- als auch Antwortdokument-Stammelementnamen erforderlich.

    3. Wählen Sie in den Informationen zum Anweisungstyp den Typ des datenbankbefehls aus, der ausgegeben werden soll.

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

    4. Geben Sie in „Anweisungsinformationen“ die Details zur DB2-Datenbank ein. Je nachdem, welche Informationen Sie zuvor eingegeben haben, stehen die folgenden Eigenschaften zur Verfügung:

      1. Empfangen einer Select-Anweisung im Dialogfeld " Anweisungsinformationen ", 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 " Informationen zur Anweisung " klicken Sie auf den Namen einer gespeicherten Prozedur. Klicken Sie in der Liste "Parameter" für jeden erforderlichen Parameter auf das Kontrollkästchen "Wert ".

      3. Senden Sie Updategram im Dialogfeld Informationen zur Anweisung, klicken Sie 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 Kontrollkästchen "Wert " klicken, um alle Spalten zu markieren.

      4. Senden Sie die gespeicherte Prozedur im Dialogfeld Informationen zur Anweisung, klicken Sie auf den Namen einer gespeicherten Prozedur. Klicken Sie in der Liste "Parameter " für jeden erforderlichen Parameter auf das Kontrollkästchen "Wert ".

      5. SELECT-Anweisung senden im Dialogfeld für Anweisungsinformationen, geben Sie die SQL SELECT-Anweisung im SQL-Skriptbearbeitungsfeld 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 haben jetzt ein Schema.