コンフィギュレーション

BEA Tuxedo /Q コンポーネントには、3 つのサーバが提供されています。1 つは、TMS_QM という BEA Tuxedo /Q リソース・マネージャ用のトランザクション・マネージャ・サーバ (TMS) です。このサーバは、キュー機能でグローバル・トランザクションを管理します。このサーバは、コンフィギュレーション・ファイルの GROUPS セクションで定義されていることが必要です。

TMQFORWARD の機能がアプリケーションのニーズを完全には満たさない場合、アプリケーション独自のキュー・サーバを作成することもできます。たとえば、エラー・キューに移動したメッセージをキューから取り出す特別なサーバが必要な場合があります。

アプリケーションでは、ピア・ツー・ピア通信を選択することもできます。この通信では、転送サーバを使用せずに、アプリケーションはほかのアプリケーションと、クライアントはほかのクライアントと通信します。

QM サーバ・グループの指定

TMSNAME=TMS_QM

および

OPENINFO="TUXEDO/QM:<device_name:<queue_space_name>"

注記 これらの値は、時系列順に指定されている必要はありません。コンフィギュレーション・ファイルは、キュー・スペースを定義する前でも定義した後でも作成できます。コンフィギュレーションが定義され、以前に作成されたキュー・スペースとキューが使用できることが重要です。

GROUPS セクションのエントリごとに、キュー・スペースを 1 つだけ使用できます。CLOSEINFO パラメータは使用されません。

*GROUPS
TMQUEUEGRP1 GRPNO=1 TMSNAME=TMS_QM
        OPENINFO="TUXEDO/QM:/dev/device1:myqueuespace"
TMQUEUEGRP2 GRPNO=2 TMSNAME=TMS_QM
        OPENINFO="TUXEDO/QM:/dev/device2:myqueuespace"

メッセージ・キュー・サーバの指定

操作のタイムアウト

キュー・スペース名、キュー名、およびサービス名

キュー・スペース名、キュー名、およびサービス名は、混同しやすいので注意してください。まず、メッセージ・キュー・サーバ TMQUEUE の指定では注意が必要です。このサーバをコンフィギュレーション・ファイルで指定する場合は、CLOPT パラメータの -s フラグを使用して、サーバのあるインスタンスからサービスを受け取るキュー・スペースの名前を指定できます。これは、関数 TMQUEUE で宣言されたサービスと同じです。キュー・スペースを 1 つだけ使用するアプリケーションでは、CLOPT -s オプションを指定する必要はありません。デフォルトの -s TMQUEUE:TMQUEUE が使用されます。アプリケーションに複数のキュー・スペースが必要な場合、キュー・サーバの SERVERS セクションの -s オプションの引数として、キュー・スペースの名前を指定します。

# 次の 2 つの指定は同じです。
 
*SERVERS
TMQUEUE SRVGRP="TMQUEUEGRP1" SRVID=1000 RESTART=Y GRACE=0 \
        CLOPT="-s myqueuespace:TMQUEUE"
and
 
buildserver -o TMQUEUE -s myqueuespace:TMQUEUE -r TUXEDO/QM \
        -f ${TUXDIR}/lib/TMQUEUE.o
followed by
 ..
 ..
 ..
TMQUEUE SRVGRP="TMQUEUEGRP1" SRVID=1000 RESTART=Y GRACE=0 \
        CLOPT="-A"

データ依存型ルーティング

*GROUPS
TMQUEUEGRP1 GRPNO=1 TMSNAME=TMS_QM
        OPENINFO="TUXEDO/QM:/dev/device1:myqueuespace"
TMQUEUEGRP2 GRPNO=2 TMSNAME=TMS_QM
        OPENINFO="TUXEDO/QM:/dev/device2:myqueuespace"
*SERVERS
TMQUEUE SRVGRP="TMQUEUEGRP1" SRVID=1000 RESTART=Y GRACE=0 \
        CLOPT="-s ACCOUNTING:TMQUEUE"
TMQUEUE SRVGRP="TMQUEUEGRP2" SRVID=1000 RESTART=Y GRACE=0 \
        CLOPT="-s ACCOUNTING:TMQUEUE"
*SERVICES
ACCOUNTING  ROUTING="MYROUTING"
*ROUTING
MYROUTING  FIELD=ACCOUNT BUFTYPE="FML" \
        RANGES="MIN-60000:TMQUEUEGRP1,60001-MAX:TMQUEUEGRP2"

バッファ・タイプのカスタマイズ

追加したサーバ名は、CLOPT パラメータ (前述を参照) に指定せずに、buildserver コマンドの -s オプションを使用して TMQUEUE に対応付けることができます。

バッファ・サブタイプ

メッセージ転送サーバの指定

TMQFORWARD は 1 つのサーバであり、アプリケーションで使用される各インスタンスは、コンフィギュレーション・ファイルの SERVERS セクションで定義されていなければなりません。ただし、TMQFORWARD には、通常のサーバとは異なる次のような特徴があります。

TMQFORWARD のインスタンスは、キューに対応するサーバ・グループを使用して、そのキュー・スペースに結び付けられます。特に、そのグループの OPENINFO 文の第 3 フィールドを使用して、キュー・スペースと結び付けられます。以下に、これ以外の主なパラメータ、特に 2 つのダッシュに続く CLOPT パラメータについて説明します。

キュー名およびサービス名 ( -q オプション)

トランザクション・タイムアウトの指定 (-t オプション)

TMQFORWARD は、TMQFORWARD が開始して終了するトランザクション内で機能します。-t trantime オプションは、トランザクションがタイムアウトになるまでの時間 (秒単位) を指定します。TMQFORWARD がキュー上にメッセージがあることを確認すると、トランザクションが開始されます。応答が応答キューまたは異常終了キューのいずれかに登録されると、そのトランザクションがコミットされます。そのため、トランザクションには、メッセージを処理するサービスの呼び出しと応答の受信が含まれています。デフォルト値は 60 秒です。

アイドル時間の指定 (-i オプション)

TMQFORWARD は一度呼び出されると、割り当てられているキューを定期的に確認します。キューが空であった場合は、-i idletime 秒間停止してから再度確認を行います。値が指定されていない場合 デフォルト値の 30 秒が使用されます。この値を 0 に設定すると、キューが継続的に確認されます。これは、キューが空の場合が多いときは、CPU リソースを浪費することになります。

サーバ終了の指定 (-e オプション)

サービスの異常終了後のメッセージの削除 (-d オプション)

サービス要求が TMQFORWARD から呼び出された後で異常終了した場合、トランザクションはロールバックされ、後で再試行できるようにメッセージは (キューに指定された再試行の制限回数まで) キューに戻されます。-d オプションを使用すると、次の処理も行われます。つまり、異常終了したサービスで NULL 以外の応答が返された場合、異常終了キューがメッセージに対応付けられ、キューが存在するときは、応答 (および、それに対応付けられた tpurcode) が異常終了キューに登録されて元の要求メッセージは削除されます。また、-d オプションを使用すると、キューに設定されてた再試行回数の制限値に達すると同時に元の要求メッセージが削除され、元の要求メッセージはエラー・キューに登録されます。

このオプションで重要なことは、ただむやみに再試行するのではなく、発信元のライアントが異常終了メッセージを調べ、再試行が必要であるかどうかを判断するようにコーディングできることです。これにより、本質的な問題、たとえば、アカウントが存在していないめに、レコードが「見つからない」場合などが原因で失敗した場合に、それを処理する方法が提供されます。

バッファ・タイプのカスタマイズ

動的なコンフィギュレーション