Konfigurieren eines Empfangsports und eines Empfangsspeicherorts für den MQSC-Adapter

Sie konfigurieren einen Empfangsport und einen Empfangsspeicherort für den BizTalk-Adapter für WebSphere MQ mithilfe der BizTalk Server-Verwaltungskonsole. Sie müssen mit einem Konto angemeldet sein, das Mitglied der BizTalk Server-Administratorengruppe ist. Darüber hinaus müssen Sie über die entsprechenden Berechtigungen in der Datenbank für einmaliges Sign-On (Single Sign-On, SSO) verfügen.

So konfigurieren Sie einen Empfangsport und einen Empfangsspeicherort

1. Wählen Sie unter Programmedie Option Microsoft BizTalk Server und dann BizTalk Server Verwaltung aus.

2. Erweitern Sie in der Konsolenstruktur Die BizTalk-Gruppe, erweitern Sie Anwendungen, und wählen Sie dann die Anwendung aus, für die Sie einen Empfangsport erstellen möchten.

3. Klicken Sie mit der rechten Maustaste auf Empfangsports, zeigen Sie auf Neu, und klicken Sie dann auf Unidirektionalen Empfangsport.

4. Konfigurieren Sie im Fenster Eigenschaften des Empfangsports Eigenschaften für den Port, und klicken Sie dann auf OK.

5. Klicken Sie in der Konsolenstruktur mit der rechten Maustaste auf Empfangsorte, zeigen Sie auf Neu, und klicken Sie dann auf Unidirektionale Empfangsadresse.

6. Klicken Sie im Fenster Empfangsport auswählen auf den Empfangsport, den Sie im vorherigen Schritt erstellt haben, und klicken Sie dann auf OK.

7. Wählen Sie im Fenster Eigenschaften des Empfangsspeicherorts den MQSC-Adapter als Transporttyp aus, und klicken Sie dann auf Konfigurieren.

8. Konfigurieren Sie im Fenster Transporteigenschaften des Adapters die Eigenschaften des Empfangsspeicherorts (siehe Tabellen am Ende dieses Verfahrens).

   Hinweis

   Die folgenden Eigenschaften sind erforderlich, um einen Empfangsspeicherort zu konfigurieren:

   Kanalname (Hierbei handelt es sich um eine Eigenschaft, bei der die Groß-/Kleinschreibung beachtet wird.)

   Verbindungsname

   Transporttyp

   Queue (Hierbei handelt es sich um eine Eigenschaft, bei der die Groß-/Kleinschreibung beachtet wird.)

   Warteschlangen-Manager (Hierbei handelt es sich um eine Eigenschaft, bei der die Groß-/Kleinschreibung beachtet wird.)

   Wenn Sie keine Channel Name-Eigenschaft angeben, müssen Sie eine Clientkanaldefinitionsdatei bereitstellen, damit der auf dem BizTalk Server Computer installierte WebSphere MQ-Client mit Remotewarteschlangen-Managern kommunizieren kann. Sie müssen auch eine Clientkanaldefinitionsdatei bereitstellen, wenn Sie SSL (Secure Sockets Layer) für transaktionsbasiertes Messaging konfigurieren. Weitere Informationen finden Sie unter Konfigurieren einer Clientkanaldefinitionsdatei.

9. Wenn Sie die Konfiguration der Eigenschaften abgeschlossen haben, klicken Sie auf OK.

10. Wählen Sie im Fenster Eigenschaften des Empfangsspeicherorts in der Liste Empfangshandler die instance des BizTalk Server Hosts aus, auf dem der Empfangsspeicherort ausgeführt wird.

    Der Empfangshandler muss auf diesem Host ausgeführt werden.

11. Wählen Sie in der Liste Empfangspipeline die Empfangspipeline aus, mit der Nachrichten an diesem Empfangsspeicherort empfangen werden sollen.

12. Klicken Sie auf OK.

