RSiStopFeed或RSiStopFeedx子程序

用途

指示 Xmservd 停止为统计信息集发送数据订阅源。

库

RSI 库 (libSpmi.a)

语法

#include sys/Rsi.h

int RSiStopFeed(rhandle, statset, erase)
RSiHandle rhandle;
struct SpmiStatSet *statset;
boolean erase;

int RSiStopFeedx (rhandlex, statset, erase)
RSiHandlex rhandlex;
struct SpmiStatSet *statset;
boolean erase;

描述

RSiStopFeed或RSiStopFeedx子程序指示远程系统的xmservd：

1. 停止发送给定 SpmiStatSet的 data_feed 包。 如果守护进程未被告知擦除SpmiStatSet，则可通过发出SpmiStatSet 的RSiStartFeed或RSiStartFeedx子程序调用来恢复数据馈送。
2. 可选择告诉守护进程和 API 库子程序清除它们关于SpmiStatSet所有信息。 对已清除SpmiStatSet的后续引用无效。

该子程序是AIX性能工具箱许可产品的一部分。

参数

处理

必须指向先前由 RSiOpen 子例程初始化的有效 RSiHandle 句柄。

汉德莱克斯

必须指向先前由 RSiOpenx 子例程初始化的有效 RSiHandlex 句柄。

斯塔特塞

必须是指向 "struct SpmiStatSet类型结构的指针，该结构之前由成功调用 "RSiCreateStatSet或 "RSiCreateStatSetx子程序返回。 Data feeding must have started for this SpmiStatSet via a previous RSiStartFeed或 "RSiStartFeedx subroutine call.

擦除 (erase)

如果该参数设置为 "true"，远程主机上的xmservd守护进程就会丢弃有关命名的SpmiStatSet 的所有信息。 否则，守护程序将维护其统计信息集的定义。

返回值

如果成功，子程序返回 0，否则返回-1。 无论子程序成功或失败，都会在外部字符数组RSiEMsg中放置一个 NULL 错误文本。

错误代码

所有远程统计信息接口 (RSI) 子例程都使用外部变量来提供错误信息。 为了访问这些变量，应用程序必须定义下列外部变量:

• extern charRSiEMsg[]；
• extern intRSiErrno;

如果子例程未返回错误，那么 RSiErrno 变量将设置为 RSiOkay ，并且 RSiEMsg 字符数组为空。 如果检测到错误，RSiErrno变量将根据枚举RSiErrorType定义返回一个错误代码。

文件