Ressourcenfunktionen

Diese Funktionen greifen auf Informationen über eine von RGM verwaltete Ressource zu bzw. geben den vom Monitor festgestellten Zustand der Ressource an.

scha_resource_open(), scha_resource_get () und scha_resource_close()

Zusammen greifen diese Funktionen auf Informationen über eine von RGM verwaltete Ressource zu. Die scha_resource_open()-Funktion initialisiert den Zugriff auf eine Ressource und gibt ein Handle für scha_resource_get() zurück, womit auf die Ressourceninformationen zugegriffen wird. Die scha_resource_close()-Funktion invalidiert das Handle und gibt den für die Rückgabewerte von scha_resource_get() zugewiesenen Speicherplatz frei.

Eine Ressource kann durch eine Cluster-Rekonfiguration oder einen Verwaltungsbefehl geändert werden, nachdem scha_resource_open() das Handle für die Ressource zurückgegeben hat. In diesem Fall können die von scha_resource_get() über das Handle abgerufenen Informationen falsch sein. Im Fall einer Cluster-Rekonfiguration oder einer Verwaltungsaktion an einer Ressource gibt RGM den Fehlercode scha_err_seqid an scha_resource_get() zurück, um anzugeben, dass sich die Ressourceninformationen geändert haben könnten. Diese Meldung gibt keinen schwerwiegenden Fehler an; die Funktion gibt Erfolg zurück. Sie können die Meldung ignorieren und die zurückgegebenen Informationen akzeptieren, oder das aktuelle Handle schließen und ein neues Handle zum Zugreifen auf Ressurceninformationen öffnen.

Eine gemeinsame Online-Dokumentationsseite beschreibt diese drei Funktionen. Auf diese Seite können Sie über jede der einzelnen Funktionen, scha_resource_open(3HA), scha_resource_get(3HA) oder scha_resource_close(3HA) zugreifen.

scha_resource_setstatus()

Stellt die Status- und Status_msg-Eigenschaften einer Ressource unter RGM-Steuerung ein. 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.

---