4.12.1 CORBA-SEND-MULTIPLE-REQUESTS

名前

CORBA-SEND-MULTIPLE-REQUESTS

形式

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

 PROCEDURE DIVISION.
    CALL "CORBA-SEND-MULTIPLE-REQUESTS" USING
         REQ
         ENV
         C-COUNT
         INVOKE-FLAGS
         ORB-STATUS.

機能説明

1つ以上のリクエストを並行に送信します。REQには送信するリクエストに対するリクエストオブジェクトをC-COUNTで指定した個数分設定します。
CORBA-REQUEST-SEND関数と同様に、サーバアプリケーションの関数が終わるのを待たずに呼び出し元に復帰します。

INVOKE-FLAGSには、以下のフラグが指定できます。

CORBA-INV-NO-RESPONSE: 呼び出し元は返答を待ちません。また、いずれの出力パラメタ（inoutおよびoutの場合）も更新されません。このオプションは、操作がonewayと定義されていないときでも指定することができます。

CORBA-INV-TERM-ON-ERR: リクエストのうちの1つがエラーを起こすと、残りのリクエストは送られません。

CORBA-REQUEST-GET-RESPONSE関数、CORBA-GET-NEXT-RESPONSE関数を用いることによって、サーバアプリケーションの関数の終わりを判断することができます。

復帰値

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