Funktionen für einen allgemeinen Zweck

Die Funktionen in diesem Abschnitt bieten eine breite Palette an Möglichkeiten. Diese Funktionen ermöglichen Ihnen das Ausführen der folgenden Vorgänge:

• Die DSDL-Umgebung initialisieren,

• Ressourcentyp, Ressource und Ressourcengruppennamen sowie Erweiterungseigenschaftswerte abrufen

• Failover und Neustart einer Ressourcengruppe sowie Neustart einer Ressource

• Fehler-Zeichenketten in Fehlermeldungen konvertieren,

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

Initialisierungsfunktionen

Die folgenden Funktionen initialisieren die Aufrufmethode:

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

• scds_close(3HA) – Setzt Ressourcen frei, die von scds_initialize() zugewiesen werden.

Abruffunktionen

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

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

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

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

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

• scds_free_ext_property(3HA) – Setzt den von scds_get_ext_property() zugewiesenen Speicher frei.

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

scds_hasp_check(3HA) – Ruft Statusinformationen über die SUNW.HAStoragePlus-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. Weitere Informationen finden Sie in der Online-Dokumentation zu SUNW.HAStoragePlus(5).

Failover- und Neustart-Funktionen

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

• scds_failover_rg(3HA) – Failover einer Ressourcengruppe.

• scds_restart_rg(3HA) – Neustart einer Ressourcengruppe.

• scds_restart_resource(3HA) – Neustart einer Ressource.

Ausführungsfunktionen

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.