Returns a pointer to a valid SpmiStatVals structure for a given SpmiStatVals pointer by extraction from a data_feed packet. This subroutine call should only be issued from a callback function after it has been verified that a data_feed packet was received from the host identified by the first argument.
RSI Library (libSpmi.a)
struct SpmiStatVals RSiGetRawValue(rhandle, svp, index) RSiHandle rhandle; struct SpmiStatVals *svp; int *index;
The RSiGetRawValue subroutine performs the following:
rhandleMust be an RSiHandle, which was previously initialized by the RSiOpen (RSiOpen Subroutine) subroutine.
svpA handle of type struct SpmiStatVals, which was previously returned by a successful RSiPathAddSetStat (RSiPathAddSetStat Subroutine) subroutine call.
indexA pointer to an integer variable. When the subroutine call succeeds, the index into the ValsSet array of the data feed packet is returned. The index corresponds to the element that matches the svp argument to the subroutine.
If successful, the subroutine returns a pointer; otherwise NULL is returned and an error text may be placed in the external character array RSiEMsg.
All 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. RSi error codes are described in List of RSi Error Codes .
This subroutine is part of the Performance Toolbox for AIX licensed product.
|/usr/include/sys/Rsi.h||Declares the subroutines, data structures, handles, and macros that an application program can use to access the RSI.|
For related information, see: