Ressourcenfunktionen

Mit diesen Funktionen rufen Sie Informationen über eine von RGM gesteuerte Ressource auf oder geben den Zustand der Ressource aus Monitorsicht an.

scha_resource_open(), scha_resource_get () und scha_resource_close()

Diese Funktionen rufen Informationen über eine vom RGM verwaltete Ressource auf. Die scha_resource_open()-Funktion initialisiert den Zugriff auf eine Ressource und gibt einen Handle für scha_resource_get() für den Zugriff auf die Ressourceninformationen zurück. Die scha_resource_close()-Funktion macht den Handle ungültig und setzt Speicher frei, der für die scha_resource_get ()-Rückgabewerte zugewiesen wurde.

Eine Ressource kann sich ändern, entweder über eine Cluster-Neukonfiguration oder Verwaltungsaktion, nachdem scha_resource_open() den Ressourcen-Handle zurückgibt. Folglich können die Informationen, die scha_resource_get() über den Handle erhält, ungenau sein. Im Falle einer Cluster-Neukonfiguration oder im Falle von Verwaltungsaktionen für eine Ressource gibt RGM den scha_err_seqid-Fehlercode an scha_resource_get() aus, um anzugeben, dass die Informationen über die Ressource eventuell geändert wurden. Diese Fehlermeldung meldet keinen schwerwiegenden Fehler. Die Funktion gibt Erfolg zurück. Sie können die Meldung ignorieren und die zurückgegebenen Informationen annehmen. Als Alternative können Sie den aktuellen Handle schließen und einen neuen Handle für den Zugriff auf Informationen über die Ressource öffnen.

Diese drei Funktionen werden auf einer Online-Dokumentationsseite beschrieben. Sie können diese Online-Dokumentationsseite mit den Funktionen scha_resource_open(3HA), scha_resource_get(3HA) und scha_resource_close(3HA) aufrufen.

scha_resource_setstatus()

Legt die Eigenschaften Status und Status_msg einer von RGM gesteuerten Ressource fest. Der Ressourcen-Monitor verwendet diese Funktion, um den Ressourcenzustand anzugeben.

---

Hinweis –

scha_resource_setstatus()ist zwar für einen Ressourcen-Monitor besonders nützlich, kann jedoch von jedem beliebigen Programm aufgerufen werden.

---