scds_fm_sleep(3HA)

名前

scds_fm_sleep - 障害モニター制御ソケットでメッセージを待機

形式

cc [flags…] –I /usr/cluster/include file –L /usr/cluster/lib –l dsdev#include <rgm/libdsdev.h>
     scha_err_t scds_fm_sleep(scds_handle_t handle, time_t timeout);

説明

scds_fm_sleep() 関数は、プロセスモニター機能の制御下で実行されているデータサービスアプリケーションプロセスツリーの終了を待機します。指定のタイムアウト時間内に終了しない場合は、SCHA_ERR_NOERR を返します。

データサービスアプリケーションのプロセスツリーが終了した場合、scds_fm_sleep() は障害履歴内に SCDS_COMPLETE_FAILURE を記録し、プロセスツリーを再起動するか、scds_fm_action(3HA) のマニュアルページに説明されているアルゴリズムに従ってフェイルオーバーを実行します。フェイルオーバーの試行に失敗した場合、アプリケーションの再起動が試行されます。

試行された再起動が失敗した場合、この関数は SCHA_ERR_INTERNAL を返します。

障害履歴によってフェイルオーバーを試行し、成功した場合、scds_fm_sleep() は値を返しません。

パラメータ

次のパラメータがサポートされます。

handle

scds_initialize(3HA) から返されるハンドルです。

timeout

タイムアウト時間 (秒) です。

戻り値

scds_fm_sleep() 関数の戻り値は次のとおりです。

0

関数の実行に成功。

0 以外

関数の実行に失敗。

エラー

SCHA_ERR_NOERR

プロセスツリーが終了していない。

SCHA_ERR_INTERNAL

データサービスアプリケーションプロセスツリーは終了したが、再起動に失敗。

その他の値

関数の実行に失敗。障害コードの意味については、scha_calls(3HA) を参照してください。

ファイル

/usr/cluster/include/rgm/libdsdev.h

インクルードファイル

/usr/cluster/lib/libdsdev.so

ライブラリ

属性

次の属性については、attributes(5) を参照してください。

属性タイプ 属性値 使用条件 ha-cluster/developer/api インタフェースの安定性 発展中

関連項目

scha_calls(3HA), scds_fm_action(3HA), scds_initialize(3HA), attributes(5)