RSiGetClusterData ou RSiGetClusterDatax Sous-routine

Editer en ligne

Objectif

Demandez à la commande xmtopas d'envoyer les données d'agrégation du cluster.

Bibliothèque

Bibliothèque RSI (libSpmi.a)

Syntaxe

#include sys/Rsi.h
int RSiGetClusterData(rsh, cluster_stats, node_stats);
RsiHandle rsh;
Cluster_Stats **cluster_stats;
Node_Stats **node_stats;
int RSiGetClusterDatax (rshx, cluster_stats, node_stats);
RsiHandlex rshx;
Cluster_Stats **cluster_stats;
Node_Stats **node_stats;

Descriptif

Le sous-programme RSiGetClusterData ou RSiGetClusterDatax renvoie les statistiques agrégées d'une grappe ainsi que les statistiques des nœuds individuels de la grappe surveillée. Cette routine alloue la mémoire pour les structures de données de statistiques de noeud et de noeud. Le nombre de noeuds individuels est disponible dans la structure Cluster_Stats. En cas d'erreur, le sous-programme renvoie -1.

Paramètres

rsh
Doit pointer vers un descripteur RSiHandle valide, précédemment initialisé par la sous-routine RSiOpen (RSiOpen ou RSiOpenx Subroutine) .
Rshx
Doit pointer vers un descripteur RSiHandlex valide, qui a été précédemment initialisé par la sous-routine RSiOpenx .
Stats cluster_cluster
Doit être un pointeur pour pointer vers une structure de type Struct Cluster_Stats.
Noeud_noeuds
Doit être un pointeur pour pointer vers une structure de type Struct Node_Stats.

Valeurs renvoyées

En cas de réussite, le sous-programme renvoie 0.

En cas d'erreur, le sous-programme renvoie -1 et le texte de l'erreur est placé dans le tableau de caractères externe RSiEMsg.

Codes d'erreur

Toutes les sous-routines RSI (Remote Statistic Interface) utilisent des variables externes pour fournir des informations d'erreur. Pour accéder à ces variables, un programme d'application doit définir les variables externes suivantes:
  • extern char RSiEMsg[];
  • extern int RSiErrno;
Si la sous-routine renvoie une erreur, la variable RSiErrno est définie sur RSiOkay et le tableau de caractères RSiEMsg est vide. Si une erreur est détectée, la variable RSiErrno renvoie un code d'erreur, tel que défini dans l'enum RSiErrorType.

Fichiers

/usr/include/sys/Rsi.h Déclare les sous-routines, les structures de données, les descripteurs et les macros qu'un programme d'application peut utiliser pour accéder à RSI.