セクション 5 ―ファイル形式、データ記述方法、MIB、およびシステム・プロセスのリファレンス

ドキュメントのダウンロード

サイトマップ

用語集

検索

e-docs > Tuxedo > Tuxedo のファイル形式とデータ記述方法 > セクション 5 ―ファイル形式、データ記述方法、MIB、およびシステム・プロセスのリファレンス

Tuxedo のファイル形式とデータ記述方法

T_APPQTRANS クラスの定義

概要

T_APPQTRANS クラスは、アプリケーション・キューに関連付けられるトランザクションの実行時属性を表します。

制限事項

すべてのキー・フィールドを未設定にすると、このクラスのインスタンスをすべて検索できません。反対に、1 つのアプリケーション・キュー・スペースを明示的に指定するには、適切なキー・フィールドを指定する必要があります。たとえば、tpcall() を使用して、TA_XID を除くすべてのキー・フィールドを要求で設定した場合、指定されたキュー・スペースに対応する T_APPQTRANS オブジェクトがすべて検索されます。

このクラスのオブジェクトで表現されるトランザクションは必ずしも検索対象のアプリケーションに関連付けられないので注意してください。トランザクションは実際には別のアプリケーションに属していたり、別のアプリケーションに影響を与えたりする場合があるため、トランザクションをヒューリスティックにコミットまたはアボートするときには注意が必要です。TA_XID 属性の値は、アプリケーション間で一意であるとは限りません。

属性表

表 10 APPQ_MIB(5):T_APPQTRANS クラス定義の属性表

属性 ^a	タイプ	パーミッション	値	デフォルト値
TA_XID( k )( * )	string	R--R--R--	string[1..78]	N/A
TA_APPQSPACENAME(k)(*)	string	r--r--r--	string[1..15]	N/A
TA_QMCONFIG( k )( * )	string	r--r--r--	string[1..78]	N/A
TA_LMID( k )( * )	string	r--r--r--	string[1..30]	N/A
TA_STATE^b	string	R-XR-XR--	GET: "{ACT \| ABY \| ABD \| COM \| REA \| DEC \| HAB \| HCO}" SET: "{HAB \| HCO}"	N/A N/A
( k )-GET キー・フィールド^c( * )-必須の SET キー・フィールド

a. T_APPQTRANS クラスの属性はすべてローカルです。
b. T_APPQTRANS オブジェクトのすべての操作 (GET と SET) は、関連付けられているキュー・スペースを自動的にオープンします。つまり、キュー・スペースの状態が OPEn または ACTive になっていない場合、暗黙的に OPEn に設定します。キュー・スペースが大きいと、この操作は時間がかかります。
c. 1 つのアプリケーション・キュー・スペースを明示的に指定するには、GET 操作で適切なキー・フィールドを指定する必要があります。

属性の意味

TA_XID: string[1..78]

tx_info() から返され、文字列表現にマップされるトランザクション識別子。等号比較の場合を除き、ユーザはこのフィールドのデータを直接解釈することはできません。

TA_APPQSPACENAME: string[1..15]

トランザクションに関連付けるアプリケーション・キュー・スペースの名前。

TA_QMCONFIG: string[1..78]

アプリケーション・キュー・スペースが存在するファイルまたはデバイスの絶対パス名。

TA_LMID: string[1..30] (no comma)

アプリケーション・キュー・スペースが存在する論理マシンの識別子。

TA_STATE:

GET: {ACTive | ABortonlY | ABorteD | COMcalled | REAdy | DECided |
HAbord | HCommit}

GET 操作は、選択したトランザクションに関する実行時情報を検索します。以下に、GET 要求に対する応答で返される TA_STATE の意味を示します。すべての状態は ACTive と同等で、パーミッションのチェックに使用します。

ACTive	トランザクションはアクティブです。
ABortonlY	トランザクションはロールバックされるものと識別されています。
ABorteD	トランザクションはロールバックされるものと識別され、ロールバックが開始されました。
COMcalled	トランザクションのイニシエータが tpcommit() を呼び出し、2 フェーズ・コミットの第 1 フェーズが開始されました。
REAdy	検索サイトの参加グループすべてが 2 フェーズ・コミットの第 1 フェーズを正常に完了し、コミット可能な状態です。
DECided	2 フェーズ・コミットの第 2 フェーズが開始されました。
SUSpended	トランザクションのイニシエータがトランザクション処理を中断しました。

SET: {HABort | HCOmmit}

SET 操作は、選択したトランザクションの状態を更新します。以下に、SET 要求によって返される TA_STATE の意味を示します。これ以外の状態を設定することはできません。

HABort	トランザクションをヒューリスティックにアボートします。正常終了すると、オブジェクトの状態は HABort になります。
HCOmmit	トランザクションをヒューリスティックにコミットします。正常終了すると、オブジェクトの状態は HCOmmit になります。