bea ホーム | 製品 | dev2dev | support | askBEA
BEA Logo Tuxedo
 ドキュメントのダウンロード   サイトマップ   用語集 
検索
0

Tuxedo COBOL リファレンス

 Previous Next Contents View as PDF  

TPOPEN(3cbl)

名前

TPOPEN()−BEA Tuxedo ATMI のリソース・マネージャのオープン

形式

01 TPSTATUS-REC.
COPY TPSTATUS.

CALL "TPOPEN" USING
TPSTATUS-REC.

機能説明

TPOPEN() は、呼び出し元がリンクされるリソース・マネージャをオープンします。呼び出し元には、多くとも 1 つのリソース・マネージャしかリンクできません。このルーチンはリソース・マネージャ固有の open() 呼び出しの代わりに使用するもので、これによりサービス・ルーチンから、移植性を損なう可能性のある呼び出しをなくすことができます。リソース・マネージャは初期化の内容がそれぞれで異なるため、個々のリソース・マネージャをオープンするために必要な情報をコンフィギュレーション・ファイルに記述します。

リソース・マネージャがすでにオープンされている場合 (すなわち、TPOPEN() を 2 回以上呼び出した場合)、何も処理は行われず、正常終了を示すコードが返されます。

戻り値

TPOPEN() は正常終了時には、TP-STATUS に [TPOK] を設定します。リソース・マネージャがオープンできなかった理由に関する詳しい情報は、そのリソース・マネージャに独自の方法で照会することで得ることができます。ただし、リソース・マネージャのエラーの正確な内容を判別するための呼び出しを使用すると、移植性が損なわれます。

エラー

次の条件が発生すると、TPOPEN() は異常終了し、TP-STATUS に次の値を設定します。

[TPERMERR]

リソース・マネージャを正しくオープンできませんでした。より詳しい理由は、そのリソース・マネージャを独自の方法で調査することで得られます。ただし、エラーの正確な性質を判別するための呼び出しを使用すると、移植性が損なわれます。

[TPEPROTO]

TPOPEN() が不正なコンテキストで (たとえば、BEA Tuxedo ATMI のサーバ・グループに参加していないクライアントにより) 呼び出されました。

[TPESYSTEM]

BEA Tuxedo システムのエラーが発生しました。エラーの正確な内容がログ・ファイルに書き込まれます。

[TPEOS]

オペレーティング・システムのエラーが発生しました。

関連項目

TPCLOSE(3cbl)

 

Back to Top Previous Next
Contact e-docsContact BEAwebmasterprivacy