scds_hasp_check(3HA)

NAME | SYNOPSIS | DESCRIPTION | PARAMETERS | RETURN VALUES | FILES | ATTRIBUTES | SEE ALSO

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 information 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  Last Revised 18 Jul 2006

NAME | SYNOPSIS | DESCRIPTION | PARAMETERS | RETURN VALUES | FILES | ATTRIBUTES | SEE ALSO