scds_failover_rg(3HA)					 Sun Cluster HA and Data Services				     scds_failover_rg(3HA)

NAME

       scds_failover_rg - failover a resource group

SYNOPSIS

       cc [flags...] -I /usr/cluster/include file -L /usr/cluster/lib  -l  dsdev
       #include <rgm/libdsdev.h>

       scha_err_t scds_failover_rg(scds_handle_t handle);

DESCRIPTION

       The  scds_failover_rg()	function performs a scha_control(3HA) SCHA_GIVEOVER operation on the resource group containing the resource passed
       to the calling program.

       When this function succeeds, it does not return. Therefore, treat this function as the last piece of code to be	executed  in  the  calling
       program.

PARAMETERS

       The following parameters are supported:

       handle		   The handle that is returned from scds_initialize(3HA).

RETURN VALUES

       The following return values are supported:

       SCHA_ERR_NOERR	   Indicates the function succeeded.

       Other values	   Indicate the function failed. See scha_calls(3HA) for a description of other error codes.

FILES

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

	   Include file

       /usr/cluster/lib/libdsdev.so

	   Library

ATTRIBUTES

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWscdev 		   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Evolving			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       scha_calls(3HA), scha_control(3HA), attributes(5)

Sun Cluster 3.2 						    7 Sep 2007						     scds_failover_rg(3HA)