QUERY MEDIA (query del supporto del pool di archiviazione ad accesso sequenziale)

Classe di privilegi

Qualsiasi amministratore con privilegi di operatore o sistema può immettere questo comando a meno che non presenti il parametro CMD. Se viene specificato il parametro CMD e l'opzione server REQSYSAUTHOUTFILE è impostata su NO, è necessario che l'amministratore disponga del privilegio di sistema, operatore o memoria senza limitazioni. Se viene specificato il parametro CMD e l'opzione server REQSYSAUTHOUTFILE è impostata su YES (l'impostazione predefinita), è necessario che l'amministratore disponga del privilegio di sistema.

Il comando QUERY MEDIA visualizza solo i volumi con un valore ACCESS MODE di READONLY o READWRITE.

Parametri

nome_volume

Specifica il nome del volume di pool di archiviazione di copia o principale ad accesso sequenziale da visualizzare. Questo parametro è facoltativo. È possibile utilizzare un carattere jolly per specificare questo name. Tutti i volumi corrispondenti vengono presi in considerazione per l'elaborazione. Se non si specifica questo parametro, vengono visualizzati tutti i volumi definiti nel pool di archiviazione specificato con il parametro STGPOOL.

STGpool (Obbligatorio)

Specifica il nome del pool di archiviazione di copia o principale ad accesso sequenziale utilizzato per selezionare i volumi per l'elaborazione. È possibile utilizzare caratteri jolly per specificare il nome. Vengono elaborati tutti i pool di archiviazione corrispondenti. Se un pool di archiviazione specificato non è gestito da una libreria automatizzata, non viene visualizzato alcun volume.

Days

Specifica il numero di giorni che deve trascorrere dopo che si è scritto sul volume o che lo si è letto e prima che il volume sia selezionabile per l'elaborazione. Questo parametro è facoltativo. È possibile specificare un valore compreso tra 0 e 9999. Il valore predefinito è 0. La data più recente dell'ultima scrittura o dell'ultima lettura del volume viene utilizzata per calcolare il numero di giorni trascorsi.

WHERESTATUs

Specifica che l'output della query deve essere limitato dallo stato del volume. Questo parametro è facoltativo. È possibile specificare più di uno stato in un elenco delimitando ogni stato con una virgola e senza lasciare alcuno spazio vuoto. Se non si specifica un valore per questo parametro, verranno visualizzati tutti i volumi contenuti nel pool di archiviazione specificato indipendentemente dal loro stato.

I valori possibili sono:

FULl

Specifica che vengono visualizzati i volumi con stato FULL.

FILling

Specifica che vengono visualizzati i volumi con stato FILLING.

EMPty

Specifica che vengono visualizzati i volumi con stato EMPTY.

WHEREACCess

Specifica che l'output deve essere limitato dal modo di accesso al volume. Questo parametro è facoltativo. Se non si specifica un valore per questo parametro, l'output non è limitato dal modo di accesso.

I valori possibili sono:

READWrite

Specifica che vengono visualizzati i volumi con modo di accesso READWRITE.

READOnly

Specifica che vengono visualizzati i volumi con modo di accesso READONLY.

Format

Specifica il modo in cui vengono visualizzate le informazioni. Questo parametro è facoltativo. Il valore predefinito è STANDARD. I valori possibili sono:

Standard

Specifica che vengono visualizzate informazioni parziali per i volumi dei pool di archiviazione ad accesso sequenziale specificati.

Detailed

Specifica che vengono visualizzate informazioni complete per i volumi dei pool di archiviazione ad accesso sequenziale specificati.

Cmd

Specifica che i comandi eseguibili vengono creati per i volumi dei pool di archiviazione elaborati dal comando QUERY MEDIA. Tali comandi si troveranno nel file specificato con il parametro CMDFILENAME nel comando QUERY MEDIA. Se si desidera che i comandi vengano visualizzati soltanto sulla console, specificare una stringa nulla ("") per CMDFILENAME. Se viene specificato FORMAT = CMD ma non viene specificata alcuna stringa di comando con il parametro CMD, il comando QUERY MEDIA avrà esito negativo.

