Fonctions polyvalentes

Les fonctions de cette section fournissent un large éventail de possibilités. Elles vous permettent d'effectuer les opérations suivantes :

• initialiser l'environnement DSDL ;

• récupérer les noms des ressources, des types et des groupes de ressources, ainsi que les valeurs des propriétés d'extension

• basculer et redémarrer un groupe de ressources, et redémarrer une ressource

• convertir des chaînes d'erreur en message d'erreur ;

• exécuter une commande sans dépasser le délai d'attente.

Fonctions d'initialisation

Les fonctions ci-dessous permettent d'initialiser la méthode d'appel :

• scds_initialize(3HA): affecte des ressources et initialise l'environnement DSDL.

• scds_close(3HA) : libère les ressources affectées par la fonction scds_initialize().

Fonctions de récupération

Les fonctions suivantes récupèrent les informations concernant les types de ressources, les ressources, les groupes de ressources et les propriétés d'extension :

• scds_get_resource_type_name(3HA) : récupère le nom du type de ressource pour le programme d'appel.

• scds_get_resource_name(3HA) : récupère le nom de la ressource pour le programme d'appel.

• scds_get_resource_group_name(3HA) : récupère le nom du groupe de ressources pour le programme d'appel.

• scds_get_ext_property(3HA) : récupère la valeur de la propriété d'extension spécifiée.

• scds_free_ext_property(3HA) : libère la mémoire allouée par la fonction scds_get_ext_property().

La fonction suivante permet de récupérer les informations relatives à l'état des ressources SUNW.HAStoragePlus utilisées par une ressource :

scds_hasp_check(3HA) : récupère les informations relatives à l'état des ressources SUNW.HAStoragePlus utilisées par une ressource. Vous obtiendrez cette information à partir de l'état (en ligne ou autre) de toutes les ressources SUNW.HAStoragePlus dont la ressource dépend, au moyen des propriétés système Resource_dependencies ou Resource_dependencies_weak définies pour cette ressource. Pour plus d'informations, consultez les pages de manuel SUNW.HAStoragePlus(5).

Fonctions de basculement et de redémarrage

Les fonctions suivantes permettent de basculer ou de redémarrer une ressource ou un groupe de ressources :

• scds_failover_rg(3HA) : bascule un groupe de ressources.

• scds_restart_rg(3HA) : redémarre un groupe de ressources.

• scds_restart_resource(3HA) : redémarre une ressource.

Fonctions d'exécution

Les deux fonctions suivantes exécutent une commande dans un délai imparti et convertissent un code d'erreur en message d'erreur :

• scds_timerun(3HA) : exécute une commande dans un délai d'attente imparti.

• scds_error_string(3HA) : convertit un code d'erreur en chaîne de caractères constituant un message d'erreur.