32.1.3 Agentのメソッド
-
ObjLocation::HostnameSeq_ptr all_agent_locations();
現在osagentプロセスが実行されているホストを表すホスト名のシーケンスを返します。「32.6 <type>Seq」も参照してください。
このメソッドでは,次の例外が発生します。
- Fail
-
FailReason値は次のとおりです。
・NO_AGENT_AVAILABLE
・NO_SUCH_TRIGGER
・AGENT_ERROR
Failクラスの詳細については,「32.3 Fail」を参照してください。
-
ObjLocation::ObjSeq_ptr all_available();
ネットワーク上のスマートエージェントに現在登録されているすべてのオブジェクトの,オブジェクトリファレンスのシーケンスを返します。「32.6 <type>Seq」も参照してください。
このメソッドでは,次の例外が発生します。
- Fail
-
FailReason値は次のとおりです。
・NO_AGENT_AVAILABLE
・NO_SUCH_TRIGGER
・AGENT_ERROR
Failクラスの詳細については,「32.3 Fail」を参照してください。
-
ObjLocation::DescSeqSeq_ptr all_available_descs();
ネットワーク上のスマートエージェントに現在登録されているすべてのオブジェクトの記述を返します。返される記述情報はリポジトリIDによって編成されます。「32.7 <type>SeqSeq」も参照してください。
このメソッドでは,次の例外が発生します。
- Fail
-
FailReason値は次のとおりです。
・NO_AGENT_AVAILABLE
・NO_SUCH_TRIGGER
・AGENT_ERROR
Failクラスの詳細については,「32.3 Fail」を参照してください。
-
ObjLocation::ObjSeq_ptr all_instances(
const char *repository_id);
指定されたrepository_idを持つすべてのインスタンスのオブジェクトリファレンスのシーケンスを返します。「32.6 <type>Seq」も参照してください。
引数の意味を次に示します。
-
repository_id
取得するオブジェクトリファレンスのリポジトリID
このメソッドでは,次の例外が発生します。
- Fail
-
NO_SUCH_TRIGGER以外のFailReason値。Failクラスの詳細については,「32.3 Fail」を参照してください。
-
-
ObjLocation::DescSeq_ptr all_instances_descs(
const char *repository_id);
指定されたrepository_idを持つすべてのオブジェクトインスタンスの記述情報を返します。「32.6 <type>Seq」も参照してください。
引数の意味を次に示します。
-
repository_id
取得するオブジェクト記述のリポジトリID
このメソッドでは,次の例外が発生します。
- Fail
-
NO_SUCH_TRIGGER以外のFailReason値。Failクラスの詳細については,「32.3 Fail」を参照してください。
-
-
ObjLocation::ObjSeq_ptr all_replica(
const char *repository_id,
const char *instance_name);
指定されたrepository_idとinstance_nameを持つオブジェクトのオブジェクトリファレンスのシーケンスを返します。「32.6 <type>Seq」も参照してください。
引数の意味を次に示します。
-
repository_id
検索するオブジェクトリファレンスのリポジトリID
-
instance_name
返されるオブジェクトリファレンスのインスタンス名
このメソッドでは,次の例外が発生します。
- Fail
-
NO_SUCH_TRIGGER以外のFailReason値。Failクラスの詳細については,「32.3 Fail」を参照してください。
-
-
ObjLocation::DescSeq_ptr all_replica_descs(
const char *repository_id,
const char *instance_name);
指定されたrepository_idとinstance_nameを持つすべてのオブジェクトインスタンスの記述情報のシーケンスを返します。「32.6 <type>Seq」も参照してください。
引数の意味を次に示します。
-
repository_id
取得するオブジェクト記述のリポジトリID
-
instance_name
取得するオブジェクト記述のインスタンス名
このメソッドでは,次の例外が発生します。
- Fail
-
NO_SUCH_TRIGGER以外のFailReason値。Failクラスの詳細については,「32.3 Fail」を参照してください。
-
-
CORBA::StringSequence* all_repository_ids();
このメソッドは,任意のosagentによって認識されているインタフェースをすべて取得します。
このメソッドでは,次の例外が発生します。
- Fail
-
リポジトリIDが不正です。
-
const ObjLocation::TriggerDesc& desc,
ObjLocation::TriggerHandler_ptr hdlr);
descで指定されている記述情報と一致するオブジェクトインスタンスのトリガーハンドラhdlrを登録します。
- 注
-
トリガーの記述に合うオブジェクトが使用できるようになるたびに,TriggerHandlerが呼び出されます。オブジェクトの最初のインスタンスを使用できるようにするには,最初の通知を受信したあとに,unreg_triggerメソッドを使ってトリガーを削除してください。
引数の意味を次に示します。
-
desc
次の情報を組み合わせたオブジェクトインスタンス記述情報
・リポジトリID
・インスタンス名
・ホスト名
情報を提供して,監視するオブジェクトインスタンスのナロウイングおよびワイドニングができます。
-
hdlr
登録されるトリガーハンドラオブジェクト
このメソッドでは,次の例外が発生します。
- Fail
-
NO_SUCH_TRIGGER以外のFailReason値。Failクラスの詳細については,「32.3 Fail」を参照してください。
-
const ObjLocation::TriggerDesc& desc,
ObjLocation::TriggerHandler_ptr hdlr);
descで指定されている記述情報と一致する,オブジェクトインスタンスのトリガーハンドラhdlrを,登録解除します。
引数の意味を次に示します。
-
desc
オブジェクト記述情報
-
hdlr
登録解除されるトリガーハンドラオブジェクト
このメソッドでは,次の例外が発生します。
- Fail
-
NO_SUCH_TRIGGER以外のFailReason値。Failクラスの詳細については,「32.3 Fail」を参照してください。
-
-
CORBA::Boolean willRefreshOADs();
このクラスが提供するメソッドが呼び出されるたびに,OAD(オブジェクト活性化デーモン)群が更新される場合は,TRUEを返します。そうでない場合は,FALSEを返します。それぞれの呼び出しでキャッシュがリフレッシュされないと,次のようになります。
-
すべてのオブジェクトが報告されていますが,それらの記述子のactivableフラグが不当な場合があります。
-
前回のOADキャッシュのリフレッシュ後に起動された,OADに登録されているオブジェクトの存在を検証しようとすると,それらのオブジェクトがOADによって活性化されてしまいます。
-
-
void willRefreshOADs(
CORBA::Boolean val);
このクラスは,OAD群を保持します。このクラスによって提供されるメソッドは,そのOAD群に含まれるOADの自動リフレッシュを有効または無効にします。
引数の意味を次に示します。
-
val
TRUEの場合,このクラスで提供されているメソッドが呼び出されるたびに,OAD群がリフレッシュされます。
-