この節で説明するメソッドは、他のインタフェースリポジトリオブジェクトを包含する各インタフェースリポジトリオブジェクト(Containerと呼びます)に継承されて、その継承先のインタフェースリポジトリオブジェクトのメソッドとして使用されます。
名前
CORBA-CONTAINER-LOOKUP
形式
REPOSITORY. CLASS CORBA-CONTAINED CLASS CORBA-SYSTEMEXCEPTION METHOD-ID. LOOKUP. DATA DIVISION. LINKAGE SECTION. 01 0--RESULT OBJECT REFERENCE CORBA-CONTAINED. 01 SEARCH_NAME PIC X ANY LENGTH. PROCEDURE DIVISION USING SEARCH_NAME RETURNING 0—RESULT RAISING CORBA-SYSTEMEXCEPTION . END METHOD LOOKUP.
機能説明
インタフェースリポジトリオブジェクトが包含するインタフェースリポジトリオブジェクトの中から、指定された名前を持つオブジェクトを見つけだし、そのオブジェクトリファレンスを返します。search_nameには、検索する名前(PIC X)を指定します。返却対象のオブジェクトが見つからない場合は、NIL(空の)オブジェクトリファレンスを返して正常終了します。
復帰値
正常終了した場合は、指定された名前を持つオブジェクトのオブジェクトリファレンスが返されます。
異常終了した場合は、NIL(空の)オブジェクトリファレンスが返され、SystemExceptionが発生します。
システム例外発生時に設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。
名前
CORBA-CONTAINER-CONTENTS
形式
REPOSITORY. CLASS SEQUENCE-CORBA-CONTAINED CLASS CORBA-SYSTEMEXCEPTION METHOD-ID. CONTENTS. DATA DIVISION. LINKAGE SECTION. 01 0--RESULT TYPE CORBA-CONTAINEDSEQ. 01 LIMIT_TYPE TYPE CORBA-DEFINITIONKIND. 01 EXCLUDE_INHERITED TYPE CORBA-BOOLEAN. PROCEDURE DIVISION USING LIMIT_TYPE EXCLUDE_INHERITED RETURNING 0—RESULT RAISING CORBA-SYSTEMEXCEPTION . END METHOD CONTENTS.
機能説明
インタフェースリポジトリオブジェクトに直接包含される、または、継承によって包含されるインタフェースリポジトリオブジェクトのオブジェクトリファレンスをリスト形式で返します。
LIMIT_TYPEで指定されたインタフェースタイプの包含オブジェクトが返却対象となります。
EXCLUDE_INHERITEDでTRUEが指定された場合は、継承オブジェクトは返却対象としません。
LIMIT_TYPEがCORBA-DK_ALLで、かつEXCLUDE_INHERITEDがFALSEの場合は、包含/継承するすべてのオブジェクトリファレンスのリストを返します。
返却対象のオブジェクトが見つからない場合は、返却リストのlengthに0が設定され、オブジェクトリファレンスは不定となります。
復帰値
正常終了した場合は、検索されたオブジェクトのオブジェクトリファレンスのリストが返されます。
異常終了した場合は、NIL(空の)オブジェクトリファレンスのリストが返され、SystemExceptionが発生します。
システム例外発生時に設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。
名前
CORBA-CONTAINER-LOOKUP_NAME
形式
REPOSITORY. CLASS SEQUENCE-CORBA-CONTAINED CLASS CORBA-SYSTEMEXCEPTION METHOD-ID. LOOKUP_NAME. DATA DIVISION. LINKAGE SECTION. 01 0--RESULT TYPE CORBA-CONTAINEDSEQ. 01 SEARCH_NAME PIC X ANY LENGTH. 01 LEVELS_TO_SEARCH TYPE CORBA-LONG. 01 LIMIT_TYPE TYPE CORBA-DEFINITIONKIND. 01 EXCLUDE_INHERITED TYPE CORBA-BOOLEAN. PROCEDURE DIVISION USING SEARCH_NAME LEVELS_TO_SEARCH LIMIT_TYPE EXCLUDE_INHERITED RETURNING 0—RESULT RAISING CORBA-SYSTEMEXCEPTION . END METHOD LOOKUP_NAME.
機能説明
インタフェースリポジトリオブジェクトに直接包含される、または、継承によって包含されるオブジェクトの中から、指定された名前を持つオブジェクトを見つけだし、そのオブジェクトリファレンスとともに、さらにそのオブジェクトが包含/継承するオブジェクトのオブジェクトリファレンスをリスト形式で返します。
SEARCH_NAMEに、検索のキーとする名前(PIC X)を指定します。
LEVELS_TO_SEARCHには、検索の対象とする階層の深さを指定します。-1が指定されたときには、すべての階層に渡って検索を行い、1が指定されたときには、指定されたオブジェクトの直下にあるオブジェクトのみを検索します。
limit_typeで指定されたインタフェースタイプの包含オブジェクトが返却対象となります。
exclude_inheritedでTRUEが指定された場合は、継承オブジェクトは返却対象としません。
LIMIT_TYPEがCORBA-DK_ALLで、かつEXCLUDE_INHERITEDがFALSEの場合は、該当オブジェクトおよびそのオブジェクトが包含/継承するすべてのオブジェクトリファレンスのリストを返します。
返却対象のオブジェクトが見つからない場合は、返却リストのlengthに0が設定され、オブジェクトリファレンスは不定となります。
復帰値
正常終了した場合は、検索されたオブジェクトのオブジェクトリファレンスのリストが返されます。
異常終了した場合は、NIL(空の)オブジェクトリファレンスのリストが返され、SystemExceptionが発生します。
システム例外発生時に設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。
名前
CORBA-CONTAINER-DESCRIBE_CONTENTS
形式
REPOSITORY. CLASS SEQUENCE-DESCRIPTION-001 CLASS CORBA-SYSTEMEXCEPTION METHOD-ID. DESCRIBE_CONTENTS. DATA DIVISION. LINKAGE SECTION. 01 0--RESULT TYPE CORBA-CONTAINER-DESCRIPTIONSEQ. 01 LIMIT_TYPE TYPE CORBA-DEFINITIONKIND. 01 EXCLUDE_INHERITED TYPE CORBA-BOOLEAN. 01 MAX_RETURNED_OBJS TYPE CORBA-LONG. PROCEDURE DIVISION USING LIMIT_TYPE EXCLUDE_INHERITED MAX_RETURNED_OBJS RETURNING 0—RESULT RAISING CORBA-SYSTEMEXCEPTION . END METHOD DESCRIBE_CONTENTS.
機能説明
インタフェースリポジトリオブジェクトに直接包含される、または、継承によって包含されるオブジェクトの定義情報を、CORBA-DEFINITIONKIND構造体のリスト形式(“5.19.1 型の定義”参照)で返します。
LIMIT_TYPEで指定されたインタフェースタイプの包含オブジェクトが返却対象となります。
EXCLUDE_INHERITEDでTRUEが指定された場合は、継承オブジェクトは返却対象としません。
MAX_RETURNED_OBJSで指定された数分の定義情報が返却されます。
LIMIT_TYPEがCORBA-DK_ALLで、かつ、EXCLUDE_INHERITEDがFALSEの場合は、包含/継承されるすべてのオブジェクト定義情報リストを返します。ただし、この場合もMAX_RETURNED_OBJSで指定された数分だけが返却対象となります(登録されている数分得る場合は、MAX_RETURNED_OBJSに-1を指定します)。
返却対象のオブジェクトが見つからない場合は、返却リストのlengthに0が設定され、オブジェクトリファレンスは不定となります。
復帰値
正常終了した場合は、オブジェクトの定義情報リストが返されます。
異常終了した場合は、NIL(空の)定義情報リストが返され、SystemExceptionが発生します。
システム例外発生時に設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。
(1) CORBA-CONTAINER-DEF_KIND
(1)については、“IRObject共通インタフェース”を継承します。
“CORBA-IROBJECT”の部分を“CORBA-CONTAINER”に置き換えて使用することができます。
関数の仕様については、“5.19.2 IRObject共通インタフェース”を参照してください。