RSiGetCECData or RSiGetCECDatax Subroutine

Purpose

Request that xmtopas command send the central electronics complex (CEC) aggregation data.

Library

RSI library (libSpmi.a)

Syntax

#include sys/Rsi.h
int RSiGetCECData (rsh, cec stats, node_stats);
RsiHandle rsh;
Cec_Stats **cec_stats;
Node_Stats **node_stats;

int RSiGetCECDatax (rshx, cec stats, node_stats);
RsiHandlex rshx;
Cec_Stats **cec_stats;
Node_Stats **node_stats;

Description

The RSiGetCECData or RSiGetCECDatax subroutine returns the Aggregated Statistics for a CEC and also returns the statistics of individual nodes of the same CEC. This routine allocates memory for CEC and node statistics data structures. The count of individual nodes is available in the Cec_Stats structure. If an error, the subroutine returns -1.

Parameters

rsh: Must point to a valid RSiHandle handle, which was previously initialized by the RSiOpen subroutine.
rshx: Must point to a valid RSiHandlex handle, which was previously initialized by the RSiOpenx subroutine.
cec_stats: Must be a pointer to point to a structure of type struct Cec_Stats.
node_stats: Must be a pointer to point to a structure of type struct Node_Stats.

Return Values

If successful, the subroutine returns 0.

If an error occurs, the subroutine returns -1 and error text is placed in the RSiEMsg external character array.

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

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