ページの先頭行へ戻る
Interstage Application Server リファレンスマニュアル(API編)
FUJITSU Software

4.18.2 ロードバランスオグジェクトグループインタフェース

4.18.2.1 ISOD-LBG-BIND

名前

ISOD-LBG-BIND

形式

ENVIRONMENT DIVISION.
   CONFIGURATION SECTION.
   SPECIAL-NAMES.
     SYMBOLIC CONSTANT
     COPY SYMBOL-CONST IN CORBA.
          .

   DATA DIVISION.
     COPY CONST IN CORBA.
     01 COPY OBJECT IN CORBA REPLACING CORBA-OBJECT BY OBJ.
     01 COPY OBJECT IN CORBA REPLACING CORBA-OBJECT BY OBJECTREF.
     01 COPY ENVIRONMENT IN CORBA REPLACING CORBA-ENVIRONMENT ENV.
   PROCEDURE DIVISION.
     CALL "ISOD-LBG-BIND"  USING
          LBG
          OBJECTREF
          ENV.

機能説明

本関数は、OBJECTREFで指定されたロードバランス対象のオブジェクトを、LBGで指定されたロードバランスオブジェクトグループに登録します。
OBJECTREFに指定するオブジェクトリファレンスのインタフェースリポジトリIDは、OMG IDL形式(“IDL:”で始まる形式)を使用してください。

復帰値

正常終了した場合は、ENV構造体のMAJORにCORBA-NO-EXCEPTIONが設定されます。
異常終了した場合は、ENV構造体のMAJORにCORBA-SYSTEM-EXCEPTIONまたはCORBA-USER-EXCEPTIONが設定され、ENV構造体のIDに詳細情報が設定されます。

ユーザ例外の場合は、以下の詳細情報が設定されます。

IDL:ISOD/LBG/AlreadyBound:1.0

すでに登録済のオブジェクトと同一の情報を持つオブジェクトが指定されました。

IDL:ISOD/LBG/CannotProceed2:1.0

ロードバランス機能のDBの処理で異常が発生しました。または、OBJECTREFの指定に誤りがあります。

IDL:ISOD/LBG/BadObject:1.0

OBJECTREFで指定されたオブジェクトが不当です。

システム例外の場合は、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。

4.18.2.2 ISOD-LBG-UNBIND

名前

ISOD-LBG-UNBIND

形式

ENVIRONMENT DIVISION.
   CONFIGURATION SECTION.
   SPECIAL-NAMES.
     SYMBOLIC CONSTANT
     COPY SYMBOL-CONST IN CORBA.
     .

   DATA DIVISION.
     COPY CONST IN CORBA.
     01 COPY OBJECT IN CORBA REPLACING CORBA-OBJECT BY OBJ.
     01 COPY OBJECT IN CORBA REPLACING CORBA-OBJECT BY OBJECTREF.
     01 COPY ENVIRONMENT IN CORBA REPLACING CORBA-ENVIRONMENT ENV.
     PROCEDURE DIVISION.
       CALL "ISOD-LBG-UNBIND"  USING
            LBG
            OBJECTREF
            ENV.

機能説明

本関数は、OBJECTREFで指定されたロードバランス対象のオブジェクトを、LBGで指定されたロードバランスオブジェクトグループから削除します。
OBJECTREFに指定するオブジェクトリファレンスのインタフェースリポジトリIDは、OMG IDL形式(“IDL:”で始まる形式)を使用してください。

復帰値

正常終了した場合は、ENV構造体のMAJORにCORBA-NO-EXCEPTIONが設定されます。
異常終了した場合は、ENV構造体のMAJORにCORBA-SYSTEM-EXCEPTIONまたはCORBA-USER-EXCEPTIONが設定され、ENV構造体のIDに詳細情報が設定されます。

ユーザ例外の場合は、以下の詳細情報が設定されます。

IDL:ISOD/LBG/NotFound:1.0

OBJECTREFで指定されたオブジェクトが見つかりません。

IDL:ISOD/LBG/CannotProceed2:1.0

ロードバランス機能のDBの処理で異常が発生しました。または、OBJECTREFの指定に誤りがあります。

IDL:ISOD/LBG/BadObject:1.0

OBJECTREFで指定されたオブジェクトが不当です。

システム例外の場合は、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。

4.18.2.3 ISOD-LBG-REBIND-DEFAULT

