BEA ホーム | 製品 | dev2dev | support | askBEA
 ドキュメントのダウンロード   サイト マップ   Glossary 
検索
e-docs > WebLogic Server > WebLogic Tuxedo Connector 管理ガイド > tBridge メッセージ インタフェースのコンフィグレーション

WebLogic Tuxedo Connector 管理ガイド

 Previous Next Contents PDF で侮ｦ  

tBridge メッセージ インタフェースのコンフィグレーション

以下の節では、tBridge の機能とコンフィグレーションについて説明します。

 

tBridge の概要


 

tBridge は WebLogic Tuxedo Connector の一部で、Tuxedo アプリケーション環境と通信する WebLogic Server アプリケーションの双方向 JMS インタフェースを提供します。環境間でのメッセージングの転送は、クライアント アプリケーションの代わりにサービスを呼び出すのに使用するテキスト、Byte、または XML データ ストリームを含む JMS ベースのメッセージで構成されます。

tBridge の機能は以下のように決定されます。

tBridge による JMS から Tuxedo への接続

注意: すべてのメッセージは、確認応答されるまで JMS キューに保持されます。

この節では、JMS のメッセージが tBridge を介して Tuxedo キューおよびサービスに渡されるまでの流れを説明します。

  1. Web が有効化された WLPI アプリケーションなどの JMS クライアントにより、Tuxedo で処理されるメッセージが JMS キューに配置されます。このメッセージがトランザクションの一部だった場合、トランザクションがコミットされます。

  2. メッセージが JMS キューから移動し、tBridge コンバータで処理されます。

  3. tBridge コンバータによりメッセージ タイプがチェックされ、サポートされている JMS メッセージ タイプが JATMI のバッファ タイプに変換されます。

  4. 変換されたメッセージが、T/Domain ゲートウェイを使用して Tuxedo に送られます。

  5. tpenqueue または tpcall が成功した場合、戻り値が ReplyQ に置かれます。メッセージが JMS セッションで確認応答されます。

tBridge による Tuxedo から JMS への接続

注意: tBridge はトランザクションを使用して、Tuxedo /Q から JMS キューへの転送中にメッセージが失われないようにします。

この節では、TuxQ2JmsQ リダイレクトを利用して、Tuxedo のメッセージが tBridge を介して JMS キューに渡されるまでの流れを説明します。

  1. tBridge により、Tuxedo キューの使用可能なメッセージがポーリングされます。

  2. Tuxedo サービスにより、メッセージが Tuxedo キューに配置されます。

  3. tBridge では、JATMI の tpdequeue を使用して、Tuxedo からメッセージを転送し、JMS キューに配置します。

tBridge の制限

tBridge には次のような制限があります。

 

tBridge 用 WTCServer MBean コンフィグレーション

WebLogic Tuxedo Connector の tBridge 接続性は、Tuxedo への接続を確立するために必要な情報を含む WTCtBridgeGlobal MBean および WTCtBridgeRedirect MBean のコンフィグレーションによって決定されます。

tBridge の起動

tBridge は、WTCServer MBean の WTCtBridgeGlobal MBean および WTCtBridgeRedirect MBean がコンフィグレーションされていて、かつ、WTCServer MBean が対象サーバにデプロイされている場合は、WebLogic Server アプリケーション環境の一部として起動されます。tBridge が起動できないようなコンフィグレーション条件が発生した場合は、エラーがログされます。

エラーのロギング

WebLogic Tuxedo Connector エラーは、WebLogic Server エラー ログにログされます。

 

tBridge の接続性

注意: MapMessage、ObjectMessage、StreamMessage の JMS メッセージ タイプは、WebLogic Tuxedo Connector では無効です。これらのメッセージ タイプの 1 つが tBridge によって受信された場合は、サポートされていないタイプであることを示すログ エントリが作成され、メッセージが破棄されます。

tBridge は、JMS キューと Tuxedo /Q または JMS キューと Tuxedo サービスのインスタンス間で、一方向のデータ接続を確立します。この接続は、WTCtBridgeRedirect MBean で指定され、識別されたポイント間に 1 対 1 の接続を提供します。3 つのタイプの接続がコンフィグレーションできます。次に、各接続タイプについて説明します。

 

接続タイプのコンフィグレーションの例

以下の節では、各接続タイプのコンフィグレーションの例を紹介します。

JmsQ2TuxQ コンフィグレーションの例

JMS キューから読み取りを行い、Tuxedo /Q に送信するコードの例を以下に示します。

<WTCtBridgeRedirect
     Direction="JmsQ2TuxQ"
     Name="redir0"
     ReplyQ="RPLYQ"
     SourceName="weblogic.jms.Jms2TuxQueue"
     TargetAccessPoint="TDOM2"
     TargetName="STRING"
     TargetQspace="QSPACE"
     TranslateFML="NO"/>

次に、JmsQ2TuxQ コンフィグレーションの各コンポーネントを説明します。

