scha_resource_setstatus

- set resource status functions

Synopsis

cc [flags…] -I /usr/cluster/include file -L /usr/cluster/lib -l scha
#include <scha.h>

scha_err_t scha_resource_setstatus(const char *rname, const char *rgname,
     scha_rsstatus_t status, const char *status_msg);

Description

The scha_resource_setstatus() functions set the Status and Status_msg properties of a resource that is managed by the Resource Group Manager (RGM). A resource's monitor uses these functions 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 resource group that contains the resource.

The status argument 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. The status-msg argument can be NULL.

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

Return Values

The scha_resource_setstatus() functions return the following values:

0

The function succeeded.

nonzero

The function failed.

Errors

SCHA_ERR_NOERR

The function succeeded.

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

Files

/usr/cluster/include/scha.h

Include file

/usr/cluster/lib/libscha.so

Library

Attributes

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

See Also

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