Interstage Application Server リファレンスマニュアル(API編)
目次 索引 前ページ次ページ

第5章 OOCOBOLインタフェース> 5.1 ORBインタフェース

5.1.4 CORBA-ORB-RESOLVE_INITIAL_REFERENCES_REMOTE

名前

 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サービスから通知される例外情報/マイナーコード”を参照してください。


目次 索引 前ページ次ページ

All Rights Reserved, Copyright(C) 富士通株式会社 2007