WebSphere Message Broker Version 8.0.0.5 Betriebssysteme: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Sehen Sie sich die Informationen zur aktuellen Produktversion im IBM Integration Bus Version 9.0 an.

Überschreibungen für den SOAPRequest-Knoten in der lokalen Umgebung

In der lokalen Umgebung können Sie Werte auf die gleiche Weise dynamisch überschreiben wie in anderen Elementen einer Nachricht.

Für die WS-Adressierung sind weitere Überschreibungen in der lokalen Umgebung verfügbar. Weitere Informationen hierzu finden Sie unter WS-Adressierung mit dem SOAPRequest-Knoten.

Im SOAPRequest-Knoten unter LocalEnvironment.Destination.SOAP.Request können Sie die folgenden Eigenschaften festlegen. Diese Überschreibungen in der lokalen Umgebung gelten auch für den SOAPAsyncRequest-Knoten.
Einstellung Beschreibung
Operation Überschreibt die Eigenschaft Operation auf dem Knoten. Beispiel:
SET OutputLocalEnvironment.Destination.SOAP.Request.Operation = 'myOperation';
TransportType Überschreibt die Eigenschaft Transport auf dem Knoten, um den Transporttyp zu ändern. Wenn der Knoten zum Beispiel mit JMS-Transport konfiguriert ist, können Sie den Transportmodus wie folgt auf HTTP-Transport umstellen:
SET OutputLocalEnvironment.Destination.SOAP.Request.TransportType = 'http';
Wechsel auf JMS-Transport:
SET OutputLocalEnvironment.Destination.SOAP.Request.TransportType = 'jms';
Dadurch wird der Anforderungs- und Antworttransport dieser Nachricht überschrieben.
UserContext Sie können BLOB-Kontextdaten an der folgenden Position in der lokalen Umgebung speichern. Diese Daten können später vom SOAPAsyncResponse-Knoten abgerufen werden.
SET OutputLocalEnvironment.Destination.SOAP.Request.UserContext = x'aabbccddeeff11223344556677889900';
In UserContext gespeicherte Daten müssen im BLOB-Format sein. Dieses Feld ist im Nachrichtenbitstrom enthalten und erhöht daher die Nachrichtengröße.

Diese Einstellung gilt nur für den SOAPAsyncRequest-Knoten; vom SOAPRequest-Knoten wird sie ignoriert.

LocalEnvironment-Überschreibungen für HTTP-Transport

Im SOAPRequest-Knoten unter LocalEnvironment.Destination.SOAP.Request.Transport.HTTP können Sie die folgenden HTTP-Eigenschaften festlegen. Diese Eigenschaften gelten nur für den HTTP-Transport. Zwischen dem HTTP- und dem JMS-Transport können Sie mit der Überschreibung TransportType oder dem Feld To der WS-Adressierung wechseln; vergleichen Sie hierzu WS-Adressierungsdaten in der lokalen Umgebung.
Einstellung Beschreibung
Compression Überschreibt die Eigenschaft Use compression (Komprimierung verwenden) des Knotens. Beispiel:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.Compression = 'gzip';
Zur Festlegung einer Mindestgröße (in Byte), ab der komprimiert wird, verwenden Sie folgende Überschreibung:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.MinimumCompressionSize = 1048576;
HTTPVersion Überschreibt die HTTP-Version. Beispiel:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.HTTPVersion = 
'HTTP/1.1';
Methode Überschreibt die Methode. Beispiel:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.Method = 'GET';
ProxyConnectHeaders Gibt zusätzliche Header an, die verwendet werden, wenn es sich bei der abgehenden Anforderung um eine SSL-Verbindung über einen Proxy handelt. Diese zusätzlichen Header werden mit der einleitenden CONNECT-Anforderung an den Proxy gesendet. Sie können beispielsweise Proxy-Authentifizierungsdaten an einen Proxy-Server senden, wenn Sie SSL verwenden. Es können mehrere Header gesendet werden, die jedoch alle durch einen Rücklauf und einen Zeilenvorschub (ASCII 0x0D 0x0A) in Übereinstimmung mit RFC2616 getrennt sein müssen; Beispiel:
DECLARE CRLF CHAR CAST(X'0D0A' AS CHAR CCSID 1208);     
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.ProxyConnectHeaders =
'Proxy-Authorization: Basic Zm5lcmJsZTpwYXNzd29yZA==' || CRLF || 
'Proxy-Connection: Keep-Alive' || CRLF;
Diese Einstellung wird nur verwendet, wenn es sich bei der Anforderung um eine SSL-Anforderung über einen Proxy-Server handelt. Um Proxy-Authentifizierungsdaten für eine Nicht-SSL-Anforderung zu senden, müssen Sie die einzelnen Header im Ordner 'HTTPRequestHeader' angeben, so wie im folgenden Beispiel gezeigt:
SET OutputRoot.HTTPRequestHeader."Proxy-Authorization" = 'Basic Zm5lcmJsZTpwYXNzd29yZA==';
SET OutputRoot.HTTPRequestHeader."Proxy-Connection" = 'Keep-Alive';
ProxyURL Überschreibt die Eigenschaft HTTP(S)-Proxyadresse auf dem Knoten. Beispiel:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.ProxyURL = 
'my.proxy';
RequestURI Überschreibt RequestURI, den Pfad hinter URL und Port. Beispiel:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.RequestURI = 
'/abc/def?x=y&g=h';
SSLCiphers Überschreibt die Eigenschaft Erlaubte SSL-Verschlüsselungen (bei Verwendung von SSL) auf dem Knoten. Beispiel:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.SSLCiphers = 
'SSL_RSA_FIPS_WITH_3DES_EDE_CBC_SHA';
SSLProtocol Überschreibt die Eigenschaft SSL-Protokoll auf dem Knoten. Beispiel:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.SSLProtocol = 
'TLS';