13. Klicken Sie im Fenster Empfangsorte mit der rechten Maustaste auf den Empfangsspeicherort in der Spalte Name , und wählen Sie Aktivieren aus.

    Eigenschaften von Empfangsspeicherorten

    Im Abschnitt Erweitert des Fensters Transporteigenschaften können Sie die folgenden Eigenschaften festlegen.

    Option	Aufgabe
    Datenoffset für Header	Der Adapter verwendet Werte aus den MQSeries-Headern (die Strukturen MQMD, MQXQH, MQIIH und MQCIH) und füllt die entsprechenden Werte in den BizTalk Server Kontexteigenschaften auf. Standardmäßig entfernt der Adapter die MQSeries-Eigenschaften aus dem Nachrichtentext. Legen Sie auf Nein fest, um die Eigenschaften im Nachrichtentext beizubehalten. Standardeinstellung: Ja
    Schwellenwert für Fehler im Ereignisprotokoll	Die maximale Anzahl desselben Fehlers, der für bestimmte Fehlerbedingungen protokolliert werden soll. Der Adapter wird weiterhin ausgeführt, und wenn der Adapter wiederhergestellt wird, protokolliert er das Ereignis im Anwendungsprotokoll. Standardwert: 10
    Bestellt	Legen Sie auf Ja fest, um die Reihenfolge der Nachrichten beizubehalten, die von der MQSeries-Warteschlange empfangen und an die BizTalk Server MessageBox gesendet werden. Für die Sendeseite sendet der Adapter die Nachricht in der gleichen Reihenfolge an die Warteschlange, in der er sie aus dem Meldungsfeld empfängt. Legen Sie auf Nein fest, um die Nachrichtenreihenfolge nicht beizubehalten. Wenn Sie für die sendeseitige Bestellung keine Orchestrierung verwenden, müssen Sie die Option Bestellte Zustellung in den erweiterten Transportoptionen der Sendeportkonfiguration aktivieren. Wenn Sie die Orchestrierung verwenden, müssen Sie bei der empfangsseitigen Reihenfolge auch die Eigenschaft Ordered Delivery in Ihrer Orchestrierung für den Empfangsspeicherort auf True festlegen. Eine bestellte Lieferung kann die Leistung beeinträchtigen. es sei denn, Sie benötigen eine bestellte Lieferung, dies wird nicht empfohlen. Standardeinstellung: Nein
    Bei Fehler beenden	Legen Sie auf Ja fest, um die Verarbeitung zu beenden, wenn ein Fehler vorliegt. Mit dieser Option wird bei einem Fehler die Transaktion beendet, und der Empfangsspeicherort wird deaktiviert. Standardeinstellung: Nein
    Als nicht fortsetzbar anhalten	Legen Sie auf Ja fest, um eine Nachricht in die angehaltene Warteschlange zu verschieben, wenn ein Fehler auftritt, und geben Sie an, ob sie fortgesetzt werden kann oder nicht. Wenn Sie diesen Wert aktivieren, bleibt die geordnete Zustellung nicht erhalten, wenn ein Fehler auftritt, aber der Empfangsspeicherort kann weiterhin Nachrichten empfangen. Standardeinstellung: Nein
    Transaktion unterstützt	Wenn er auf Ja festgelegt ist, arbeitet der MQSC-Adapter mit dem WebSphere MQ Extended Transactional Client (Extended-Client) auf dem BizTalk Server Computer zusammen, um den Verlust von Nachrichten zu verhindern und einmalige Zustellung von Nachrichten zu gewährleisten. Wenn sie auf Nein festgelegt ist, kann es zu Duplizierungen von Nachrichten kommen. In diesem Fall verwendet der Adapter den nicht transaktionalen WebSphere MQ-Client (Base-Client) für die Integration in MQSeries. Standardeinstellung: Nein
    Warteintervall	Wenn MQGet zum Abrufen von Nachrichten aus der MQSeries-Warteschlange ausgeführt wird, kann die MQGMO-Option für Warteintervall festgelegt werden. Wenn keine Nachrichten in der Warteschlange vorhanden sind, wartet der Adapter für die angegebene Zeit (in Sekunden), bevor die Clientanforderung geschlossen wird. Sobald Nachrichten in der Warteschlange eintreffen, beginnt der Adapter mit dem Abrufen der Nachrichten. Standardwert: 3

    Im Abschnitt Kanaldefinition des Transport-Eigenschaftenfenster können Sie die folgenden Eigenschaften festlegen.

    Option	Aufgabe
    Kanalname	Name des Kanals, der auf dem MQSeries Server-Computer definiert ist, mit dem der Client kommuniziert. Hierbei muss es sich um einen Kanaltyp "Serververbindung" handeln. Beachten Sie, dass dies eine Eigenschaft ist, bei der die Groß-/Kleinschreibung beachtet wird.
    Verbindungsname	Name des MQSeries-Servers, der den Warteschlangen-Manager und Warteschlangen enthält, von denen der MQSC-Adapter Nachrichten empfängt. Für den TCP-Transporttyp ist das anzugebende Format SERVERNAME(PORT). Die Portnummer entspricht der Portnummer, die im Listener definiert ist, der dem Warteschlangen-Manager zugeordnet ist. Der Servername kann auch als IP-Adresse angegeben werden. Geben Sie für LU6.2 den LU-Namen oder den NAMEN des LU-Pools an, der in Host Integration Server konfiguriert ist.
    Herzschlag	Anzahl der Sekunden zwischen Überprüfungen, um zu überprüfen, ob die Client/Server-Verbindung funktioniert. Standardwert: 300
    Kennwort	Kennwort, das vom MCA verwendet werden kann, wenn versucht wird, eine sichere LU 6.2-Sitzung mit einer Remote-MCA zu initiieren. Der Anfangswert dieser optionalen Eigenschaft ist NULL.
    SSL-Verschlüsselungsspezifikation	Definiert eine einzelne CipherSpec für eine SSL-Verbindung, die von dem im Adapter konfigurierten Endpunkt verwendet wird. Beide Enden einer WebSphere MQ-SSL-Kanaldefinition müssen das Attribut enthalten, und der hier angegebene Wert sollte mit dem Namen übereinstimmen, der am Serverende des Kanals angegeben ist. Der Wert ist eine Zeichenfolge mit einer maximalen Länge von 32 Zeichen. Nur erforderlich, wenn SSL für die Kommunikation zwischen dem MQSeries-Client und Remotewarteschlangen-Managern konfiguriert ist.
    SSL-Peername	Wird verwendet, um den distinguished Name (auch als DN bezeichnet) des Zertifikats vom Peerwarteschlangen-Manager oder -Client am anderen Ende eines WebSphere MQ-Kanals zu überprüfen. Wenn der vom Peer empfangene distinguished Name nicht mit diesem Wert übereinstimmt, wird der Kanal nicht gestartet. Nur erforderlich, wenn SSL für die Kommunikation zwischen dem MQSeries-Client und dem Warteschlangen-Manager konfiguriert ist.
    Transporttyp	TCP und LU6.2 werden unterstützt. Standard: TCP
    Benutzer-ID	MCA-Benutzerbezeichner, der von MQSeries MCA für die Autorisierung für den Zugriff auf MQSeries-Ressourcen verwendet wird. Der Anfangswert ist NULL. Diese Eigenschaft ist optional. Wenn dieses Attribut leer ist, verwendet der MCA seinen Standardbenutzerbezeichner.

    Im Abschnitt MQSeries des Transport-Eigenschaftenfenster können Sie die folgenden Eigenschaften festlegen.

    Option	Aufgabe
    Zeichensatz	Zeichensatz, in den die Nachricht konvertiert werden soll, wenn Nachrichten aus der MQSeries-Warteschlange empfangen werden. Wenn diese Eigenschaft auf einen anderen Wert als None festgelegt ist, legt der Adapter die MQGMO CONVERT-Option fest, wenn ein MQGet ausgeführt wird. Keine: Konvertieren Sie nicht. UCS-2 und UTF-16: Konvertieren Sie in diese Zeichensätze. MQSeries unterscheidet nicht zwischen den Zeichensätzen. UTF-8: Konvertieren Sie in den UTF-8-Zeichensatz. Standardwert: Keine
    Segmentierung zulässig	Legen Sie fest, ob MQSeries segmentierte Nachrichten assemblieren oder die Nachrichten unverändert abrufen soll. Bei Auswahl von Keine Aktion werden die Nachrichten ohne Aktivierung der Segmentierung aus der MQSeries-Warteschlange gelesen. Bei Auswahl von Vollständige Nachricht assembliert MQSeries segmentierte Nachrichten vor der Weiterleitung an den Adapter. Standard: Keine Aktion

    Im Abschnitt Leistung des Transport-Eigenschaftenfenster können Sie die folgenden Eigenschaften festlegen.

    Option	Aufgabe
    Maximale Batchgröße	Maximale Größe eines Batches von Nachrichten in KB. Diese Eigenschaft und Maximum Messages in Batch arbeiten zusammen, sodass das Limit der wert ist, den der Adapter zuerst erreicht. Standardwert: 100
    Maximale Nachrichtenanzahl im Batch	Maximale Anzahl von Nachrichten zwischen 1 und 10.000 in einem Batch. Diese Eigenschaft und die maximale Batchgröße arbeiten zusammen, sodass der Grenzwert der Wert ist, den der Adapter zuerst erreicht. Standardwert: 10
    Threads	Anzahl der verwendeten Threads pro Empfangsspeicherort. Standardwert: 2

    Im Abschnitt Warteschlangendefinition des Transport-Eigenschaftenfenster können Sie die in der folgenden Tabelle aufgeführten Eigenschaften festlegen.

    Option	Aufgabe
    Warteschlange	MQSeries-Warteschlange, von der der Adapter Nachrichten (MQGet) empfängt. Übertragungswarteschlangen, lokale Warteschlangen, Aliaswarteschlangen werden unterstützt. Beachten Sie, dass dies eine Eigenschaft ist, bei der die Groß-/Kleinschreibung beachtet wird.
    Warteschlangen-Manager	Name des MQSeries-Warteschlangen-Managers, der die Warteschlangen enthält, aus denen der Adapter Nachrichten abruft. Gruppierte Warteschlangen-Manager werden unterstützt. Beachten Sie, dass dies eine Eigenschaft ist, bei der die Groß-/Kleinschreibung beachtet wird.

14. Klicken Sie auf OK.

Weitere Informationen

BizTalk-Adapter für WebSphere MQ
Konfigurieren einer Clientkanaldefinitionsdatei
Konfigurieren eines Sendeports für den MQSC-Adapter