Roll Back

現行接続と関連付けられているアクティブなトランザクションをロールバックします。

入力

Database connection
データベース接続を表す CwDBConnection オブジェクト。

例外

Roll Back 機能ブロックは、CwDBTransactionException 例外をスローできます。

Roll Back 機能ブロックは、現行接続に関連づけられているデータベースに加えられた変更すべてをロールバックすることにより、アクティブ・トランザクションを終了させます。Begin Transaction、Commit、および Roll Back 機能ブロックは、明示的なトランザクションのトランザクション境界を共同で管理します。このトランザクションには、SQL 照会 (SQL ステートメント INSERT、DELETE、または UPDATE を含む) と、これらの SQL ステートメントの 1 つを含むストアード・プロシージャーとが含まれます。ロールバックが失敗すると、Roll Back は CwDBTransactionException 例外をスローして、エラーをログに記録します。
要確認

接続において明示的なトランザクション・ブラケットを使用している場合は、Roll Back のみを使用してください。接続で暗黙的なトランザクション・ブラケットを使用しているときに Roll Back を使用すると、CwDBTransactionException 例外が発生します。

接続が解放される前に Roll Back (または Commit 機能ブロック) を使用して明示的なトランザクションを終了しない場合は、InterChange Server Express がコラボレーションの成功に基づいてトランザクションを暗示的に終了させます。コラボレーションが成功の場合、InterChange Server Express は、このデータベース・トランザクションをコミットします。コラボレーションが成功では ない 場合、InterChange Server Express は、このデータベース・トランザクションを暗黙的にロールバックします。コラボレーションが成功かどうかにかかわらず、InterChange Server Express は警告を記録します。

関連情報

この機能ブロックは、CwDBConnection.rollBack() メソッドを基にしています。詳細については、rollBack()を参照してください。

Copyright IBM Corp. 2004