RSiMainLoop或RSiMainLoopx子程序

用途

允许应用程序暂挂执行,并在数据订阅源到达时等待唤醒。

RSI 库 (libSpmi.a)

语法

#include sys/Rsi.h
void RSiMainLoop(msecs)
int msecs;
void RSiMainLoopx(msecs)
int msecs;

描述

RSiMainLoopRSiMainLoopx子程序执行以下操作:

  1. 允许数据使用者程序在等待 数据订阅源 个包从一个或多个 Xmservd 守护程序到达时暂挂处理。
  2. 告知等待数据订阅源的子例程将控制权返回给数据使用者程序,以便后者可以检查其他事件并对其作出反应。
  3. 调用子例程以处理每个接收到的此类包的 数据订阅源 个包。

要正常工作,RSiMainLoopRSiMainLoopx子程序需要至少一次RSiOpen或RSiOpenx调用成功完成,并且连接没有关闭。

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

参数

姆塞奇
在返回到调用者之前,子例程应该继续尝试接收的最小耗用时间 (以毫秒为单位)。 请注意,您的程序在指定的毫秒数内释放控制权,但在该时间内可以重复调用 RSiOpenRSiOpenx 调用上定义的回调函数。

错误代码

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

  • extern charRSiEMsg[];
  • extern intRSiErrno;

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

文件

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