XA_END

XA_END 関数は、現在のセッションと xid で指定されたトランザクション分岐の関連付けを解除するために使用されます。

制御スレッドがトランザクション分岐上のトランザクションを完了または一時停止する必要がある場合、トランザクションマネージャーは XA_END を呼び出します。アプリケーションがその作業の一部または全部を完了した場合（例えば、他の制御スレッドが分岐上で作業できるように特定のイベントをブロックする操作の前に）、XA_END が呼び出されます。XA_END が正常に戻り値を返すと、呼び出し元のスレッドは分岐と有効に関連付けられなくなりますが、分岐自体は存続します。

構文

DBMS_XA.XA_END (
   xid   IN  DBMS_XA_XID,
   flag  IN  PLS_INTEGER)
RETURN PLS_INTEGER;

パラメータの説明

戻り値

DBMS_XA の可能な定数戻り値を参照してください。

返される可能性のあるエラーコードは、XAER_RMERR, XAER_RMFAILED, XAER_NOTA, XAER_INVAL, XAERPROTO および XA_RB\* です。

使用方法

• flag に TMSUCCESS または TMSUSPEND を指定できます。戻り値が XA_OK の場合、トランザクション分岐は現在分離状態にあるセッションから解除されます。TMFAIL はサポートされていません。TMSUCCESS または TMSUSPEND を使用して XA_END を呼び出し、xid で識別されたトランザクション分岐を現在のセッションから解除できます。

• XA_END が正常に実行された場合、XA_OK が返されます。アプリケーションは戻り値をチェックし、エラー状況を処理する必要があります。XA_OK が返された場合にのみ、アプリケーションは他の通常の操作を続行すべきです。

• XA_END を呼び出す前に ROLLBACK ステートメントを実行すると、現在のトランザクションによって行われた変更がロールバックされます。ただし、XA_END を呼び出す前は、トランザクションコンテキストは依然として現在のセッションに関連付けられています。

• XA_END を呼び出す前に COMMIT ステートメントを実行すると、OBE-02089：従属セッションでは COMMIT が許可されません エラーが発生します。

• XA_END の後に COMMIT または ROLLBACK ステートメントを実行しても、xid で識別されたトランザクションには影響しません。なぜなら、そのトランザクションは既に現在のセッションと関連付けられていないからです。トランザクション ID をコミットするか、XA_ROLLBACK 関数を使用して xid で指定されたトランザクションをコミット/ロールバックします。