Fonctions générales

Les fonctions décrites dans cette rubrique couvrent de nombreuses fonctionnalités Elles vous permettent d'effectuer les opérations suivantes :

• initialiser l'environnement BDSD ;

• récupérer les noms de ressource, type de ressources et groupe de ressources, ainsi que les valeurs de propriété 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.

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

• scds_initialize(3HA) – alloue les ressources et initialise l'environnement BDSD.

• scds_close( 3HA) – libère les ressources allouées par scds_initialize.

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

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

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

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

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

• scds_free_ext_property(3HA) – libère la mémoire allouée par 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(5) utilisées par une ressource. Ces informations sont obtenues à partir de l'état (en ligne ou autre) de toutes les ressources SUNW.HAStoragePlus dont dépend la ressource, à l'aide des propriétés système Resource_dependencies ou Resource_dependencies_weak définies pour cette ressource.

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.

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 imparti.

• scds_error_string(3HA) – convertit un code d'erreur en chaîne d'erreur.