WebSphere Message Broker バージョン 8.0.0.5 オペレーティング・システム: AIX、HP-Itanium、Linux、Solaris、Windows、z/OS

製品の最新バージョンについては、IBM Integration Bus バージョン 9.0 をご覧ください。

ローカル環境の指定変更 (SOAPReply ノード)

メッセージの他のエレメントに値を設定する方法と同じ方法で、ローカル環境の設定値を動的に指定変更できます。

WS-Addressing では、ローカル環境のその他の指定変更値も使用できます。 SOAPReply ノードでの WS-Addressingを参照してください。

SOAPReply ノードでは、LocalEnvironment.Destination.SOAP.Request.Transport.HTTP.AsyncReply の下にある以下の HTTP プロパティーを設定できます。 これらのプロパティーは、WS-Addressing を使用して HTTP 応答を行う場合にのみ適用されます。 HTTP トランスポートと JMS トランスポートは、WS-Addressing の「To」フィールドを使用して、切り替えることができます。ローカル環境内の WS-Addressing 情報を参照してください。
設定 説明
HTTPVersion HTTPVersion」を指定変更します。 以下に例を示します。
SET OutputLocalEnvironment.Destination.SOAP.Reply.Transport.HTTP.AsyncReply.HTTPVersion = 
'HTTP/1.1';
Method 応答メッセージ「メソッド」を指定変更します。 以下に例を示します。
SET OutputLocalEnvironment.Destination.SOAP.Reply.Transport.HTTP.AsyncReply.Method = 'GET';
ProxyConnectHeaders アウトバウンド要求がプロキシーを介した SSL 接続である場合に使用される、追加のヘッダーを指定します。 これらの追加ヘッダーは、最初の CONNECT 要求と共にプロキシーに送信されます。 例えば、SSL を使用している場合、プロキシー・サーバーにプロキシー認証情報を送信できます。 複数のヘッダーを送信できますが、各ヘッダーは RFC2616 に基づいて復帰と改行 (ASCII 0x0D 0x0A) で区切る必要があります。 例えば、
DECLARE CRLF CHAR CAST(X'0D0A' AS CHAR CCSID 1208);     
SET OutputLocalEnvironment.Destination.SOAP.Reply.Transport.HTTP.AsyncReply.ProxyConnectHeaders =
'Proxy-Authorization: Basic Zm5lcmJsZTpwYXNzd29yZA==' || CRLF || 
'Proxy-Connection: Keep-Alive' || CRLF;
この設定は、要求がプロキシー・サーバーを介した SSL 要求である場合にのみ使用されます。 非 SSL 要求に対するプロキシー認証情報を送信するには、以下の例に示されているように、HTTPRequestHeader フォルダー内の個々のヘッダーを指定します。
SET OutputRoot.HTTPReplyHeader."Proxy-Authorization" = 'Basic Zm5lcmJsZTpwYXNzd29yZA==';
SET OutputRoot.HTTPReplyHeader."Proxy-Connection" = 'Keep-Alive';
ProxyURL 応答メッセージ「HTTP(S) プロキシーの位置」を指定変更します。 以下に例を示します。
SET OutputLocalEnvironment.Destination.SOAP.Reply.Transport.HTTP.AsyncReply.ProxyURL = 
'my.proxy';
RequestURI URL とポートの後のパスである応答メッセージ「RequestURI」を指定変更します。 以下に例を示します。
SET OutputLocalEnvironment.Destination.SOAP.Reply.Transport.HTTP.AsyncReply.RequestURI = 
'/abc/def?x=y&g=h';
SSLCiphers 応答メッセージ「許可された SSL 暗号 (SSL 使用の場合)」を指定変更します。 以下に例を示します。
SET OutputLocalEnvironment.Destination.SOAP.Reply.Transport.HTTP.AsyncReply.SSLCiphers = 
'SSL_RSA_FIPS_WITH_3DES_EDE_CBC_SHA';
SSLProtocol 応答メッセージ「SSLProtocol」を指定変更します。 以下に例を示します。
SET OutputLocalEnvironment.Destination.SOAP.Reply.Transport.HTTP.AsyncReply.SSLProtocol = 
'TLS';

有効値は、SSL、SSLv3、および TLS です。

