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

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

サイトマップ

用語集

検索

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

Tuxedo COBOL リファレンス

TXBEGIN(3cbl)

名前

TXBEGIN()－グローバル・トランザクションの開始

形式

01 TX-RETURN-STATUS.
COPY TXSTATUS.
CALL "TXBEGIN" USING TX-RETURN-STATUS.

機能説明

TXBEGIN() は、呼び出し元の制御スレッドをトランザクション・モードにする際に使用します。呼び出し元のスレッドは、トランザクションを開始する前に、リンクされているリソース・マネージャが (TXOPEN() を介して) オープンされていることを、まず第 1 に確実にしなければなりません。呼び出し元が既にトランザクション・モードにある場合、または TXOPEN() が呼び出されていない場合、TXBEGIN は異常終了します (TX-STATUS に値 [TX-PROTOCOL-ERROR] が設定されます)。

トランザクション・モードに入ると、呼び出し元のスレッドは、現在のトランサクションを完了させるために、TXCOMMIT() または TXROLLBACK() を呼び出さなければなりません。トランザクションの連鎖に関連する条件によっては、トランザクションを開始する際にTXBEGIN() を明示的に呼び出す必要がないこともあります。詳細は TXCOMMIT() および TXROLLBACK() を参照してください。戻り値に使用されるレコードは、TX-RETURN-STATUS です。

選択可能なセットアップ

TXSETTIMEOUT()

戻り値

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

エラー

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

[TX-OUTSIDE]

呼び出し元の制御スレッドが、1 つ以上のリソース・マネージャを利用して、グローバル・トランザクションの外部で現在作業中であるため、トランザクション・マネージャは、グローバル・トランザクションを開始できません。このような作業がすべて完了してからでなければ、グローバル・トランザクションは開始できません。ローカル・トランザクションについての呼び出し元の状態は、変更されません。

[TX-PROTOCOL-ERROR]

TXBEGIN が不正なコンテキストで呼び出されました (たとえば、呼び出し元がすでにトランザクション・モードにある場合)。トランザクション・モードに関する呼び出し元の状態は変更されません。

[TX-ERROR]

トランザクション・マネージャまたは 1 つ以上のリソース・マネージャが、新しいトランザクションの開始において一時的エラーを検出しました。このエラーが返された場合は、呼び出し元はトランザクション・モードにありません。エラーの正確な内容がログ・ファイルに書き込まれます。

[TX-FAIL]

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