Sun Cluster データサービス開発ガイド (Solaris OS 版)

リソース関数

以下の関数は、RGM に管理されているリソースについての情報にアクセスします。モニターから見たリソースの状態を表します。

scha_resource_open()scha_resource_get ()scha_resource_close()

これらの関数は、RGM によって管理されるリソースの情報にアクセスします。 scha_resource_open() 関数は、リソースへのアクセスを初期化し、scha_resource_get() のハンドルを戻します。scha_resource_get() 関数は、リソースの情報にアクセスします。 scha_resource_close() 関数は、ハンドルを無効にし、scha_resource_get() の戻り値に割り当てられているメモリーを解放します。

scha_resource_open() 関数がリソースのハンドルを戻した後に、クラスタの再構成や管理アクションによって、リソースが変更されることがあります。この場合、scha_resource_get() 関数がハンドルを通じて獲得した情報は正しくない可能性があります。 リソースでクラスタの再構成や管理アクションが行われた場合、RGM は scha_err_seqid エラーコードを scha_resourcegroup_get() 関数に戻し、リソースが変更されたことを示します。 このメッセージは致命的なエラーメッセージではないため、関数は正常に終了します。 したがって、このメッセージは無視してもかまいません。また、現在のハンドルを閉じて新しいハンドルを開き、リソースの情報にアクセスし直してもかまいません。

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

scha_resource_setstatus()

RGM の制御下のリソースの Status および Status_msg プロパティを設定します。 この関数はリソースのモニターによって使用され、モニターから見たリソースの状態を反映します。


注 –

scha_resource_setstatus() はリソースモニター専用の関数ですが、任意のプログラムから呼び出すことができます。