RSiGetClusterData或RSiGetClusterDatax子程序

用途

请求 xmtopas 命令发送集群聚集数据。

RSI 库 (libSpmi.a)

语法

#include sys/Rsi.h
int RSiGetClusterData(rsh, cluster_stats, node_stats);
RsiHandle rsh;
Cluster_Stats **cluster_stats;
Node_Stats **node_stats;
int RSiGetClusterDatax (rshx, cluster_stats, node_stats);
RsiHandlex rshx;
Cluster_Stats **cluster_stats;
Node_Stats **node_stats;

描述

RSiGetClusterData或RSiGetClusterDatax子程序会返回群集的汇总统计数据,也会返回受监控群集单个节点的统计数据。 此例程为集群和节点统计信息数据结构分配内存。 在 Cluster_Stats 结构中提供了各个节点的计数。 如果出现错误,子程序将返回-1。

参数

rsh
必须指向先前由 RSiOpen (RSiOpen 或 RSiOpenx 子例程) 子例程初始化的有效 RSiHandle 句柄。
雷什克斯
必须指向先前由 RSiOpenx 子例程初始化的有效 RSiHandlex 句柄。
cluster_stats
必须是一个指向类型为 struct Cluster_Stats的结构的指针。
node_stats
必须是一个指向类型为 结构节点统计信息的结构的指针。

返回值

如果成功,子例程将返回 0。

如果发生错误,子程序将返回-1并将错误文本放入RSiEMsg外部字符数组中。

错误代码

所有远程统计信息接口 (RSI) 子例程都使用外部变量来提供错误信息。 为了访问这些变量,应用程序必须定义下列外部变量:
  • extern char RSiEMsg[];
  • extern int RSiErrno;
如果子例程未返回错误,那么 RSiErrno 变量将设置为 RSiOkay ,并且 RSiEMsg 字符数组为空。 如果检测到错误,RSiErrno变量将根据枚举RSiErrorType定义返回一个错误代码。

文件

/usr/include/sys/Rsi.h 声明应用程序可用于访问 RSI 的子例程,数据结构,句柄和宏。