以下の表に、JmsQtoTuxQ メッセージ マッピングの情報を示します。

マッピング元 : JMS メッセージ タイプ

マッピング先 : WebLogic Tuxedo Connector JATMI (Tuxedo)

BytesMessage

TypedCArray

TextMessage (translateFML = NONE)

TypedString

TextMessage (translateFML = FLAT)

TypedFML32

 

TuxQ2JmsQ コンフィグレーションの例

以下に、Tuxedo /Q キューから読み取りを行い、JMS キューに送信するコードの例を示します。

<WTCtBridgeRedirect
     Direction="TuxQ2JmsQ"
     Name="redir1"
     SourceAccessPoint="TDOM2"
     SourceName="STRING"
     SourceQspace="QSPACE"
     TargetName="weblogic.jms.Tux2JmsQueue"
     TranslateFML="NO"/>

次に、TuxQ2JmsQ コンフィグレーションの各コンポーネントを説明します。

以下の表に、TuxQ2JmsQ メッセージ マッピングの情報を示します。

マッピング元 : WebLogic Tuxedo Connector JATMI (Tuxedo)

マッピング先 : JMS メッセージ タイプ

TypedCArray

BytesMessage

TypedString (translateFML = NO)

TextMessage

TypedFML32 (translateFML = FLAT)

TextMessage

TypedFML (translateFML = FLAT)

TextMessage

TypedXML

TextMessage

 

JmsQ2TuxS コンフィグレーションの例

注意: XML/FML 変換の詳細については、WebLogic Tuxedo Connector での FML の使用を参照してください。

次に、JMS キューから読み取りを行い、Tuxedo サービスを呼び出して、結果を JMS キューに返すコードの例を示します。

<WTCtBridgeRedirect
     Direction="JmsQ2TuxS"
     Name="redir0"
     ReplyQ="weblogic.jms.Tux2JmsQueue"
     SourceName="weblogic.jms.Jms2TuxQueue"
     TargetAccessPoint="TDOM2"
     TargetName="TOUPPER"
     TranslateFML="FLAT"/>

次に、JmsQ2TuxS コンフィグレーションの各コンポーネントを説明します。

以下の表に、JMSQ2TuxX メッセージ マッピングの情報を示します。

JMS メッセージ タイプ

WebLogic Tuxedo Connector JATMI (Tuxedo)

JMS メッセージ タイプ

BytesMessage

TypedCArray

BytesMessage

TextMessage (translateFML = NONE)

TypedString

TextMessage

TextMessage (translateFML = FLAT)

TypedFML32

TextMessage

 

 

優先度のマッピング

WebLogic Tuxedo Connector では、複数の tBridge リダイレクト インスタンスがサポートされています。リダイレクト インスタンスを複数使用すると、多くの環境下でアプリケーションのスケーラビリティおよびパフォーマンスが著しく向上します。ただし、その場合メッセージが処理される順序がランダムになります。優先度のマッピングをしても順序は保証されませんが、割り当てられた重要度に従ってメッセージに対応するメカニズムが提供されます。配信の順序を確実にしたい場合は、tBridge リダイレクト インスタンスを 1 つだけ使用してください。

JMS および Tuxedo 間で優先度をマップするには、priorityMapping を使用します。

この節では、Tuxedo および JMS サブシステム間で優先度をマップするメカニズムについて説明します。2 つのマッピング方向があります。

次の value:range の組み合わせで示すように、すべての値にデフォルトが提供されています。

JmstoTux- 0:1 | 1:12 | 2:23 | 3:34 | 4:45 | 5:56 | 6:67 | 7:78 | 8:89 | 9:100

TuxtoJms- 1-10:0 | 11-20:1 | 21-30:2 | 31-40:3 | 41-50:4| 51-60:5 | 61-70:6 | 71-80:7 | 81-90:8 | 91-100:9

このコンフィグレーションでは、優先度 7 の JMS メッセージが Tuxedo /Q の優先度 78 に割り当てられます。優先度 47 の Tuxedo /Q は、優先度 4 の JMS に割り当てられます。

 

エラー キュー

tBridge が Tuxedo キューまたは JMS キューからメッセージを受信したときに問題を検出した場合、再試行間隔の後に次の処理が行われます。

wlsServerErrorDestination

wlsErrorDestination キューは、JMS メッセージが Tuxedo エラーまたは変換エラーにより適切に送信できない場合に使用されます。

サポートされていないメッセージ タイプ

認識できない JMS メッセージを受信した場合、適切なエラー メッセージがログされ、そのメッセージは破棄されます。これはコンフィグレーション エラーと解釈され、tBridge はメッセージをエラー キューにリダイレクトしません。

tuxErrorQueue

tuxErrorQueue は、TuxQ2JmsQ のリダイレクト中の JATMI プリミティブ tpdequeue のエラー キューです。

制限

tBridge エラー キューには、次のような制限があります。

 

Back to Top Previous Next