名前

ISOD-LBG-REBIND-DEFAULT

形式

ENVIRONMENT DIVISION.
   CONFIGURATION SECTION.
   SPECIAL-NAMES.
     SYMBOLIC CONSTANT
     COPY SYMBOL-CONST IN CORBA.
     .

   DATA DIVISION.
     COPY CONST IN CORBA.
     01 COPY OBJECT IN CORBA REPLACING CORBA-OBJECT BY OBJ.
     01 COPY OBJECT IN CORBA REPLACING CORBA-OBJECT BY OBJECTREF.
     01 COPY ENVIRONMENT IN CORBA REPLACING CORBA-ENVIRONMENT ENV.
     01 COPY OBJECT IN CORBA REPLACING CORBA-OBJECT BY RESULT.

   PROCEDURE DIVISION.
     CALL "ISOD-LBG-REBIND-DEFAULT"  USING
          LBG
          OBJECTREF
          ENV
          RESULT.

機能説明

本関数は、LBGで指定されたロードバランスオブジェクトグループのデフォルトオブジェクトを、OBJECTREFで指定されたオブジェクトに変更します。
正常終了した場合、復帰値として変更前のデフォルトオブジェクトのオブジェクトリファレンスが返却されます。
OBJECTREFに指定するオブジェクトリファレンスのインタフェースリポジトリIDは、OMG IDL形式(“IDL:”で始まる形式)を使用してください。

本関数はオブジェクトリファレンスを格納する領域を獲得するため、この領域が不要になった時点で、CORBA-OBJECT-RELEASE関数を使用して領域を解放する必要があります。

復帰値

正常終了した場合は、変更前のデフォルトオブジェクトのオブジェクトリファレンスが返され、ENV構造体のMAJORにCORBA-NO-EXCEPTIONが設定されます。
異常終了した場合は、ENV構造体のMAJORにCORBA-SYSTEM-EXCEPTIONまたはCORBA-USER-EXCEPTIONが設定され、ENV構造体のIDに詳細情報が設定されます。

ユーザ例外の場合は、以下の詳細情報が設定されます。

IDL:ISOD/LBG/CannotProceed:1.0

デフォルトオブジェクトが設定されていません。

IDL:ISOD/LBG/CannotProceed2:1.0

ロードバランス機能のDBの処理で異常が発生した。または、OBJECTREFの指定に誤りがあります。

IDL:ISOD/LBG/BadObject:1.0

OBJECTREFで指定されたオブジェクトが不当です。

IDL:ISOD/LBG/OperationBusy:1.0

同時処理可能な要求の上限に達しました。リトライしてください。

システム例外の場合は、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。

4.18.2.4 ISOD-LBG-LIST

名前

ISOD-LBG-LIST

形式

ENVIRONMENT DIVISION.
   CONFIGURATION SECTION.
   SPECIAL-NAMES.
     SYMBOLIC CONSTANT
     COPY SYMBOL-CONST IN CORBA.
     .

   DATA DIVISION.
     COPY CONST IN CORBA.
     01 COPY OBJECT IN CORBA REPLACING CORBA-OBJECT BY OBJ.
     01 OBJECTLIST USAGE IS POINTER.
     01 COPY ENVIRONMENT IN CORBA REPLACING CORBA-ENVIRONMENT ENV.

   PROCEDURE DIVISION.
     CALL "ISOD-LBG-LIST"  USING
          LBG
          OBJECTLIST
          ENV.

機能説明

LBGで指定されるロードバランスオブジェクトグループに登録済のオブジェクトのオブジェクトリファレンスの一覧を返却します。
本関数はオブジェクトのリストを格納する領域を獲得するため、この領域が不要になった時点で、CORBA-FREE関数を使用して領域を解放する必要があります。

復帰値

正常終了した場合は、ENV構造体のMAJORにCORBA-NO-EXCEPTIONが設定されます。
異常終了した場合は、ENV構造体のMAJORにCORBA-SYSTEM-EXCEPTIONまたはCORBA-USER-EXCEPTIONが設定され、ENV構造体のIDに詳細情報が設定されます。

ユーザ例外の場合は、以下の詳細情報が設定されます。

IDL:ISOD/LBG/CannotProceed2:1.0

ロードバランス機能のDBの処理で異常が発生しました。

システム例外の場合は、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。