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

NAME

       scds_hasp_check - get status information about SUNW.HAStoragePlus resources that are used by a resource

SYNOPSIS

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

       scha_err_t scds_hasp_check(scds_handle_t handle, scds_hasp_status_t *hasp_status

DESCRIPTION

       The  scds_hasp_check() function retrieves status information about SUNW.HAStoragePlus(5) resources that are used by a resource. This infor-
       mation is obtained from the state, online or otherwise, of all SUNW.HAStoragePlus resources on which the resource depends.  This  state	is
       obtained by using the Resource_dependencies or Resource_dependencies_weak system properties that are defined for the resource.

       Resource  type implementations can use scds_hasp_check() in VALIDATE and MONITOR_CHECK method callback implementations to determine whether
       checks that are specific to any file systems that are managed by SUNW.HAStoragePlus resources should be carried out.

       When the function succeeds, a status code is stored in hasp_status. This code can be one of the following values:

       SCDS_HASP_NO_RESOURCE

	   Indicates that the resource does not depend on a SUNW.HAStoragePlus resource.

       SCDS_HASP_ERR_CONFIG

	   Indicates that at least one of the SUNW.HAStoragePlus resources on which the resource depends is located in a different resource group.

       SCDS_HASP_NOT_ONLINE

	   Indicates that a SUNW.HAStoragePlus resource on which the resource depends is not online on any potential primary node or zone.

       SCDS_HASP_ONLINE_NOT_LOCAL

	   Indicates that at least one SUNW.HAStoragePlus resource on which the resource depends is online, but on another node or zone from which
	   this function is called.

       SCDS_HASP_ONLINE_LOCAL

	   Indicates  that  all SUNW.HAStoragePlus resources on which the resource depends are online on the node or zone from which this function
	   is called.

       Note -

	 The preceding status codes have precedence over each other in the order in which  they  appear.  For  example,  if  a	SUNW.HAStoragePlus
	 resource  is  not  online  and  another  SUNW.HAStoragePlus  resource	is  online  on a different node or zone, the status code is set to
	 SCDS_HASP_NOT_ONLINE rather than SCDS_HASP_ONLINE_NOT_LOCAL.

       The scds_hasp_check() function ignores all SUNW.HAStoragePlus resources for which the FilesystemMountPoints or Zpools property is set to an
       empty list, the default.

PARAMETERS

       The following parameters are supported:

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

       hasp_status	   Status of SUNW.HAStoragePlus resources that are used by the resource.

RETURN VALUES

       SCHA_ERR_NOERR			   The function succeeded.

					   This value also indicates that the status code that is stored in hasp_status is valid.

       SCHA_ERR_INTERNAL		   The function failed.

					   The value that is stored in hasp_status is undefined.  Ignore this undefined value.

       See the scha_calls(3HA) man page 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

       scds_initialize(3HA), scha_calls(3HA), attributes(5), SUNW.HAStoragePlus(5)

Sun Cluster 3.2 						    7 Sep 2007						      scds_hasp_check(3HA)