The scha_resource_setstatus() function sets the Status and Status_msg property of a resource that is managed by the Resource Group Manager (RGM) cluster facility. It is intended to be used by the resource's monitor to indicate the resource's state as perceived by the monitor.

The rname argument names the resource whose status is to be set.

The rgname argument is the name of the group containing the resource.

The status is an enum value of type scha_rsstatus_t: SCHA_RSSTATUS_OK, SCHA_RSSTATUS_OFFLINE, SCHA_RSSTATUS_FAULTED, SCHA_RSSTATUS_DEGRADED or SCHA_RSSTATUS_UNKNOWN.

The status_msg argument is the new value for the Status_msg property and may be NULL.

A successful call to scha_resource_setstatus() causes the Status and Status_msg properties of the resource to be updated to the supplied values. The update of the resource status is logged in the cluster system log and is visible to cluster administration tools.

The scha_resosurce_setstatus() function returns the following:

0

The function succeeded.

non-zero

The function failed.

SCHA_ERR_NOERR

Function succeeded.

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

/usr/cluster/include/scha.h

include file

/usr/cluster/lib/libscha.so

library

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

scha_resource_setstatus(1HA), scha_calls(3HA), scha_strerror(3HA), attributes(5)