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

4.7.2 CORBA-REQUEST-INVOKE

名前

　CORBA-REQUEST-INVOKE

形式

 ENVIRONMENT DIVISION.
   CONFIGURATION SECTION.
   SPECIAL-NAMES.
     SYMBOLIC CONSTANT
     COPY SYMBOL-CONST IN CORBA.
     .
 DATA DIVISION.
  WORKING-STORAGE SECTION.
    COPY CONST IN CORBA.
    01 COPY REQUEST IN CORBA REPLACING CORBA-REQUEST BY REQ.
    01 COPY FLAGS IN CORBA REPLACING CORBA-FLAGS BY INVOKE-FLAGS.
    01 COPY ENVIRONMENT IN CORBA REPLACING CORBA-ENVIRONMENT BY ENV.
    01 COPY STATUS IN CORBA REPLACING CORBA-STATUS BY ORB-STATUS.

 PROCEDURE DIVISION.
   CALL "CORBA-REQUEST-INVOKE" USING
         REQ
         INVOKE-FLAGS
         ENV
         ORB-STATUS.

機能説明

　REQで指定したリクエストオブジェクトの生成時に指定したサーバアプリケーションの関数を呼び出します。REQには、CORBA-OBJECT-CREATE-REQUEST関数で返されるリクエストオブジェクトのオブジェクトリファレンスを指定します。結果はCORBA-OBJECT-CREATE-REQUEST関数で指定されたRESULT引数に入れられます。呼び出し側は、サーバアプリケーションの処理が終わるまで待たされます。INVOKE-FLAGSには、NULL(0)を設定します。
　また、ユーザ例外が定義されたメソッドを使用する場合には、IDLファイルの内容を事前にインタフェースリポジトリに登録します。

復帰値

　正常終了した場合は、CORBA-OKが返されます。
　異常終了した場合は、CORBA-FAILEDが返されます。
　REQにNULLが指定された場合、ENV構造体のMAJORにはCORBA-USER-EXCEPTIONが設定されます。