5.1.4 CORBA-ORB-RESOLVE_INITIAL_REFERENCES

名前

CORBA-ORB-RESOLVE_INITIAL_REFERENCES_REMOTE

形式

REPOSITORY.
    CLASS         SEQUENCE-CORBA-STRING
    CLASS         CORBA-OBJECT
    CLASS         CORBA-SYSTEMEXCEPTION
    CLASS         CORBA-ORB-INVALIDNAME

METHOD-ID.        RESOLVE_INITIAL_REFERENCES_REMOTE.
DATA DIVISION.
LINKAGE SECTION.
01 IDENTIFIER           PIC  X  ANY LENGTH.
01 M                    USAGE OBJECT REFERENCE SEQUENCE-CORBA-STRING.
01 RET                  USAGE OBJECT REFERENCE CORBA-OBJECT.
PROCEDURE DIVISION      USING          IDENTIFIER
                                       M
                        RETURNING      RET
                        RAISING        CORBA-SYSTEMEXCEPTION
                                       CORBA-ORB-INVALIDNAME

機能説明

IDENTIFIERで指定されたオブジェクトのオブジェクトリファレンスを返します。オブジェクトリファレンスは、URL形式でMに定義されたホストのinitial_servicesを検索して獲得します。

IDENTIFIERに指定可能なものを以下に示します。

CORBA-OBJECTID_INTERFACERE-001: インタフェースリポジトリ（動的スケルトンインタフェース）

CORBA-ORB-OBJECTID_NAMESERVICE: ネーミングサービス

Mには複数のURLを指定することが可能です。この場合、指定された順に検索し、オブジェクトリファレンスが見つかった時点で検索は打ち切られます。

URLの指定形式を以下に示します。

iiop//<address>[:<port>]

<address>: ホスト名、DNS名、IPアドレスを指定することが可能です。省略はできません。

<port>: 接続先のORBのポート番号を指定します。

なお、IPv6形式のアドレスを指定することはできません。

注意事項

GS等、Interstage Application Server以外のORB製品に対して本関数を使用することはできません。

復帰値

正常終了した場合は、オブジェクトリファレンスが返されます。
異常終了した場合は、以下の例外が発生します。

CORBA-ORB-INVALIDNAME: identifireに指定されたオブジェクトが見つかりません。

CORBA-SYSTEMEXCEPTION: その他の要因。

システム例外発生時に設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。

5.1.4 CORBA-ORB-RESOLVE_INITIAL_REFERENCES_REMOTE