XA_COMMIT

XA_COMMIT 関数は、xid で指定されたグローバルトランザクションをコミットするために使用します。

構文

DBMS_XA.XA_COMMIT (
    xid       IN  DBMS_XA_XID,
    onePhase  IN  BOOLEAN)
RETURN PLS_INTEGER;

パラメータ説明

戻り値

DBMS_XAが返す可能性のある定数戻り値を参照してください。

返される可能性のあるエラーコードは、XAER_RMERR、XAER_RMFAIL、XAER_NOTA、XAER_INVAL、およびXAERPROTOです。その他の可能な戻り値には、XA_OK、XA_RB *、XA_HEURHAZ、XA_HEURCOM、XA_HEURRB、およびXA_HEURMIXが含まれます。

使用方法

• アプリケーションは COMMIT を呼び出すことはできず、xid で指定されたグローバルトランザクションをコミットするためには、XA_COMMIT を呼び出す必要があります。

• onePhase の値が TRUE の場合、リソースマネージャーは一相コミットプロトコルを使用して、xid に代わって完了した作業をコミットします。そうでない場合、XA_COMMIT を呼び出すには、グローバルトランザクションのすべてのブランチが正常に完了し、かつ先行する XA_PREPARE 呼び出しが XA_OK を返した場合に限ります。

• アプリケーションは、XA_PREPARE が XA_OK を返したグローバルトランザクションの各トランザクションブランチごとに、個別のXA_COMMIT 呼び出しを実行する必要があります。

• リソースマネージャーがトランザクションをコミットせず、パラメータ onePhase が TRUE に設定されている場合、リソースマネージャーは XA_RB * コードのいずれかを返すことができます。返却後、リソースマネージャーはブランチの作業をロールバックし、予約されたすべてのリソースを解放します。