Gültige Werte sind SSL, SSLv3 und TLS.

Timeout Überschreibt die Eigenschaft Zeitlimit für Anforderung (Sek) auf dem Knoten. Beispiel:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.Timeout = 42;
TimeoutMillis Überschreibt die Eigenschaft Zeitlimit für Anforderung (Sek) auf dem Knoten. Beispiel:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.TimeoutMillis = 5000;
Diese Eigenschaft legt das Zeitlimit in Millisekunden fest. Der Wert von TimeoutMillis überschreibt den Wert für Timeout, falls beide Werte angegeben sind.
WebServiceURL Überschreibt die Eigenschaft Web-Service-URL auf dem Knoten. Beispiel:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.WebServiceURL = 
'http://ibm.com/abc/';

LocalEnvironment-Überschreibungen für JMS-Transport

Im SOAPRequest-Knoten unter LocalEnvironment.Destination.SOAP.Request.Transport.JMS können Sie die folgenden JMS-Eigenschaften festlegen. Diese Eigenschaften gelten nur für den JMS-Transport. Zwischen dem HTTP- und dem JMS-Transport können Sie mit der Überschreibung TransportType oder dem Feld To der WS-Adressierung wechseln; vergleichen Sie hierzu WS-Adressierungsdaten in der lokalen Umgebung.

Für einige JMS-Überschreibungen der lokalen Umgebung für den SOAPRequest-Knoten enthält der JMSTransport-Header äquivalente Eigenschaften. Wenn Sie Überschreibungen der lokalen Umgebung angeben, haben diese Vorrang vor äquivalenten Eigenschaften im JMSTransport-Header.

Einstellung Beschreibung
BindingsLocation Überschreibt die Eigenschaft Position der JNDI-URL-Bindungen auf dem Knoten. Beispiel:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.JNDI.BindingsLocation = 
'file:/C:/mqsi6/Webservices/SOAP/JMS/JNDI';
ConnectionFactoryName Überschreibt die Eigenschaft Verbindungsfactoryname auf dem Knoten. Beispiel:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.JNDI.ConnectionFactoryName = 
'QCF';
ContextParameters Geben Sie zusätzlich zu den auf dem Knoten definierten JNDI-Kontextparametern weitere JNDI-Kontextparameter an. Es können spezielle JNDI-Kontextparameter definiert werden, beispielsweise:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.JNDI.ContextParameters.property1 = 
'value1';
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.JNDI.ContextParameters.property2 = 
'value2';
CorrelationID Legt die Korrelations-ID der Anforderungsnachricht fest. Beispiel:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.CorrelationID  = 
'myCorrelID';
CorrelationPattern Legt das Korrelationsmuster der Anforderungsnachricht fest. Beispiel:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.CorrelationPattern  = 
1;
Die zulässigen Werte sind die Ganzzahlen 1 und 2:
  • 1 gibt an, dass die Nachrichten automatisch durch die Korrelations-ID korreliert werden sollen, wenn eine vorhanden ist. Andernfalls werden die Nachrichten durch die Nachrichten-ID korreliert. Dies ist das Standardverhalten.
  • 2 erzwingt die Korrelation der Nachrichten durch die Nachrichten-ID, auch wenn eine Korrelations-ID vorhanden ist.
