TXBEGIN(3cbl)


	BEA ホーム \| イベント \| ソリューション \| パートナ \| 製品 \| サービス \| ダウンロード \| ディベロッパ・センタ \| WebSUPPORT
	e-docs \| サイトマップ \| 検索 \| PDF版 \| お問い合わせ \| 用語集

Tuxedo ホーム \| BEA 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]

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

[TX-FAIL]

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