Sie können die Administrationskonsole verwenden, um ein Ziel vom Typ "Warteschlange" zu erstellen und dieses einer
IBM MQ-Warteschlange zuzuordnen.
Wählen Sie den IBM MQ-Server aus, dem Sie die Warteschlange zuordnen möchten, und geben Sie anschließend
die zuzuordnende IBM MQ-Warteschlange an.
Vorbereitende Schritte
Erfragen Sie den Namen der
IBM MQ-Warteschlange bei Ihrem Administrator und stellen Sie sicher, dass die folgende
Konfiguration vorhanden ist:
Anmerkung: Eine gemeinsam nutzbare Warteschlange kann von mehreren Serviceintegrationsanwendungen
aufgerufen werden.
Legen Sie die Methode fest, die Sie für die Konfiguration dieser Ressourcen verwenden möchten. Sie können ein Busziel, wie in dieser Task
beschrieben, über die Administrationskonsole erstellen, oder Sie können den
Befehl "createSIBDestinations" verwenden.
Informationen zu diesem Vorgang
Nachdem Sie einen
IBM MQ-Server
als Busmember hinzugefügt haben, können Sie ein Ziel vom Typ "Warteschlange" im Busmember erstellen, das
eine
IBM MQ-Warteschlange als Warteschlangenpunkt verwendet.
Diese Konfiguration bietet Serviceintegrationsanwendungen die Möglichkeit, Nachrichten an diese Warteschlange zu senden und von ihr zu empfangen.
Vorgehensweise
- Starten Sie die Administrationskonsole.
- Navigieren Sie zur Liste mit den Zielen für den entsprechenden Bus.
Klicken Sie auf .
Das Formular
Ziele [Sammlung] wird angezeigt.
- Klicken Sie auf Neu. Die Anzeige "Neues Ziel erstellen" erscheint.
- Wählen Sie Warteschlange als Zieltyp aus und klicken Sie anschließend auf
Weiter. Der Assistent "Neue Warteschlange erstellen" erscheint.
- Legen Sie die Warteschlangenattribute fest. Geben Sie den Namen, den
WebSphere Application Server verwenden soll, um auf die zugeordnete
IBM MQ-Warteschlange zu verweisen, und (optional) eine Beschreibung der Warteschlange ein.
- Ordnen Sie die Warteschlange dem Busmember zu, das die Nachrichten für die Warteschlange speichern und verarbeiten soll.
Wählen Sie ein Busmember vom Typ "IBM MQ-Server" in der Liste der verfügbaren Busmember aus.
- Legen Sie die Attribute für den IBM MQ-Warteschlangenpunkt fest:
- Geben Sie im Feld Filter für IBM MQ-Warteschlangennamen einen Wert ein und klicken Sie anschließend auf
Los.
Der Assistent erkennt die verfügbaren IBM MQ-Warteschlangen automatisch. In einigen IBM MQ-Topologien können jedoch
Tausende von Warteschlangen für einen Warteschlangenmanager definiert sein. Verwenden Sie diesen Filter, um die Anzahl der aufgelisteten Warteschlangen einzuschränken.
Der Standardfilterwert ist ein Stern (*). Wenn dieser Wert (oder kein Wert) angegeben wird, werden alle Warteschlangen bzw. alle Warteschlangen eines bestimmten Typs (basierend auf der definieren
angepassten Eigenschaften für den Warteschlangentyp) aufgelistet.
Jeder andere Wert, den Sie angeben, muss die folgenden Kriterien erfüllen:- Er muss zwischen 1 und 48 Zeichen enthalten.
- Er muss den Benennungsregeln für IBM MQ-Warteschlangen entsprechen. (Informationen hierzu finden Sie im Artikel zu den Regeln für die Benennung von IBM MQ-Objekten im Informatinen Center von IBM MQ.)
Sie können auch ein Platzhalterzeichen (*) in Verbindung mit Text verwenden. Wenn Sie beispielsweise den Wert PAYROLL* angeben,
werden alle verfügbaren Warteschlangen aufgelistet, deren Name mit PAYROLL beginnt.
- Geben Sie einen IBM MQ-Warteschlangennamen an.
Wählen Sie in der gefilterten Liste einen Warteschlangennamen aus. Wenn die Liste nicht die gewünschte Warteschlange enthält,
wählen Sie den letzten Eintrag in der Liste, Andere angeben, aus. Daraufhin erscheint ein Texteingabefeld neben der Dropdown-Liste. Geben Sie in diesem Texteingabefeld den Warteschlangennamen ein.
Wenn die Warteschlange auf dem fernen System mit IBM MQ vorhanden ist, werden die
Eigenschaften der Warteschlange, die in IBM MQ definiert sind, als schreibgeschützte Felder angezeigt. Damit können Sie sicherstellen, dass Sie die gewünschte
Warteschlange gefunden haben und dass diese wie erwartet konfiguriert ist.
Wenn die Warteschlange nicht gefunden wird, sind diese schreibgeschützten Felder nicht in der Sicht enthalten.
- Geben Sie die Zuverlässigkeitsstufen an, die Sie benötigen, wenn eingehende nicht persistente und eingehende persistente
IBM MQ-Nachrichten in Nachrichten mit Serviceintegrationsformat konvertiert werden.
Anwendungen empfangen Nachrichten direkt von der angegebenen IBM MQ-Warteschlange,
so dass die Zuverlässigkeitsstufe für eine Nachricht im Allgemeinen für den Empfänger nicht relevant ist, weil die Nachricht bereits erfolgreich zugestellt wurde. Die Nachricht
wird jedoch beim Empfang in eine Nachricht im Serviceintegrationsformat (und gewöhnlich in eine Serviceintegrationsnachricht im JMS-Format) konvertiert, und diese Option
gibt die Zuverlässigkeitsstufe für die Nachricht im Serviceintegrationsformat an. Informationen zu den verfügbaren Zuverlässigkeitsstufen finden Sie im Artikel
IBM MQ-Warteschlangenpunkte [Einstellungen].
- Geben Sie an, ob IBM MQ einen
MQRFH2-Nachrichtenheader einfügen soll, wenn Nachrichten an die Warteschlange gesendet werden.
Im MQRFH2-Header werden Messaging-Informationen für die Serviceintegration gespeichert, die
kein entsprechendes Headerfeld in der IBM MQ-Nachricht haben. Wenn eine Nachricht an das Ziel gesendet wird, weist die Serviceintegration
IBM MQ an, die Nachricht in die Warteschlange zu schreiben. Diese Option gibt an, ob
die Serviceintegration IBM MQ anweist, die Nachricht mit einem MQRFH2-Header zu schreiben.
Wenn der Konsument der Nachricht eine JMS-Anwendung ist, die in IBM MQ oder in der Serviceintegration ausgeführt wird, eine IBM MQ-XMS-Anwendung oder eine IBM MQ-MQI-Anwendung, die einen MQRFH2 erwartet, wählen Sie diese Option aus. Wenn der Konsument eine IBM MQ-MQI-Anwendung ist, die keinen MQRFH2-Header erwartet, wählen Sie diese Option nicht aus.
- Klicken Sie auf Weiter.
- Klicken Sie auf Fertigstellen, um die Erstellung der Warteschlange zu bestätigen.
Ergebnisse
Sie haben ein Warteschlangenziel mit einem
IBM MQ-Warteschlangenpunkt erstellt.