scha_resource_setstatus_zone (3HA)

名称

scha_resource_setstatus, scha_resource_setstatus_zone - 设置资源状态函数

用法概要

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);

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

描述

scha_resource_setstatus() 和 scha_resource_setstatus_zone() 函数可设置资源组管理器 (Resource Group Manager, RGM) 管理的资源的 Status 和 Status_msg 属性。资源的监视器使用这些函数来指示它所识别的资源状态。

请仅对 Global_zone 属性设置为 TRUE 的资源类型使用 scha_resource_setstatus_zone() 函数。如果 Global_zone 属性设置为 FALSE，则不需要此函数。有关更多信息，请参见 rt_properties(5) 手册页。

rname 参数指定要设置其状态的资源的名称。

rgname 参数是包含该资源的资源组的名称。

zonename 参数是资源组配置为在其中运行的区域群集的名称。如果 Global_zone 属性设置为 TRUE，则即使包含资源的资源组在区域群集中运行，也会在全局区域中执行方法。

status 参数是一个 scha_rsstatus_t 类型的 enum 值：SCHA_RSSTATUS_OK、 SCHA_RSSTATUS_OFFLINE、SCHA_RSSTATUS_FAULTED、 SCHA_RSSTATUS_DEGRADED 或 SCHA_RSSTATUS_UNKNOWN。

status-msg 参数是 Status_msg 属性的新值。status-msg 参数可以是 NULL。

scha_resource_setstatus() 或 scha_resource_setstatus_zone() 函数调用成功会导致使用所提供的值更新资源的 Status 和 Status_msg 属性。资源状态的更新将记录到群集系统日志中，并可通过群集管理工具进行访问。

返回值

scha_resource_setstatus() 和 scha_resource_setstatus_zone() 函数返回以下值：

0

该函数成功。

非零值

该函数失败。

错误

SCHA_ERR_NOERR

该函数成功。

有关其他错误代码的描述，请参见 scha_calls(3HA)。

示例

示例 1 使用 scha_resource_setstatus() 函数

#include <scha.h>

scha_err_t err_code;
const char *rname = "example_R";
const char *rgname = "example_RG";

err_code = scha_resource_setstatus(rname, rgname,
           SCHA_RSSTATUS_OK, "No problems");

文件

/usr/cluster/include/scha.h

头文件

/usr/cluster/lib/libscha.so

库

属性

有关以下属性的描述，请参见 attributes(5)：

属性类型 属性值 可用性 ha-cluster/developer/api 接口稳定性 Evolving（发展中）

另请参见

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