Interstage Application Server リファレンスマニュアル（API編）

4.15.6 COSTRANSACTIONS-CURRENT-GET-TRANSACTION-NAME

名前

　COSTRANSACTIONS-CURRENT-GET-TRANSACTION-NAME

形式

DATA DIVISION.
  WORKING-STORAGE SECTION.
   COPY CONST IN COSTRANSACTIONS.
   COPY CONST IN CORBA.
   01 COPY CURRENT IN CORBA REPLACING COSTRANSACTIONS-CURRENT BY CURRENTOBJ.
   01 COPY ENVIRONMENT IN CORBA REPLACING CORBA-ENVIRONMENT BY ENV.
   01 COPY STRING  IN CORBA REPLACING CORBA-STRING BY TRANSACTIONNAME.

PROCEDURE DIVISION. 
  CALL "COSTRANSACTIONS-CURRENT-GET-TRANSACTION-NAME" USING
   CURRENTOBJ
   ENV
   TRANSACTIONNAME.

機能説明

　トランザクションを識別するための文字列を返します。

パラメタ

　CURRENTOBJ：

　CORBA-ORB-RESOLVE-INITIAL-REFERENCESメソッド(CORBA-ORB-OBJECTID-TRANCURRENT)で取得したCURRENTインタフェースのオブジェクトリファレンスを指定します。

　ENV：

　例外情報を獲得するためにCORBA-ENVIRONMENT構造体を指定します。

復帰値

　正常終了した場合は、ENV構造体のMAJORにCORBA-NO-EXCEPTIONが設定され、復帰値にトランザクションを識別するための文字列を返します。トランザクションが作成されていない場合は、NULL文字を返します。
　異常終了した場合は、ENV構造体のMAJORにCORBA-SYSTEM-EXCEPTIONが設定され、ENV構造体のIDに詳細情報が設定されます。ENV構造体のIDに詳細情報が設定されます。IDの値と意味は以下のとおりです。

EX-CORBA-STEXCEP-TRANSACTION-R：
  トランザクションがロールバックされています。
EX-CORBA-STEXCEP-NO-IMPLEMENT：
  OTSシステムが起動されていません。
EX-CORBA-STEXCEP-COMM-FAILURE：
  通信異常が発生しました。
EX-CORBA-STEXCEP-NO-RESOURCES：
  資源不足が発生しました。

EX-CORBA-STEXCEP-NO-MEMORY：
  動的メモリの獲得に失敗しました。