Thescds_fm_sleep() function waits for a data service application process tree that running under control of the process monitor facility to die. If no such death occurs within the specified timeout period, the function returns SCHA_ERR_NOERR.

If a data service application process tree death occurs, scds_fm_sleep() records SCDS_COMPLETE_FAILURE in the failure history and either restarts the process tree or fails it over according to the algorithm described in the scds_fm_action(3HA) man page. If a failover attempt is unsuccessful, a restart of the application is attempted.

If an attempted restart fails, the function returns SCHA_ERR_INTERNAL.

Note that if the failure history causes this function to do a failover, and the failover attempt succeeds, scds_fm_sleep() never returns.

The following parameters are supported:

handle

The handle returned from scds_initialize(3HA).

timeout

The timeout period measured in seconds.

The scds_fm_sleep() function returns the following:

0

The function succeeded.

non-zero

The function failed.

SCHA_ERR_NOERR

Indicates the process tree has not died.

SCHA_ERR_INTERNAL

Indicates the data service application process tree has died and failed to restart.

Other values

Indicate the function failed. See scha_calls(3HA) for the meaning of failure codes.

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

include file

/usr/cluster/lib/libdsdev.so

library

See attributes(5) for descriptions of the following attributes:

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