DeliveryMode Überschreibt die Eigenschaft Zustellmodus auf dem Knoten. Beispiel:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.DeliveryMode = 
'NON_PERSISTENT';
Gültige Werte für diese Eigenschaft sind PERSISTENT (permanent)und NON_PERSISTENT (nicht permanent). Wenn das UriFormat ibm ist, stehen als gültige Werte für DeliveryMode zusätzlich 1 und 0 zur Verfügung.
Destination Überschreibt die Eigenschaft Ziel auf dem Knoten. Beispiel:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.Destination = 
'REPLYTOQ2';
DestinationURI Mit der Einstellung "DestinationURI" können Sie in der lokalen Umgebung mehrere JMS-Eigenschaften gleichzeitig überschreiben. Eigenschaften, die Sie auf diese Weise einstellen, können, wie in den folgenden Tabellen gezeigt, durch Überschreibungen der lokalen Umgebung für einzelne JMS-Eigenschaften überschrieben werden.
SET OutputLocalEnvironment.Destination.SOAP.Reply.Transport.JMS.DestinationURI = 
		'jms:jndi:INPUTQ1?jndiConnectionFactoryName=QCF&
	replyToName=REPLYTOQ2&
	jndiInitialContextFactory=com.sun.jndi.fscontext.RefFSContextFactory&
		jndiURL=file:/C:/Webservices/SOAP/JMS/JNDI&
	userParam1=value1&
	userParam2=value2&
	timeToLive=30000';
Diese Überschreibung der lokalen Umgebung kann sowohl für URIs im W3C-Format als auch für URIs im IBM Format verwendet werden. Der Abschnitt WSDL-URI-Formate für JMS enthält weitere Informationen hierzu.
Expiration Überschreibt die Eigenschaft Ablauf auf dem Knoten. Diese Eigenschaft wird in Millisekunden angegeben. So legen Sie zum Beispiel einen Ablauf nach 100 Millisekunden fest:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.Expiration = 
'100';
InitialContextFactory Überschreibt die Eigenschaft Ausgangskontextfactory auf dem Knoten. Beispiel:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.JNDI.InitialContextFactory = 
'com.sun.jndi.fscontext.RefFSContextFactory';
MessagePriority Überschreibt die Eigenschaft Nachrichtenpriorität auf dem Knoten. Beispiel:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.MessagePriority = 
'7';
MessageType Überschreibt die Eigenschaft Nachrichtentyp auf dem Knoten. Beispiel:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.MessageType = 
'text';
Gültige Werte für diese Eigenschaft sind text und bytes.
ProviderName Überschreibt die Eigenschaft JMS-Providername auf dem Knoten. Beispiel:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.ProviderName = 
'WebSphere MQ';
ReplyToDestination Überschreibt die Eigenschaft ReplyToDestination auf dem Knoten. Beispiel:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.ReplyToDestination = 
'REPLYTOQ3';
TargetService Überschreibt die Eigenschaft Zielservice auf dem Knoten. Beispiel:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.TargetService = 
'testService';
Timeout Überschreibt die Eigenschaft Zeitlimitüberschreitung auf dem Knoten. Dieser Wert wird in Sekunden angegeben. So legen Sie z. B. ein Zeitlimit von 30 Sekunden fest:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.Timeout = 
'30';
TransactionMode Überschreibt die Eigenschaft Transaktionsmodus auf dem Knoten. Beispiel:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.TransactionMode = 'Yes';
Zulässige Werte für diese Eigenschaft sind Yes, No und ForceLocal.
  • No bedeutet, dass keine Transaktion stattfindet, und ist äquivalent zu None.
  • Yes bedeutet, dass eine lokale Transaktion stattfindet, wenn Koordinierte Transaktion für den Nachrichtenfluss nicht ausgewählt ist, oder eine XA-koordinierte Transaktion stattfindet, wenn die Eigenschaft Koordinierte Transaktion des Nachrichtenflusses ausgewählt ist.
  • ForceLocal bedeutet, dass immer eine lokale Transaktion verwendet wird, auch wenn die Eigenschaft Koordinierte Transaktion ausgewählt ist.
UriFormat Überschreibt die Eigenschaft URI-Format auf dem Knoten. Beispiel:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.UriFormat  = 
'w3c';
Gültige Werte für diese Eigenschaft sind w3c und ibm.
UserProperties Geben Sie zusätzlich zu den auf dem Knoten definierten Benutzerkontextparametern weitere Benutzerkontextparameter an: Es können spezielle Benutzerkontextparameter definiert werden, beispielsweise:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.JNDI.UserProperties.property1 = 
'value1';
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.JNDI.UserProperties.property2 = 
'value2';
Einstellung Beschreibung
OneWay Setzt den Knoten davon in Kenntnis, dass die eingehende Nachricht eine unidirektionale Nachricht war und dass keine Antwortnachricht erforderlich ist. Beispiel:
SET OutputLocalEnvironment.Destination.SOAP.Request.Gateway.OneWay = True

Wird die Nachricht über den HTTP-Transport gesendet, wartet der Knoten auf den Eingang des HTTP-Antwortcodes 202 mit der Bestätigung vom fernen Server. Wird die Nachricht über den JMS-Transport gesendet, wird keine Antwort erwartet. In diesem Beispiel ist für die abgehende Nachricht keine Warteschlange für zu beantwortende Frage vorhanden und der Knoten wartet auf keine Antwort.

Der Abschnitt Unidirektionale Nachrichten im Gateway-Modus enthält weitere Informationen hierzu.

Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2015-02-28 16:20:22


ReferenzthemaReferenzthema | Version 8.0.0.5 | ac56192_