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

4.18.1.1 ISOD-LBO-CREATE-LBG

名前

　ISOD-LBO-CREATE-LBG

形式

ENVIRONMENT DIVISION.
   CONFIGURATION SECTION.
   SPECIAL-NAMES.
     SYMBOLIC CONSTANT
     COPY SYMBOL-CONST IN CORBA.
     .
   DATA DIVISION.
     COPY CONST IN CORBA.
     01 COPY ISOD-LBO REPLACING ISOD-LBO BY LBO. 
     01 COPY COSNAMING-CONTEXT IN CORBA REPLACING COSNAMING-CONTEXT BY NC.
     01 COPY COSNAMING-NAME IN CORBA REPLACING COSNAMING-NAME BY N.
     01 COPY ENUM IN CORBA REPLACING CORBA-NUM BY LOADBALANCETYPE.
     01 COPY OBJECT IN CORBA REPLACING CORBA-OBJECT BY DEFAULTOBJREF.
     01 COPY ENVIRONMENT IN CORBA REPLACING CORBA-ENVIRONMENT ENV.
     01 COPY OBJECT IN CORBA REPLACING CORBA-OBJECT BY RESULT.
     
   PROCEDURE DIVISION.
     CALL "ISOD-LBO-CREATE-LBG"  USING
          LBO
          NC
          N
          LOADBALANCETYPE
          DEFAULTOBJECTREF
          ENV
          RESULT.

機能説明

　本関数は、ロードバランスオブジェクトグループを作成し、ネーミングサービスに登録します。NCで指定されたネーミングコンテキスト配下にNで指定された名前で登録します。
　ロードバランスオブジェクトグループの生成に成功した場合、復帰値として生成したロードバランスオブジェクトグループのオブジェクトリファレンスが返却されます。
　LOADBALANCETYPEには、ISOD-LBG-ROUNDROBINを指定します。
　DEFAULTOBJECTREFには、ロードバランス機能が動作していない場合に、ネーミングサービスが返却するオブジェクトリファレンス（デフォルトオブジェクトリファレンス）を指定してください。指定しない場合は、ロードバランス機能が動作していない場合には、ネーミングサービスからはオブジェクトリファレンスが返却されません。このオブジェクトリファレンスは、ISOD-LBG BINDおよび ISOD-LBG UNBINDオペレーションでは、登録および削除はできません。指定した場合は、ロードバランスオブジェクトグループ作成後に、ISOD-LBG REBIND-DEFAULTオペレーションを使用して変更することができます。
　本関数はオブジェクトリファレンスを格納する領域を獲得するため、この領域が不要になった時点で、CORBA-OBJECT-RELEASE関数を使用して領域を解放する必要があります。

復帰値

　正常終了した場合は、生成したロードバランスオブジェクトグループのオブジェクトリファレンスが返され、ENV構造体のMAJORにCORBA-NO-EXCEPTIONが設定されます。
　異常終了した場合は、ENV構造体のMAJORにCORBA-SYSTEM-EXCEPTIONまたはCORBA-USER-EXCEPTIONが設定され、ENV構造体のIDに詳細情報が設定されます。
　ユーザ例外の場合は、以下の詳細情報が設定されます。

　IDL:ISOD/LBO/NotFound:1.0

　Nで指定されたネーミングコンテキストが見つかりません。

　IDL:ISOD/LBO/CannotProceed:1.0

　NCで指定されたネーミングコンテキストが存在しません。

　IDL:ISOD/LBO/InvalidName:1.0

　名前の指定に誤りがあります。

　IDL:ISOD/LBO/AlreadyExist:1.0

　指定された名前のバインディングがすでに存在します。

　IDL:ISOD/LBO/InvalidType:1.0

　ロードバランスタイプの指定に誤りがあります。

　IDL:ISOD/LBO/BadObject:1.0

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

　IDL:ISOD/LBO/OperationBusy:1.0

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

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