RSiChangeFeed or RSiChangeFeedx Subroutine

Purpose

Changes the frequency at which the xmservd on the host identified by the first argument daemon is sending data_feed packets for a statset.

Library

RSI Library (libSpmi.a)

Syntax

#include sys/Rsi.h

int RSiChangeFeed(rhandle, statset, msecs)
RSiHandle rhandle;struct SpmiStatSet *statset;int msecs;

int RSiChangeFeedx(rhandlex, statset, msecs)
RSiHandlex rhandlex;struct SpmiStatSet *statset;int msecs;

Parameters

rhandle

Must point to a valid RSiHandle handle, which was previously initialized by the RSiOpen subroutine.

rhandlex

Must be an RSiHandlex handle, which was previously initialized by the RSiOpenx subroutine.

statset

Must be a pointer to a SpmiStatSet structure of type struct , which was previously returned by a successful RSiCreateStatSet or RSiCreateStatSetx subroutine call. Data feeding must have started for this SpmiStatSet structure through a previous RSiStartFeed or RSiStartFeedx subroutine call.

msecs

The number of milliseconds between the sending of Hot_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.

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

Return Values

If successful, the subroutine returns zero, otherwise -1. A NULL error text is placed in the external character array RSiEMsg regardless of the subroutine's success or failure.

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:

• extern char RSiEMsg[];
• extern int RSiErrno;

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