セクション 3(cbl) - COBOL 関数

Tuxedo

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

サイトマップ

検索

e-docs > Tuxedo > Tuxedo COBOL リファレンス > セクション 3(cbl) - COBOL 関数

Tuxedo COBOL リファレンス

Previous

Next

Contents

View as PDF

TXROLLBACK(3cbl)

名前

TXROLLBACK()－トランザクションのロールバック

形式

DATA DIVISION.
 * Include TX definitions. 
01 TX-RETURN-STATUS.
 COPY TXSTATUS.
PROCEDURE DIVISION.
CALL "TXROLLBACK" USING TX-RETURN-STATUS.

機能説明

TXROLLBACK() は、呼び出し元の制御スレッドでアクティブなトランザクションの作業をロールバックします。

transaction_control 特性 (TXSETTRANCTL() を参照) が TX-UNCHAINED の場合、TXROLLBACK() が終了すると、呼び出し元はトランザクション・モードでなくなります。一方、transaction_control 特性が TX-CHAINED の場合は、TXROLLBACK() が終了したとき、呼び出し元は新しいトランザクションのためにトランザクション・モードのままになります (以下の「戻り値」と「エラー」の項を参照してください)。

戻り値に使用されるレコードは、TX-RETURN-STATUS です。

選択可能なセットアップ

TXSETTRANCTL()
TXSETTIMEOUT()

戻り値

TXROLLBACK() は正常終了時には、負数でない値 TX-OK を返します。

エラー

次の条件が発生すると、TXROLLBACK() は異常終了し、次のいずれかの負の値を返します。

[TX-NO-BEGIN]

現在のトランザクションはロールバックしました。ただし、新しいトランザクションを開始できなかったので、呼び出し元はトランザクション・モードではなくなりました。この戻り値は、transaction_control 特性が TX-CHAINED である場合のみ発生します。

トランザクションのために行われた作業は、部分的にコミットされ、部分的にロールバックされました。また、transaction_control 特性が TX-CHAINED である場合には、新しいトランザクションが開始されます。

[TX-MIXED-NO-BEGIN]

トランザクションのために行われた作業は、部分的にコミットされ、部分的にロールバックされました。また、新しいトランザクションを開始できなかったので、呼び出し元はトランザクション・モードではなくなりました。この戻り値は、transaction_control 特性が TX-CHAINED である場合のみ発生します。

[TX-HAZARD]

障害が原因で、トランザクションのために行われた作業は、部分的にコミットされ、部分的にロールバックされた可能性があります。また、transaction_control 特性が TX-CHAINED である場合には、新しいトランザクションが開始されます。

[TX-HAZARD-NO-BEGIN]

障害が原因で、トランザクションのために行われた作業は、部分的にコミットされ、部分的にロールバックされた可能性があります。また、新しいトランザクションを開始できなかったので、呼び出し元はトランザクション・モードではなくなりました。この戻り値は、transaction_control 特性が TX-CHAINED である場合のみ発生します。

[TX-COMMITTED]

トランザクションのために行われた作業は、ヒューリスティックにコミットされました。また、transaction_control 特性が TX-CHAINED である場合には、新しいトランザクションが開始されます。

[TX-COMMITTED-NO-BEGIN]

トランザクションのために行われた作業は、ヒューリスティックにコミットされました。また、新しいトランザクションを開始できなかったので、呼び出し元はトランザクション・モードではなくなりました。この戻り値は、transaction_control 特性が TX-CHAINED である場合のみ発生します。

[TX-PROTOCOL-ERROR]

この関数が不正なコンテキストで呼び出されました (たとえば、呼び出し元がトランザクション・モードにない場合)。

トランザクション・マネージャまたは 1 つ以上のリソース・マネージャが、致命的エラーを検出しました。このエラーでは、トランザクション・マネージャまたは 1 つ以上のリソース・マネージャ、あるいはその両方は、アプリケーションのために作業を行うことができなくなります。エラーの正確な内容がログ・ファイルに書き込まれます。トランザクションについての呼び出し元の状態は、不明です。

関連項目

TXBEGIN(3cbl)、TXSETTIMEOUT(3cbl)、TXSETTRANCTL(3cbl)

Back to Top

Previous

Next