WHEREState

Specifica lo stato dei volumi da elaborare. Questo parametro viene utilizzato per limitare l'elaborazione ai volumi che sono correntemente nello stato specificato. Questo parametro è facoltativo. Il valore predefinito è ALL. I valori possibili sono:

All

Specifica che vengono interrogati i volumi in tutti gli stati. Gli stati validi sono: MOUNTABLEINLIB e MOUNTABLENOTINLIB.

MOUNTABLEInlib

Specifica che vengono interrogati i volumi che sono correntemente nello stato MOUNTABLEINLIB. I volumi nello stato MOUNTABLEINLIB sono nella libreria ma onsite, contengono dati validi e sono accessibili per l'elaborazione onsite.

MOUNTABLENotinlib

Specifica che vengono interrogati i volumi che sono correntemente nello stato MOUNTABLENOTINLIB. I volumi nello stato MOUNTABLENOTINLIB non sono nella libreria, non contengono dati validi e non sono accessibili per l'elaborazione locale.

WHEREOVFLOcation

Specifica l'ubicazione di eccedenza dei volumi da visualizzare. Questo parametro è facoltativo. Questo parametro viene utilizzato per limitare l'elaborazione ai volumi che risiedono nell'ubicazione specificata. La lunghezza massima dell'ubicazione è 255 caratteri. L'ubicazione deve essere racchiusa tra virgolette se contiene spazi vuoti.

CMd

Specifica la creazione di comandi eseguibili. Racchiudere la specifica di comando tra virgolette. La lunghezza massima della specifica di comando è 255 caratteri. Questo parametro è facoltativo.

Per ciascun volume elaborato correttamente dal comando QUERY MEDIA, il server scrive i comandi associati in un file. Specificare il nome file con il parametro CMDFILENAME.

Se non si specifica un nome file, il comando genera un nome file predefinito accodando la stringa exec.cmds.media alla directory del server.

Se non si specifica un nome file, il comando genererà un nome file predefinito accodando la stringa exec.cmd.media alla directory del server.

Nota:

1. Se il comando scritto sul file supera i 255 caratteri, viene suddiviso su più righe e un carattere di continuazione (+) viene aggiunto su tutte le righe ad esclusione dell'ultima riga. Può essere necessario modificare il carattere di continuazione in base ai requisiti del prodotto che esegue i comandi.
2. Se un comando eseguibile viene specificato con un qualsiasi valore per FORMAT diverso da CMD, la stringa del comando viene ignorata e il comando QUERY MEDIA non scriverà alcuna riga comandi.

Specificare una stringa di comandi e qualsiasi variabile di sostituzione:

stringa

Specifica la stringa che crea un comando eseguibile per elaborare il nome, l'ubicazione del volume o entrambi. È possibile specificare un qualsiasi testo in formato libero per la stringa. Non includere apici. Ad esempio, la seguente è una specifica di comando eseguibile valida:

cmd="checkin libvolume &vol"

La seguente è una specifica di comando eseguibile non valida:

cmd="checkin libvolume "&vol"" 

sostituzione

Specifica una variabile per cui si desidera che il comando QUERY MEDIA sostituisca un valore. Le variabili di sostituzione possibili sono:

&VOL

Sostituire il nome del volume per &VOL. È possibile specificare caratteri minuscoli, & vol. Non sono consentiti spazi o spazi tra la e commerciale & e VOL. Se esistono spazi tra la e commerciale e VOL, il comando QUERY MEDIA li tratterà come stringhe e non verrà impostata alcuna sostituzione. Se non viene specificato &VOL, non viene impostato alcun nome volume nel comando eseguibile.

&LOC

Sostituire l'ubicazione del volume per &LOC. È possibile specificare caratteri minuscoli, &loc. Non è consentito alcuno spazio tra la e commerciale & e LOC. Se esistono spazi tra la e commerciale e LOC, il comando QUERY MEDIA li considererà come stringhe e non verrà impostata alcuna sostituzione. Se non si specifica &LOC, non viene impostato alcun nome ubicazione nel comando eseguibile.

&VOLDSN

