Vorbereitende Schritte
Vorgehensweise
So senden Sie eine Anforderung an einen Java MQ-Service:
- Klicken Sie auf Generic Service Client öffnen (
) und wählen Sie die Seite Anforderungen aus. - Klicken Sie auf Hinzufügen (
) oder
klicken Sie in der Anforderungsbibliothek mit der rechten Maustaste auf Endpunkte und wählen Sie
einen Anforderungstyp aus, den Sie senden möchten. - Wählen Sie im Fenster "Protokoll konfigurieren" die Option WebSphere Java MQ aus und geben Sie die Transportkonfiguration an. Erstellen Sie bei Bedarf die Transportkonfiguration für den Aufruf, indem Sie auf Neu klicken (siehe WebSphere Java MQ-Transportkonfiguration erstellen).
- Vervollständigen Sie die folgenden Informationen auf der Registerkarte Allgemein:
- Warteschlange
- Name der Warteschlange gemäß der Definition auf dem WebSphere MQ-Server.
- Nachrichtentyp
- Es gibt folgende Nachrichtentypen:
- Datagramm bedeutet, dass für die Nachricht keine Antwort erforderlich ist.
- Anforderung bedeutet, dass für die Nachricht eine Antwort erforderlich ist.
- Antwort bedeutet, dass die Nachricht eine Antwort auf eine vorherige Anforderungsnachricht ist.
- Bericht bedeutet, dass die Nachricht ein erwartetes oder nicht erwartetes Vorkommen meldet, das sich in der Regel auf eine andere Nachricht bezieht. Ein Beispiel hierfür ist eine Anforderungsnachricht, die ungültige Daten enthalten hat.
- Nachrichtenpersistenz
Dieser Wert zeigt an, ob die Nachricht persistent ist oder nicht. Wenn die Nachricht persistent ist, übersteht sie Systemausfälle und Neustarts des Warteschlangenmanagers. Wenn die Nachricht nicht persistent ist, übersteht sie einen Neustart nur, wenn sie in einer Warteschlange enthalten ist, die über das Attribut NPMCLASS(HIGH) verfügt. Selbst mit dem Attribut NPMCLASS(HIGH) übersteht eine Nachricht keine QMGR-Klasse. Nicht persistente Nachrichten in Warteschlangen mit dem Attribut NPMCLASS(NORMAL) werden beim Neustart des Warteschlangenmanagers verworfen, auch wenn die Nachricht während des Wiederanlaufverfahrens im Zusatzspeicher gefunden wird.
- Dynamische Antwort
- Aktivieren Sie dieses Kontrollkästchen, damit der WebSphere MQ-Server als Antwort eine temporäre Warteschlange dynamisch erstellt. Wenn dieses Kontrollkästchen nicht aktiviert ist, wird die Nachricht in der Antwortwarteschlange verwendet.
- Antwortwarteschlange
Dies ist der Name der Nachrichtenwarteschlange, an die die Anwendung, von der die Abrufanforderung für die Nachricht ausgegeben wurde, die Antwort und Berichtsnachrichten senden soll.
- Antwortmanager
Dies ist der Name des Antwortmanagers, auf dem die Warteschlange für zu beantwortende Nachrichten definiert ist.
- Zusätzliche Eigenschaften
- Geben Sie die zusätzlichen Eigenschaften für die Warteschlangen an.
- Optional: Vervollständigen Sie bei Bedarf die folgenden Informationen auf der Registerkarte Konfiguration:
- Nachrichtenpriorität
Dies ist die Priorität der Nachricht. Die niedrigste Priorität ist 0.
- Codierung
Dies ist die numerische Codierung von numerischen Daten in der Nachricht. Dieser Wert gilt nicht für numerische Daten in der MQMD-Struktur selbst.
- Ablaufintervall
Dies ist die Zeitspanne (in Zehntelsekunden), nach der die Nachricht nicht mehr gelöscht werden darf, wenn sie noch nicht aus der Zielwarteschlange entfernt wurde. Das Ablaufintervall wird von der Anwendung festgelegt, von der die Nachricht stammt.
- Zeichensatz
Dies ist die Zeichensatz-ID der Zeichendaten in den Anwendungsnachrichtendaten.
- Optional: Wählen Sie auf der Registerkarte Bericht die zu empfangenden Berichtsnachrichten aus.
- Optional: Vervollständigen Sie bei Bedarf die folgenden Informationen auf der Registerkarte Kontext:
- Anwendungsidentitätsdaten
Diese Informationen sind von der Anwendungssuite definiert. Sie können damit Details zur Nachricht oder ihrem Absender bereitstellen.
- Anwendungsursprungsdaten
Diese Informationen sind von der Anwendungssuite definiert. Sie können damit weitere Details zum Ursprung der Nachricht bereitstellen.
- Abrechnungstoken
Diese Informationen werden von der Anwendung benötigt, damit die Arbeit, die als Ergebnis der Nachricht ausgeführt wird, ordnungsgemäß in Rechnung gestellt werden kann.
- Benutzer-ID
Dies ist die Benutzer-ID der Anwendung, von der die Nachricht stammt.
- Optional: Geben Sie auf der Registerkarte Kennungen für die Nachrichten, die eine binäre Eingabe erfordern, die ID in der zweiten Spalte im Zeichenfolgenformat an. Die erste Spalte wird automatisch im Hexadezimalformat ausgefüllt.
- Optional: Wählen Sie auf der Registerkarte Segmentierung das Segment der Nachricht aus und klicken Sie auf Weiter.
- Dieser Schritt gilt nicht für eine Textanforderung. Wenn der Service eine bestimmte XSD (XML Schema Definition) verwendet, wählen Sie auf der Seite "Stammelement auswählen" eine XSD in der Liste aus. Wenn das XSD-Element nicht aufgeführt ist, klicken Sie auf Durchsuchen, um die XSD-Datei zu importieren. Wählen Sie anschließend das Stammelement für die Anforderung aus. Wenn für den Service keine XSD verfügbar ist, wählen Sie Kein Schema aus.
- Klicken Sie auf Fertig stellen. Die Anforderung wird zum Bereich Endpunkte der Anforderungsbibliothek hinzugefügt.
- Wählen Sie in der Anforderungsbibliothek das Anforderungselement aus. Im Generic Service Client werden drei Schritte gezeigt: Daten bearbeiten, Aufrufen und Antwort anzeigen. Die Details für die Anforderung werden im Schritt Daten bearbeiten angezeigt.
- Verwenden Sie basierend auf der Anforderung in Schritt 2 auf der Seite Nachricht die Sichten Formular, Baum oder Quelle, um die Inhalte der Anforderung zu bearbeiten. In jeder Sicht werden die gleichen Daten in einem anderen Format angezeigt. Wenn Sie XML-Elemente in der Sicht Formular oder Baum hinzufügen oder daraus entfernen möchten, klicken Sie auf Schema > Prüfung und Unterstützung, um einer im Schemakatalog angegebenen XSD zu entsprechen.
- Ändern Sie auf der Seite Transport bei Bedarf die Transportkonfiguration, die von der Anforderung verwendet wird. Verwenden Sie die Registerkarte Transport, um die Transport- und Sicherheitskonfiguration zu erstellen und zu bearbeiten.
- Wenn Sie die SOAP XML-Anforderung in Schritt 2 ausgewählt haben, geben Sie auf der Seite Anforderungsstapel an, ob die Sicherheits- oder Verarbeitungsalgorithmen überschrieben werden sollen, die auf die abgehende Anforderung für die WSDL-Datei angewendet werden. Klicken Sie zum Hinzufügen eines Antwortstapels zur Bearbeitung der Sicherheits- oder Verarbeitungsalgorithmen für eingehende Antworten auf Antwortstapel anzeigen.
Anmerkung: Diese Einstellungen gelten nur für die aktuelle Anforderung. Wenn Sie den Anforderungs- oder Antwortstapel für alle Anforderungen bearbeiten möchten, die die aktuelle WSDL-Datei verwenden, klicken Sie aufWSDL-Sicherheit bearbeiten, um den WSDL Security Editor zu öffnen.
- Wenn Sie fertig sind, klicken Sie auf Aufrufen, um die Serviceanforderung zu senden. Der Generic Service Client sendet die Anforderung und zeigt die Nachrichtenrückgabe im Schritt Antwort anzeigen an.
Nächste Schritte
) klicken, um einen Servicetest zu erstellen.