Funktionen für allgemeine Zwecke

Die Funktionen in diesem Abschnitt decken einen großen Funktionsumfang ab. Diese Funktionen ermöglichen Ihnen das Ausführen der folgenden Vorgänge:

• Die DSDL-Umgebung initialisieren,

• Ressourcen, Ressourcentypen und Ressourcengruppennamen sowie Erweiterungseigenschaftswerte abrufen,

• Ein Failover für eine Ressourcengruppe ausführen und sie neu starten sowie eine Ressource neu starten,

• Fehler-Zeichenketten in Fehlermeldungen konvertieren,

• Einen Befehl im Rahmen einer Zeitüberschreitung ausführen.

Die folgenden Funktionen initialisieren die Aufrufmethode:

• scds_initialize(3HA) – ordnet Ressourcen zu und initialisiert die DSDL-Umgebung.

• scds_close( 3HA) – gibt Ressourcen frei, die von scds_initialize zugeordnet wurden.

Die folgenden Funktionen rufen Informationen über Ressourcen, Ressourcentypen, Ressourcengruppen und Erweiterungseigenschaften ab.

• scds_get_resource_name(3HA) – ruft den Namen der Ressource für das aufrufende Programm ab.

• scds_get_resource_type_name(3HA) – ruft den Namen des Ressourcentyps für das aufrufende Programm ab.

• scds_get_resource_group_name(3HA) – ruft den Namen der Ressourcengruppe für das aufrufende Programm ab.

• scds_get_ext_property(3HA) – ruft den Wert der angegebenen Erweiterungseigenschaft ab.

• scds_free_ext_property(3HA) – gibt den durch scds_get_ext_property zugeordneten Speicher frei.

Die folgende Funktion ruft Statusinformationen über die SUNW.HAStoragePlus ab, die von einer Ressource verwendet werden.

• scds_hasp_check(3HA) – ruft Statusinformationen zu SUNW.HAStoragePlus(5)-Ressourcen ab, die von einer Ressource verwendet werden. Diese Informationen werden aus dem Zustand (online oder anderweitig) aller SUNW.HAStoragePlus-Ressourcen abgerufen, von denen die Ressource abhängt, und zwar unter Verwendung der für die Ressource definierten Systemeigenschaften Resource_dependencies oder Resource_dependencies_weak.

Die folgenden Funktionen führen ein Failover aus bzw. starten eine Ressource oder Ressourcengruppe neu.

• scds_failover_rg(3HA) – führt ein Failover für eine Ressourcengruppe aus.

• scds_restart_rg(3HA) – startet eine Ressourcengruppe neu.

• scds_restart_resource(3HA) – startet eine Ressource neu.

Die folgenden Funktionen führen einen Befehl im Rahmen einer Zeitüberschreitung aus und konvertieren einen Fehlercode in eine Fehlermeldung:

• scds_timerun( 3HA) – führt einen Befehl unter einem Zeitüberschreitungswert aus.

• scds_error_string(3HA) – übersetzt einen Fehlercode in eine Fehlerzeichenkette.