Realizar consultas al servidor

Antes de empezar cualquier operación de restauración o recuperación, consulte primero el servidor de IBM® Storage Protect para determinar qué objetos puede recibir del almacenamiento.

Para enviar la consulta, la aplicación debe especificar las listas de parámetros y estructuras para la llamada dsmBeginQuery . La estructura debe incluir el espacio de archivos que la consulta examina y entradas que se ajustan a un patrón en los campos de nombre de alto y bajo rango. Si la sesión se inició con un nombre de propietario NULO, no es necesario especificar el campo del propietario. No obstante, si la sesión se inició con un nombre de propietario explícito, sólo se devuelven los objetos asociados con ese nombre de propietario.

La consulta BackupQuery de punto en el tiempo proporciona una instantánea del sistema en una hora determinada. Al especificar una fecha válida, es posible consultar todos los archivos a los que se les realizó una copia de seguridad a esa hora. Incluso si un objeto tiene una copia de seguridad activa de una fecha posterior, el punto en el tiempo modifica el estado de un objeto con el fin de que se devuelva la copia inactiva anterior. Para obtener más información, consulte el ejemplo siguiente: pitDate.

Una consulta devuelve toda la información que se almacenó con el objeto, además de la información en la tabla siguiente.

Tabla 1. Consultar la información devuelta por el servidor
Campo Descripción
copyId Los valores copyIdHi y copyIdLo proporcionan un número de 8 bytes que identifica de forma exclusiva este objeto para este nodo en el almacenamiento de IBM Storage Protect . Utilice este ID para solicitar un objeto específico del almacenamiento de los procesos de restauración o recuperación.
restoreOrderExt El valor restoreOrderExt proporciona un mecanismo para recibir objetos del almacenamiento de IBM Storage Protect de la forma más eficiente posible. Ordene los objetos para restaurar este valor y asegurarse de que las cintas sólo se montan una vez y se lee de adelante a atrás.

Debe guardar toda o parte de la información de la consulta para los procesos posteriores. No modifique los campos copyId y restoreOrderExt ya que se necesitan en la operación de restauración real. También es necesario conservarla información necesaria para abrir un archivo de datos o identificar un destino.

Llame a dsmEndQuery para finalizar la operación de consulta.