Server abfragen

Online bearbeiten

Bevor Sie eine Zurückschreibungs-oder Abrufoperation starten, fragen Sie zuerst den IBM® Storage Protect -Server ab, um festzustellen, welche Objekte Sie aus dem Speicher empfangen können.

Zum Senden der Abfrage muss die Anwendung die Parameterlisten und Strukturen für den Aufruf dsmBeginQuery eingeben. Die Struktur muss den Dateibereich, den die Abfrage prüft, und Musterübereinstimmungseinträge für die Felder für den übergeordneten Namen und den untergeordneten Namen umfassen. Wenn die Sitzung mit dem Wert NULL für den Eignernamen initialisiert wurde, müssen Sie das Feld für den Eigner nicht angeben. Wenn die Sitzung jedoch mit einem expliziten Eignernamen initialisiert wurde, werden nur Objekte zurückgegeben, denen dieser Eignername zugeordnet ist.

Die zeitpunktgesteuerte Abfrage BackupQuery stellt eine Momentaufnahme des Systems zu einem bestimmten Zeitpunkt bereit. Indem Sie ein gültiges Datum angeben, können Sie alle Dateien abfragen, die bis zu diesem Zeitpunkt gesichert wurden. Selbst wenn ein Objekt über eine aktive Sicherung eines späteren Datums verfügt, überschreibt der Zeitpunktwert einen Objektstatus (objState), sodass die vorherige inaktive Kopie zurückgegeben wird. Weitere Informationen finden Sie im folgenden Beispiel: pitDate.

Eine Abfrage gibt alle Informationen zurück, die mit dem Objekt gespeichert sind, sowie die Informationen in der folgenden Tabelle.

Tabelle 1. Zurückgegebene Informationen der Abfrage des Servers
Feld	Beschreibung
`copyId`	Die Werte für `copyIdHi` und `copyIdLo` stellen eine 8 Byte lange Zahl bereit, die dieses Objekt für diesen Knoten im IBM Storage Protect -Speicher eindeutig identifiziert. Fordern Sie mithilfe dieser ID ein bestimmtes Objekt im Speicher für die Zurückschreibungs- oder Abrufverarbeitung an.
`restoreOrderExt`	Der Wert `restoreOrderExt` stellt einen Mechanismus zum Empfangen von Objekten aus IBM Storage Protect -Speicher auf möglichst effiziente Weise bereit. Sortieren Sie die Objekte für die Zurückschreibung anhand dieses Werts, um sicherzustellen, dass Bänder nur einmal geladen und von vorne nach hinten gelesen werden.

Sie müssen einen Teil oder alle Abfrageinformationen für die spätere Verarbeitung aufbewahren. Sie müssen die Felder copyId und restoreOrderExt aufbewahren, da sie für die eigentliche Zurückschreibungsoperation benötigt werden. Sie müssen auch alle anderen Informationen aufbewahren, die erforderlich sind, um eine Datendatei zu öffnen oder ein Ziel zu identifizieren.

Rufen Sie dsmEndQuery auf, um die Abfrageoperation zu beenden.