Query del sistema IBM® Storage Protect

L'API ha diverse query, come la query della classe di gestione, che possono essere utilizzate dalle applicazioni.

Tutte le query che utilizzano la chiamata dsmBeginQuery seguono queste istruzioni:

1. Inviare la chiamata dsmBeginQuery con il tipo di query appropriato:
   • Backup
   • Archivio
   • Oggetti di backup attivi
   • Spazio file
   • Classe di gestione

   La chiamata dsmBeginQuery informa l'API del formato dati restituito dal server. I campi appropriati possono essere inseriti nelle strutture dati che vengono passate dalle chiamate dsmGetNextQObj . La chiamata di inizio query consente inoltre al client delle applicazioni di impostare l'ambito della query specificando correttamente i parametri sulla chiamata di inizio query.

   Limitazione: su sistemi UNIX o Linux® , solo l'utente root può eseguire la query di oggetti di cui è stato eseguito il backup. Questo tipo di query è noto come "percorso rapido".
2. Immettere la chiamata dsmGetNextQObj per ottenere ciascun record dalla query. Questa chiamata passa un buffer abbastanza grande da contenere i dati restituiti dalla query. Ogni tipo di query ha una struttura dati corrispondente per i dati restituiti. Ad esempio, un tipo di query di backup ha una struttura qryRespBackupData associata che viene popolata quando viene inviata la chiamata dsmGetNextQObj .
3. La chiamata dsmGetNextQObj di solito restituisce uno dei seguenti codici:
   • DSM_RC_MORE_DATA: inviare nuovamente la chiamata dsmGetNextQObj .
   • DSM_RC_FINISHED: non ci sono più dati. Inviare la chiamata dsmEndQuery .
4. Invia la chiamata dsmEndQuery . Quando vengono richiamati tutti i dati della query o non sono necessari più dati della query, immettere la chiamata dsmEndQuery per terminare il processo della query. L'API elimina i dati rimanenti dal flusso di query e rilascia le risorse utilizzate per la query.

Risultati

La Figura 1 mostra il diagramma di stato per le operazioni di query.

Figura 2 visualizza il diagramma di flusso per operazioni di query.