RSiGetCECData 或 子程序 RSiGetCECDatax

用途

请求 xmtopas 命令发送中央电子复合体 (CEC) 聚集数据。

RSI 库 (libSpmi.a)

语法

#include sys/Rsi.h
int RSiGetCECData (rsh, cec stats, node_stats);
RsiHandle rsh;
Cec_Stats **cec_stats;
Node_Stats **node_stats;
int RSiGetCECDatax (rshx, cec stats, node_stats);
RsiHandlex rshx;
Cec_Stats **cec_stats;
Node_Stats **node_stats;

描述

RSiGetCECData 或 RSiGetCECDatax 子程序会返回 CEC 的汇总统计数据,也会返回同一 CEC 单个节点的统计数据。 此例程为 CEC 和节点统计信息数据结构分配内存。 在 Cec_Stats 结构中提供了各个节点的计数。 如果出现错误,子程序将返回 -1。

参数

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

返回值

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

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

错误代码

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

文件

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