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

Resource Type implementations can use scds_hasp_check() in VALIDATE and MONITOR_CHECK method callback implementation to ascertain whether checks specific to any filesystems that are managed by SUNW.HAStoragePlus resources, should be carried out or not.

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

SCDS_HASP_NO_RESOURCE

This indicates there is no SUNW.HAStoragePlus resource that this resource depends on.

SCDS_HASP_ERR_CONFIG

Indicates that at least one of the SUNW.HAStoragePlus resource is in a different resource group then the current resource.

SCDS_HASP_NOT_ONLINE

This indicates there is at least one SUNW.HAStoragePlus resource, that this resource depends on, which is not online on any potential primary node for this resource.

SCDS_HASP_ONLINE_NOT_LOCAL

This indicates there is at least one SUNW.HAStoragePlus resource that this resource depends on, that is online on a different cluster node, that is, it. is not online on the cluster node where this function call is made.

SCDS_HASP_ONLINE_LOCAL

This indicates that all SUNW.HAStoragePlus resources that this resource depends on are online on the node which called scds_hasp_check().

These status codes have precedence over each other in the order in which they have been listed above. For example, if there is an SUNW.HAStoragePlus resource not online and another SUNW.HAStoragePlus resource online on a different node, the status code will be set to SCDS_HASP_NOT_ONLINE rather than SCDS_HASP_ONLINE_NOT_LOCAL.

All SUNW.HAStoragePlus resources who have their extension property FilesystemMountPoints set to empty, are ignored by scds_hasp_check().

The following parameters are supported:

handle

The handle returned from scds_initialize(3HA)

hasp_status

Status of SUNW.HAStoragePlus resources used by the resource

The scds_hasp_check() function returns the following:

0

The function succeeded

non-zero

The function failed

SCHA_ERR_NOERR

Indicates the function succeeded and the status code stored in hasp_status is valid

SCHA_ERR_INTERNAL

Indicates the function failed. Value stored in hasp_status is undefined and should be ignored.

See scha_calls(3HA) for a description of other error codes.

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

Include file

/usr/cluster/lib/libdsdev.so

Library

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

scds_initialize(3HA), attributes(5)