Funktionen für allgemeine Zwecke

Die Funktionen in diesem Abschnitt decken einen großen Funktionsumfang ab. Mit diesen Funktionen können Sie Folgendes ausführen:

• 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 – Weist Ressourcen zu und initialisiert die DSDL-Umgebung.

• scds_close – Gibt Ressourcen frei, die durch scds_initialize zugewiesen wurden.

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

• scds_get_resource_name – Ruft den Ressourcennamen für das aufrufende Programm ab.

• scds_get_resource_type_name – Ruft den Ressourcentypnamen für das aufrufende Programm ab.

• scds_get_resource_group_name – Ruft den Ressourcengruppennamen für das aufrufende Programm ab.

• scds_get_ext_property – Ruft den Wert der angegebenen Erweiterungseigenschaft ab.

• scds_free_ext_property – Gibt den durch scds_get_ext_property zugewiesenen Speicherplatz frei.

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

• scds_hasp_check – Ruft Statusinformationen über SUNW.HAStoragePlus-Ressourcen ab, die von einer Ressource verwendet werden. Diese Informationen werden vom Zustand (online oder anderweitig) aller SUNW.HAStoragePlus-Ressourcen, von denen die Ressource abhängt, abgerufen. Dafür werden die Systemeigenschaften Resource_dependencies bzw. Resource_dependencies_weak verwendet, die für die Ressource definiert sind.

  Unter SUNW.HAStoragePlus(5) finden Sie weitere Informationen zu SUNW.HAStoragePlus.

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

• scds_failover_rg – Führt ein Failover für eine Ressourcengruppe aus.

• scds_restart_rg – Startet eine Ressourcengruppe neu.

• scds_restart_resource – Startet eine Ressource neu.

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

• scds_timerun – Führt einen Befehl im Rahmen eines Zeitüberschreitungswertes aus.

• scds_error_string – Überträgt einen Fehlercode in eine Fehler-Zeichenkette.