リソースとリソースグループのプロパティ情報へのアクセス

RGM がクラスタリソースの活動を制御できるようにするために、コールバックメソッドには、そのリソースプロパティへのアクセスが必要です。API は、リソースのシステム定義プロパティや拡張プロパティにアクセスするための、シェルコマンドと C 関数の両方を提供します。

リソースプロパティを設定する API 関数が存在しない (ただし、Status と Status_msg を設定する関数を除く) ため、プロパティ機構では、データサービスの動的な状態情報を格納できません。したがって、動的な状態情報は、広域ファイルに格納します。

クラスタ管理者は、scrgadm(1M) コマンドまたは、利用可能なグラフィカル管理インタフェースを通じて、特定のリソースプロパティを設定できます。

リソースプロパティにアクセスするための C 関数は、可変引数インタフェースを持ちます。API は、操作を示す文字列値タグを定義し、可変引数リストの解釈を決定します。get アクセス関数は、初期化、最終処理、メモリー管理を行う open 関数や close 関数と共に使用します。

リソースプロパティにアクセスするには、次の 3 つの関数を一緒に使用します。

• scha_resource_open(3HA) は、リソースへのアクセスを初期化し、scha_resource_get のハンドルを戻します。

• scha_resource_get(3HA) は、リソース情報にアクセスします。

• scha_resource_close(3HA) は、ハンドルを無効にし、scha_resource_get の戻り値に割り当てられているメモリーを解放します。

これら 3 つの関数は 1 つのマニュアルページ内で説明しています。このマニュアルページには、個々の関数名 scha_resource_open(3HA)、scha_resource_get(3HA)、 scha_resource_close(3HA) でアクセスできます。

シェルスクリプトで使用するコマンドバージョンの scha_resource_get もあります。このコマンドは、フラグ付き引数として、動作タグ、リソース名、およびそのリソースグループ名をとります。他の動作タグ用に、フラグなし引数も利用できます。このアクセスコマンドについての詳細は、scha_resource_get(1HA) のマニュアルページを参照してください。