Interrogation du serveur

Editer en ligne

Avant de commencer une opération de restauration ou de récupération, commencez par interroger le serveur IBM® Storage Protect pour déterminer les objets que vous pouvez recevoir du stockage.

Pour envoyer la requête, l'application doit entrer les listes de paramètres et les structures pour l'appel dsmBeginQuery . La structure doit inclure l'espace fichier qui est examiné par la requête et les entrées correspondant à des modèles pour les zones destinées aux noms de haut niveau et de bas niveau. Si lors de l'initialisation de la session la valeur attribuée au nom du propriétaire était NULL, il n'est pas nécessaire de renseigner la zone Propriétaire. Toutefois, si la session a été initialisée sous un nom de propriétaire explicite, seuls les objets associés à ce nom de propriétaire sont renvoyés.

La requête ponctuelle BackupQuery fournit une image instantanée du système correspondant à un moment précis. Si vous spécifiez une date valide, vous pouvez interroger tous les fichiers sauvegardés à cette date. Même si une version de sauvegarde active de date ultérieure existe pour un objet, la fonction remplace l'état de l'objet de sorte à renvoyer la version inactive précédente de celui-ci. Pour plus d'informations, voir l'exemple suivant: pitDate.

Une requête renvoie toutes les informations stockées avec l'objet, en plus des informations de la table suivante.

Tableau 1. Informations de retour sur la requête au serveur
Zone	Description
`copyId`	Les valeurs `copyIdHi` et `copyIdLo` fournissent un nombre de 8 octets qui identifie de manière unique cet objet pour ce noeud dans le stockage IBM Storage Protect . Utilisez cet ID pour demander un objet spécifique se trouvant dans l'espace de stockage dans le but d'exécuter une opération de restauration ou de récupération.
`restoreOrderExt`	La valeur `restoreOrderExt` fournit un mécanisme permettant de recevoir des objets du stockage IBM Storage Protect de la manière la plus efficace possible. Cette valeur permet de trier les objets à restaurer et donc, de garantir une opération de montage de bandes unique ainsi qu'une lecture intégrale de celles-ci.

Vous devez reporter toutes ou certaines des informations relatives à la requête pour traitement ultérieur. Conservez les zones copyId et restoreOrderExt car elles sont nécessaires pour l'opération de restauration réelle. Vous devez également conserver toute autre information requise pour pouvoir ouvrir un fichier de données ou identifier une destination.

Appelez dsmEndQuery pour terminer l'opération de requête.