dc_trn_unchained_rollback
形式
ANSI C ,C++の形式
#include <dctrn.h> int dc_trn_unchained_rollback(void)
K&R版 C の形式
#include <dctrn.h> int dc_trn_unchained_rollback()
機能
トランザクションをロールバックします。非連鎖モードでロールバックしたあとには,トランザクションは続けて開始しません。
dc_trn_unchained_rollback関数を呼び出すことで,トランザクションブランチ,トランザクションサービス,およびリソースマネジャにロールバックを知らせます。
dc_trn_unchained_rollback関数は,グローバルトランザクションのどのトランザクションブランチからでも呼び出せます。ルートトランザクションブランチから呼び出した場合,dc_trn_unchained_rollback関数が正常に終了したあとには,新しいトランザクションは開始しません。ルートトランザクションブランチ以外から呼び出した場合は,そのトランザクションブランチをrollback_only状態にします。この場合,ルートトランザクションブランチの同期点処理が完了するまで,dc_trn_unchained_rollback関数を呼び出したトランザクションブランチはトランザクションの範囲内です。
dc_trn_unchained_rollback関数を呼び出すプロセスは,このマニュアルの記述に従って正しく作成されたUAPを稼働させたものでなければなりません。dc_trn_unchained_rollback関数を呼び出すサービスが正常に終了するためには,UAPの実行環境を設定するときに,トランザクション属性を指定していることが前提です。
リターン値
リターン値 |
リターン値(数値) |
意味 |
---|---|---|
DC_OK |
0 |
正常に終了しました。dc_trn_unchained_rollback関数をルートトランザクションブランチから呼び出している場合は,このプロセスはトランザクション下にありません。プロセスはグローバルトランザクションの範囲の外です。ルートトランザクションブランチ以外から呼び出している場合は,このプロセスをrollback_only状態とします。 |
DCTRNER_HEURISTIC |
-903 |
dc_trn_unchained_rollback関数を呼び出したグローバルトランザクションは,ヒューリスティック決定のため,あるトランザクションブランチはコミットとなり,あるトランザクションブランチはロールバックとなりました。 このリターン値は,ヒューリスティック決定の結果が,グローバルトランザクションの同期点の結果と一致しなかった場合にリターンします。 このリターン値が返る原因になったUAP,リソースマネジャ,およびグローバルトランザクションの同期点の結果は,メッセージログファイルを参照してください。 このリターン値が返ったあと,このプロセスはトランザクション下になく,グローバルトランザクションの範囲の外です。 |
DCTRNER_HAZARD |
-904 |
グローバルトランザクションのトランザクションブランチがヒューリスティックに完了しました。しかし,障害のため,ヒューリスティックに完了したトランザクションブランチの同期点の結果がわかりません。 このリターン値が返る原因になったUAP,リソースマネジャ,およびグローバルトランザクションの同期点の結果は,メッセージログファイルを参照してください。 このリターン値が返ったあと,このプロセスはトランザクション下になく,グローバルトランザクションの範囲の外です。 |
DCTRNER_PROTO |
-905 |
dc_trn_unchained_rollback関数を,正しくないコンテクスト(例えば,すでにトランザクション中にいない)で呼び出しています。トランザクションモードに対する影響はありません。 |
指定例
if (dc_trn_info(NULL) && dc_trn_unchained_rollback() < 0) fputs("cannot rollback transaction\n",stderr);