Fonctions des ressources

Ces fonctions accèdent aux informations relatives à une ressource gérée par le RGM ou indiquent l'état de celle-ci tel qu'il est perçu par le détecteur.

scha_resource_open(), scha_resource_get () et scha_resource_close()

Ensemble, ces fonctions accèdent à des informations sur une ressource gérée par le RGM. La fonction scha_resource_open() initialise l'accès à une ressource et renvoie un identificateur pour scha_resource_get (), lequel accède aux informations de la ressource. La fonction scha_resource_close () invalide l'identificateur et libère la mémoire allouée aux valeurs de retour scha_resource_get().

Une ressource peut changer, à la suite d'une reconfiguration du cluster ou d'une action de l'administrateur, après que la fonction scha_resource_open() a renvoyé l'identificateur de la ressource, auquel cas les informations obtenues par scha_resource_get() par le biais de celui-ci risquent d'être erronées. Dans le cas d'une reconfiguration du cluster ou d'une action de l'administrateur sur une ressource, le RGM renvoie le code d'erreur scha_err_seqid à scha_resource_get() pour indiquer qu'il est possible que les informations concernant la ressource aient changé. Il s'agit d'un message d'erreur non fatale. La fonction renvoie une réussite. Vous pouvez choisir d'ignorer le message et d'accepter l'information renvoyée ou de fermer l'identificateur actuel et d'en ouvrir un nouveau pour accéder aux informations relatives à la ressource.

Ces trois fonctions sont décrites par une même page du manuel. Vous pouvez accéder à cette page par le biais des fonctions scha_resource_open(3HA), scha_resource_get(3HA) ou scha_resource_close(3HA).

scha_resource_setstatus()

Définit les propriétés Statut et msg_statut d'une ressource sous le contrôle du RGM. Le détecteur de la ressource utilise cette fonction pour indiquer l'état de celle-ci.

---

Remarque :

bien que scha_resource_setstatus() soit d'un intérêt particulier pour les détecteurs de ressources, tout programme peut l'appeler.

---