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 SOAPAsyncRequest-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. Diese Überschreibungen in der lokalen Umgebung werden nur vom SOAPAsyncRequest-Knoten, nicht vom SOAPAsyncResponse-Knoten verwendet.

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

Unter LocalEnvironment.Destination.SOAP.Request können die folgenden Eigenschaften definiert werden:
Einstellung Beschreibung
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 nur der Anforderungstransport dieser Nachricht überschrieben. Der in der Eigenschaftengruppe des SOAPAsyncResponse-Knotens festgelegte Antworttransport wird nicht geändert.
Operation Überschreibt die Eigenschaft Operation auf dem Knoten. Beispiel:
SET OutputLocalEnvironment.Destination.SOAP.Request.Operation = 'myOperation';
UserContext Sie können 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 = 'myData';

LocalEnvironment-Überschreibungen für HTTP-Transport

Unter LocalEnvironment.Destination.SOAP.Request.Transport.HTTP können Sie die folgenden 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
WebServiceURL Überschreibt die Eigenschaft Web-Service-URL auf dem Knoten. Beispiel:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.WebServiceURL = 
'http://ibm.com/abc/';
RequestURI Überschreibt RequestURI, den Pfad hinter URL und Port. Beispiel:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.RequestURI = 
'/abc/def?x=y&g=h';
Timeout Überschreibt die Eigenschaft Zeitlimit für Anforderung (Sek) auf dem Knoten. Beispiel:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.Timeout = 42;
Dies ist die Zeit, die der Knoten auf eine HTTP 202-Bestätigung wartet, nicht die Zeit, die er auf die zugehörige Web-Service-Antwort wartet.
ProxyURL Überschreibt die Eigenschaft HTTP(S)-Proxyadresse auf dem Knoten. Beispiel:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.ProxyURL = 
'my.proxy';
SSLProtocol Überschreibt die Eigenschaft SSL-Protokoll auf dem Knoten. Beispiel:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.SSLProtocol = 
'TLS';

Folgende Werte sind gültig: SSL, SSLv3 und TLS.

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';
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.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';
Compression Überschreibt die Eigenschaft Use compression (Komprimierung verwenden) des Knotens. Beispiel:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.Compression = 
'gzip';

Überschreibungen der lokalen Umgebung für JMS-Transport

Im SOAPAsyncRequest-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 SOAPAsyncRequest-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
CorrelationID Legt die Korrelations-ID der Anforderungsnachricht fest. Beispiel:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.CorrelationID  = 
'myCorrelID';
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';
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';
TargetService Überschreibt die Eigenschaft Zielservice auf dem Knoten. Beispiel:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.TargetService = 
'testService';
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.

Überschreibungen der lokalen Umgebung für JNDI

Im SOAPAsyncRequest-Knoten unter LocalEnvironment.Destination.SOAP.Request.Transport.JMS.JNDI können Sie die folgenden JMS-Eigenschaften festlegen. Diese Eigenschaften gelten nur für den JMS-Transport.

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:/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';
InitialContextFactory Überschreibt die Eigenschaft Ausgangskontextfactory auf dem Knoten. Beispiel:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.JNDI.InitialContextFactory = 
'com.sun.jndi.fscontext.RefFSContextFactory';
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';

Überschreibungen der lokalen Umgebung für die 'ReplyTo'-Eigenschaften der WS-Adressierung

Im SOAPAsyncRequest-Knoten unter LocalEnvironment.Destination.SOAP.Request.Transport.JMS.AsyncReply können Sie die folgenden ReplyTo-Eigenschaften der JMS-WS-Adressierung festlegen. Stellen Sie diese Eigenschaften ein, wenn Sie die Art, wie der ferne Server die JNDI-Definitionen für die Antwortwarteschlange lokalisiert, überschreiben wollen.

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.

Einstellung Beschreibung
BindingsLocation Überschreibt die Eigenschaft BindingsLocation der ReplyTo-Eigenschaften der WS-Adressierung.
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.AsyncReply.JNDI.BindingsLocation = 
'file:/C:/webservices/SOAP/JMS/JNDI';
ConnectionFactoryName Überschreibt die Eigenschaft ConnectionFactoryName der ReplyTo-Eigenschaften der WS-Adressierung.
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.AsyncReply.JNDI.ConnectionFactoryName = 
'QCF';
ContextParameters Gibt die JNDI-Kontextparameter in den ReplyTo-Eigenschaften der WS-Adressierung an. Es können spezielle JNDI-Kontextparameter definiert werden, beispielsweise:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.AsyncReply.JNDI.ContextParameters.property1 = 
'value1';
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.AsyncReply.JNDI.ContextParameters.property2 = 
'value2';
InitialContextFactory Überschreibt die Eigenschaft InitialContextFactory der ReplyTo-Eigenschaften der WS-Adressierung.
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.AsyncReply.JNDI.InitialContextFactory = 
'com.sun.jndi.fscontext.RefFSContextFactory';
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
Wenn die eingehende Nachricht den HTTP-Transport verwendet hat, sendet der Knoten eine HTTP 202-Bestätigungsnachricht. Wenn die eingehende Nachricht den JMS-Transport verwendet hat, wird keine Antwort erwartet. Die abgehende Nachricht hat keine Warteschlange für zu beantwortende Nachrichten und der Knoten wartet nicht auf eine 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:23


ReferenzthemaReferenzthema | Version 8.0.0.5 | ac56202_