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

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

サイトマップ

用語集

検索

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

Tuxedo COBOL リファレンス

TXCLOSE(3cbl)

名前

TXCLOSE()－リソース・マネージャ・セットのクローズ

形式

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

機能説明

TXCLOSE() は、移植生の高い方法でリソース・マネージャ・セットをクローズします。これにより、トランザクション・マネージャが呼び出されて、リソース・マネージャ固有の情報がトランザクション・マネージャ固有の方法で読み取られ、この情報が呼び出し元にリンクされたリソース・マネージャに渡されます。

TXCLOSE() は、呼び出し元にリンクされているリソース・マネージャをすべてクローズします。この関数は、リソース・マネージャ固有の「クローズ」呼び出しの代わりに使用されるので、アプリケーション・プログラムは、移植性を損なう危険性のある呼び出しを使用することがなくなります。リソース・マネージャは終了の内容がそれぞれで異なるため、個々のリソース・マネージャを「クローズ」するために必要な情報をリソース・マネージャごとに通知しなければなりません。

TXCLOSE() は、アプリケーションの制御スレッドがグローバル・トランザクションに関与する必要がなくなったときに呼び出してください。呼び出し元がトランザクション・モードにあると、TXCLOSE() は異常終了します ([TX-PROTOCOL-ERROR] が返されます)。したがって、現在のトランザクションに関与しない制御スレッドがあっても、リソース・マネージャは一切クローズされません。

TXCLOSE() が正常終了すると (TX-OK)、呼び出し元のスレッドにリンクしているリソース・マネージャはすべてクローズされます。

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

戻り値

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

エラー

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

[TX-PROTOCOL-ERROR]

この関数が不正なコンテキストで呼び出されました (たとえば、呼び出し元がトランザクション・モードにある場合)。リソース・マネージャは一切クローズされません。

[TX-ERROR]

トランザクション・マネージャまたは 1 つ以上のリソース・マネージャが、一時的エラーを検出しました。エラーの正確な内容がログ・ファイルに書き込まれます。クローズ可能なリソース・マネージャはすべてクローズされます。

[TX-FAIL]

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