RSiStartFeed Subroutine

Purpose

Tells xmservd to start sending data feeds for a statset.

Library

RSI Library (libSpmi.a)

Syntax

#include sys/Rsi.h
int RSiStartFeed(rhandle, statset, msecs)
RSiHandle rhandle;
struct SpmiStatSet *statset;
int msecs;

Description

The RSiStartFeed subroutine performs the following function:

  1. Informs xmservd of the frequency with which it is required to send data_feed packets.
  2. Tells the xmservd to start sending data_feed packets.

This subroutine is part of the Performance Toolbox for AIX® licensed product.

Parameters

rhandle
Must point to a valid RSiHandle handle, which was previously initialized by the RSiOpen (RSiOpen Subroutine) subroutine.
statset
Must be a pointer to a structure of type struct SpmiStatSet, which was previously returned by a successful RSiCreateStatSet (RSiCreateStatSet Subroutine) subroutine call.
msecs
The number of milliseconds between the sending of data_feed packets. This number is rounded to a multiple of min_remote_int milliseconds by the xmservd daemon on the remote host. This minimum interval can be modified through the -i command line interval to xmservd.

Return Values

If successful, the subroutine returns zero; otherwise it returns -1 and an error text may be placed in the external character array RSiEMsg.

Error Codes

All Remote Statistic Interface (RSI) subroutines use external variables to provide error information. To access these variables, an application program must define the following external variables:

If the subroutine returns without an error, the RSiErrno variable is set to RSiOkay and the RSiEMsg character array is empty. If an error is detected, the RSiErrno variable returns an error code, as defined in the enum RSiErrorType.

Files

Item Description
/usr/include/sys/Rsi.h Declares the subroutines, data structures, handles, and macros that an application program can use to access the RSI.