Sostituire il nome file del volume per &VOLDSN. Un esempio di nome di un file di volume a nastro del pool di archiviazione di copia che utilizza il prefisso definito IBM Storage Protect310 è IBM Storage Protect310.BFS. Se &VOLDSN non è specificato, non viene impostato alcun nome file di volume nel comando eseguibile.

&NL

Sostituire un carattere di riga nuova riga per &NL. Quando si specifica & NL, il comando QUERY MEDIA suddividerà il comando nella posizione in cui si trova & NL e non aggiungerà alcun carattere di continuazione. L'utente è responsabile per la specifica del carattere di continuazione corretto che precede &NL, se ne è richiesto uno. L'utente è altresì responsabile per la lunghezza della riga scritta. Se &NL non è stato specificato e il comando supera i 255 caratteri, il comando viene suddiviso su più righe e un carattere di continuazione (+) viene aggiunto su tutte le righe ad esclusione dell'ultima.

CMDFilename

Specifica il nome percorso per intero che conterrà i comandi specificati con CMD quando viene specificato FORMAT=CMD. Questo parametro è facoltativo. La lunghezza massima del nome file è 1279 caratteri.

Se si specifica "" con il parametro CMDFILENAME, il comando QUERY MEDIA genererà un nome file accodando "exec.cmds.media" alla directory del server. La directory del server è la directory di lavoro corrente del processo del server.

Se si specifica "" con il parametro CMDFILENAME, il comando QUERY MEDIA genererà un nome file accodando "exec.cmd.media" alla directory del server. La directory del server è la directory di lavoro corrente del processo del server.

Se si specifica una stringa nulla ("") per CMDFILENAME, i comandi creati vengono visualizzati solo sulla console. È possibile reindirizzare i comandi visualizzati su un file utilizzando i caratteri di reindirizzamento per il sistema operativo (> o >>).

Se il nome file non è specificato, il comando genererà un nome file predefinito aggiungendo la stringa "exec.cmds.media" alla directory del server.

Se non viene specificato il nome file, il comando genererà un nome file predefinito accodando la stringa "exec.cmd.media" alla directory del server.

Il comando QUERY MEDIA assegna automaticamente il nome file specificato o generato. Se il nome file esiste, il comando QUERY MEDIA tenterà di utilizzarlo e gli eventuali dati esistenti nel file verranno sovrascritti. È possibile specificare APPEND=YES per impedire che i dati esistenti vengano sovrascritti. Se il comando QUERY MEDIA ha esito negativo dopo l'assegnazione del file di comandi, il file non viene eliminato.

APPend

Specifica di scrivere all'inizio ed alla fine dei dati di un file di comandi. Questo parametro è facoltativo. Il valore predefinito è NO. I valori possibili sono:

No

Specifica di scrivere i dati dall'inizio del file di comandi. Se il file di comandi specificato esiste, il suo contenuto viene sovrascritto.

Yes

Specifica di accodare il file di comandi scrivendo alla fine dei dati del file di comandi.

Descrizioni del campo

Nome volume

Specifica il nome del volume di pool di archiviazione principale ad accesso sequenziale.

Stato

Specifica lo stato del volume.

Stato volume

Specifica lo stato del volume.

Accesso

Specifica il modo di accesso del volume.

Data ultimo riferimento

Specifica la data dell'ultima operazione di lettura o scrittura sul volume; viene visualizzata quella più recente.

Data/Ora ultimo aggiornamento

Specifica la data e l'ora dell'ultima volta che è stato aggiornato un volume.

Ubicazione

Specifica dove viene archiviato il volume. Se il volume viene espulso dalla libreria e la sua ubicazione non è specificata o definita, viene visualizzato un punto interrogativo (?) per l'ubicazione.

Nome pool di archiviazione

Specifica il nome del pool di archiviazione ad accesso sequenziale in cui viene definito il volume.

LibName automatica

Specifica il nome della libreria automatizzata se il volume risiede nella libreria.

Comandi correlati

Tabella 1. Comandi correlati a QUERY MEDIA

Comando	Descrizione
MOVE MEDIA	Sposta i volumi del pool di archiviazione gestiti da una libreria automatizzata.