Timeout 応答メッセージ「要求タイムアウト (秒)」を指定変更します。 以下に例を示します。
SET OutputLocalEnvironment.Destination.SOAP.Reply.Transport.HTTP.AsyncReply.Timeout = 42;
WebServiceURL 応答メッセージ「Web サービス URL」を指定変更します。 以下に例を示します。
SET OutputLocalEnvironment.Destination.SOAP.Reply.Transport.HTTP.AsyncReply.WebServiceURL = 
'http://ibm.com/abc/';
SOAPReply ノードでは、LocalEnvironment.Destination.SOAP.Reply.Transport.JMS の下にある以下の JMS プロパティーを設定できます。 これらのプロパティーは、WS-Addressing を使用して JMS 応答を行う場合にのみ適用されます。 HTTP トランスポートと JMS トランスポートは、WS-Addressing の「To」フィールドを使用して、切り替えることができます。ローカル環境内の WS-Addressing 情報を参照してください。
設定 説明
BindingsLocation 応答メッセージ「JNDI URL バインディング・ロケーション」を指定変更します。 以下に例を示します。
SET OutputLocalEnvironment.Destination.SOAP.Reply.Transport.JMS.JNDI.BindingsLocation = 
'file:/C:/mqsi6/Webservices/SOAP/JMS/JNDI';
ConnectionFactoryName 応答メッセージ「接続ファクトリー名」を指定変更します。 以下に例を示します。
SET OutputLocalEnvironment.Destination.SOAP.Reply.Transport.JMS.JNDI.ConnectionFactoryName = 
'QCF';
ContextParameters 応答メッセージ「JNDI コンテキスト・パラメーター」を指定変更します。 特定の JNDI コンテキスト・パラメーターを指定変更できます。以下に例を示します。
SET OutputLocalEnvironment.Destination.SOAP.Reply.Transport.JMS.JNDI.ContextParameters.foo = 
'bar';
SET OutputLocalEnvironment.Destination.SOAP.Reply.Transport.JMS.JNDI.ContextParameters.foo2 = 
'baz';
CorrelationID 応答メッセージ「CorrelID」を設定します。 以下に例を示します。
SET OutputLocalEnvironment.Destination.SOAP.Reply.Transport.JMS.CorrelationID  = 
'myCorrelID';
Destination 応答メッセージ「宛先」を指定変更します。 以下に例を示します。
SET OutputLocalEnvironment.Destination.SOAP.Reply.Transport.JMS.Destination = 
'REPLYTOQ2';
DeliveryMode 応答メッセージ「DeliveryMode」を指定変更します。 以下に例を示します。
SET OutputLocalEnvironment.Destination.SOAP.Reply.Transport.JMS.DeliveryMode = 
'NON_PERSISTENT';
このプロパティーで指定できる値は、PERSISTENTNON_PERSISTENT です。 UriFormatibm の場合は、DeliveryMode で指定できる値が追加されます (つまり、10 も指定できます)。
Expiration 応答メッセージ「有効期限」を指定変更します。 このプロパティーは、ミリ秒に指定されています。 例えば、100 ミリ秒の有効期限を設定するには、以下のようにします。
SET OutputLocalEnvironment.Destination.SOAP.Reply.Transport.JMS.Expiration = 
'100';
InitialContextFactory 応答メッセージ「初期コンテキスト・ファクトリー」を指定変更します。 以下に例を示します。
SET OutputLocalEnvironment.Destination.SOAP.Reply.Transport.JMS.JNDI.InitialContextFactory = 
'com.sun.jndi.fscontext.RefFSContextFactory';
MessagePriority 応答メッセージ「MessagePriority」を指定変更します。 以下に例を示します。
SET OutputLocalEnvironment.Destination.SOAP.Reply.Transport.JMS.MessagePriority = 
'7';
MessageType 応答メッセージ「MessageType」を指定変更します。 以下に例を示します。
SET OutputLocalEnvironment.Destination.SOAP.Reply.Transport.JMS.MessageType = 
'text';
このプロパティーで指定できる値は、textbytes です。
ProviderName 応答メッセージ「JMS プロバイダー名」を指定変更します。 以下に例を示します。
SET OutputLocalEnvironment.Destination.SOAP.Reply.Transport.JMS.ProviderName = 
'WebSphere MQ';
TransactionMode ノードの「トランザクション・モード」プロパティーを指定変更します。 以下に例を示します。
SET OutputLocalEnvironment.Destination.SOAP.Reply.Transport.JMS.TransactionMode = 'Yes';
このプロパティーで指定できる値は、YesNo、および ForceLocal です。
  • No はトランザクションが行われないことを意味し、None と等価です。
  • Yes は、フローの「整合トランザクション」が選択されていない場合はローカル・トランザクションが行われ、フローの「整合トランザクション」プロパティーが選択されている場合は XA 整合トランザクションが行われることを意味します。
  • ForceLocal は、フローの「整合トランザクション」プロパティーが選択されていても常にローカル・トランザクションが使用されることを意味します。
UriFormat 応答メッセージ「UriFormat」を指定変更します。 以下に例を示します。
SET OutputLocalEnvironment.Destination.SOAP.Reply.Transport.JMS.UriFormat  = 
'w3c';
このプロパティーで指定できる値は、w3cibm です。
UserProperties ノードの「ユーザー・コンテキスト・パラメーター」プロパティーを指定変更します。 特定のユーザー・コンテキスト・パラメーターを指定変更できます。以下に例を示します。
SET OutputLocalEnvironment.Destination.SOAP.Reply.Transport.JMS.JNDI.UserProperties.property1 = 
'value1';
SET OutputLocalEnvironment.Destination.SOAP.Reply.Transport.JMS.JNDI.UserProperties.property2 = 
'value2';
設定 説明
OneWay インバウンド・メッセージが片方向メッセージだったことをノードに知らせます。 応答メッセージは必要ないので、ノードのリソースはクリアされます。 以下に例を示します。
SET OutputLocalEnvironment.Destination.SOAP.Reply.Gateway.OneWay = True
また、インバウンド・メッセージが HTTP トランスポートを使用していた場合、ノードは確認応答の HTTP 202 メッセージを送信します。

詳しくは、Gateway モードにおける片方向メッセージを参照してください。

特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

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

        
        最終更新:
        
        最終更新: 2015-02-28 17:46:03


参照トピック参照トピック | バージョン 8.0.0.5 | ac56182_