QUERY VOLUME (Consultar volumes do conjunto de armazenamento)
Use este comando para exibir as informações sobre um ou mais volumes do conjunto de armazenamento.
Classe de privilégio
Qualquer administrador pode emitir este comando.
Sintaxe
Parâmetros
- nome_do_volume
- Especifica o volume a ser consultado. Este parâmetro é opcional. É possível utilizar caracteres curingas para especificar os nomes. Se você não especificar um nome, todos os volumes do conjunto de armazenamento serão incluídos na consulta.
- ACCess
- Especifica que a saída deve ser restrita pelo modo de
acesso ao volume. Este
parâmetro é opcional. É possível especificar vários modos de
acesso, separando os modos por vírgulas e sem espaços em branco. Se você
não especificar um valor para esse parâmetro, a saída não será
restringida pelo modo de acesso. Os valores possíveis são:
- READWrite
- Exibir volumes com um modo de acesso de READWRITE. Os nós do cliente e os processos do servidor podem ser lidos e gravados para os arquivos armazenados nos volumes.
- READOnly
- Exibir volumes com um modo de acesso de READONLY. Os nós clientes e os processos do servidor podem ler somente arquivos armazenados nos volumes.
- UNAVailable
- Exibir volumes com um modo de acesso de UNAVAILABLE. Os nós clientes e os processos do servidor não podem acessar arquivos que estão armazenados nos volumes.
- OFFsite
- Exiba a cópia dos volumes do conjunto de armazenamento com um modo de acesso do OFFSITE. Os volumes que estão localizados no offsite, onde não podem ser montados.
- DEStroyed
- Exiba os volumes de conjunto de armazenamento principal com um modo de acesso DESTROYED. Os volumes são designados como danificados permanentemente.
- STatus
- Especifica que a saída deve ser restrita pelo status do volume. Este
parâmetro é opcional. Você pode especificar vários valores de acesso, separando os
valores com vírgulas e sem espaços em branco. Se você
não especificar um valor para esse parâmetro, a saída não será
restringida pelo status do volume. Os valores possíveis são:
- ONline
- Exibe os volumes de acesso aleatório que estão disponíveis para o servidor.
- OFfline
- Exibe os volumes de acesso aleatório que não estão disponíveis para o servidor.
- EMPty
- Exibe os volumes de acesso em ordem que não possuem dados.
- PENding
- Exibir volumes com um status de PENDING. Esses volumes podem ser volumes de acesso sequencial a partir dos quais todos os arquivos são excluídos, mas para os quais o tempo especificado pelo parâmetro REUSEDELAY no comando DEFINE STGPOOL não decorreu. Esses volumes também podem ser volumes do disco de acesso aleatório que foram excluídos, mas que ainda contêm dados descartados que estão esperando para serem fragmentados. Após o retalhamento dos dados, o volume será fisicamente excluído.
- FILling
- Exibe os volumes de acesso em ordem que o servidor gravou mas não preencheu ainda para capacidade.
- FULl
- Exibe os volumes de acesso sequencial que o servidor preencheu.
- STGPool
- Especifica o conjunto de armazenamento a ser incluído na consulta. Este parâmetro é opcional. É possível utilizar caracteres curingas para especificar os nomes. Se você não especificar um nome de conjunto de armazenamento, todos conjuntos de armazenamento serão incluídos na consulta.
- DEVclass
- Especifica a classe do dispositivo a ser incluída na consulta. Este parâmetro é opcional. É possível utilizar caracteres curingas para especificar os nomes. Se você não especificar um nome de classe de dispositivo, todos os dispositivos serão incluídos na consulta.
- Format
- Especifica como as informações são exibidas. Este
parâmetro é opcional. O valor padrão é STANDARD. Os valores possíveis são:
- Standard
- Especifica que as informações parciais serão exibidas.
- Detailed
- Especifica que as informações completas serão exibidas.
- LISTRetsets
- Especifica que todos os conjuntos de retenções que têm dados nos volumes do conjunto de armazenamentos de retenção especificados
são exibidos. Este
parâmetro é opcional. O valor padrão é No. Os seguintes valores são possíveis:
- Yes
- Especifica que todos os conjuntos de retenções com dados armazenados nos volumes do conjunto de armazenamentos especificados são exibidos.
- No
- Especifica que todos os conjuntos de retenções com dados nos volumes do conjunto de armazenamentos especificados não são exibidos.
Exemplo: Listar todos os volumes do conjunto de armazenamento de arquivo
Exibir informações sobre todos os volumes do conjunto de armazenamento com o nome de classe de dispositivo FILE. Veja Descrições de campo para descrições de campo.query volume devclass=file
Volume Name Storage Device Estimated Pct Volume
Pool Name Class Name Capacity Util Status
----------------------- ----------- ---------- --------- ----- -------
/FCT/SERVER/COVOl1 COPYSTG FILE 0.0 M 0.0 Pending
/FCT/SERVER/COVOl2 COPYSTG FILE 0.0 M 0.0 Empty
/FCT/SERVER/COVOl3 COPYSTG FILE 0.0 M 0.0 Empty
/FCT/SERVER/PRVOl1 PRIMESTG FILE 0.0 M 0.0 Empty
/FCT/SERVER/PRVOl2 PRIMESTG FILE 0.0 M 0.0 Empty
Exemplo: Listar todos os volumes do conjunto de armazenamento com o mesmo prefixo
Exiba informações sobre todos os volumes do conjunto de armazenamentos prefixados com o nome ATF. Veja Descrições de campo para descrições de campo.
ANR2017I Administrator SERVER_CONSOLE issued command: QUERY VOLUMEVolume Name Storage Device Estimated Pct Volume
Pool Name Class Name Capacity Util Status
---------------------- ----------- ---------- --------- ----- -------
/data/diskpool/dp1.dsm MYDISKSTG DISK 50.0 G 28.0 On-Line
000201L9 DISKL9RETPOOL L9RWDC 17.2 T 1.0 Filling
000202L9 L9RETPOOL L9RWDC 17.2 T 0.1 Filling
PU2053 JAG3592POOL JAGRWC 20.0 T 0.2 FillingExemplo: Exibir informações detalhadas sobre um volume de conjunto de armazenamento específico
Exiba detalhes sobre o volume do conjunto de armazenamentos denominado /fct/server/covol1. Veja Descrições de campo para descrições de campo.query volume covol1 format=detailed Volume Name: /FCT/SERVER/COVOl1
Storage Pool Name: COPYSTG
Device Class Name: DISK
Estimated Capacity: 10.0 M
Scaled Capacity Applied:
Pct Util: 6.7
Volume Status: On-line
Access: Read/Write
Pct. Reclaimable Space: 3.2
Scratch Volume?: Yes
In Error State?: No
Number of Writable Sides: 1
Number of Times Mounted: 11
Write Pass Number: 1
Approx. Date Last Written: 04/14/1998 16:17:26
Approx. Date Last Read: 04/01/1998 13:26:18
Date Became Pending:
Number of Write Errors: 0
Number of Read Errors: 0
Volume Location:
Volume is MVS Lanfree Capable: No
Last Update by (administrator): COLLIN
Last Update Date/Time: 05/01/1998 14:07:27
Begin Reclaim Period:
End Reclaim Period:
Logical Block Protected:
Drive Encryption Key Manager:
Encrypted:
Compressed:
Compressed Capacity:Exemplo: Exibir informações detalhadas sobre um volume de conjunto de armazenamento específico
Exibir detalhes sobre o volume do conjunto de armazenamento denominado WPDV00. Veja Descrições de campo para descrições de campo.query volume wpdv00 format=detailed Volume Name: WPDV00
Storage Pool Name: TAPEPOOL
Device Class Name: TAPE
Estimated Capacity: 5.8 M
Scaled Capacity Applied:
Pct Util: 0.1
Volume Status: On-line
Access: Read/Write
Pct. Reclaimable Space: 3.2
Scratch Volume?: Yes
In Error State?: No
Number of Writable Sides: 1
Number of Times Mounted: 11
Write Pass Number: 1
Approx. Date Last Written: 04/14/1998 16:17:26
Approx. Date Last Read: 04/01/1998 13:26:18
Date Became Pending:
Number of Write Errors: 0
Number of Read Errors: 0
Volume Location:
Volume is MVS Lanfree Capable: No
Last Update by (administrator): COLLIN
Last Update Date/Time: 05/01/1998 14:07:27
Begin Reclaim Period:
End Reclaim Period:
Logical Block Protected:
Drive Encryption Key Manager:
Encrypted:
Compressed:
Compressed Capacity:Exemplo: Exibir informações detalhadas sobre um volume do conjunto de armazenamentos com uma classe de dispositivo específica
Exibe detalhes sobre um volume em um conjunto de armazenamento com um nome de classe de dispositivo FILECLASS. Veja Descrições de campo para descrições de campo.query volume devclass=fileclass format=detailed Volume Name: Z:\WORM_CFS\0000000E.BFS
Volume Name: /WORM_FILESYS/0000000E.BFS
Storage Pool Name: FILEPOOL
Device Class Name: FILECLASS
Estimated Capacity: 2.0 G
Scaled Capacity Applied:
Pct Util: 0.0
Volume Status: Filling
Access: Read/Write
Pct. Reclaimable Space: 0.0
Scratch Volume?: Yes
In Error State?: No
Number of Writable Sides: 1
Number of Times Mounted: 1
Write Pass Number: 1
Approx. Date Last Written: 03/22/2004 15:23:46
Approx. Date Last Read: 03/22/2004 15:23:46
Date Became Pending:
Number of Write Errors: 0
Number of Read Errors: 0
Volume Location:
Volume is MVS Lanfree Capable: No
Last Update by (administrator):
Last Update Date/Time: 03/22/2004 15:23:46
Begin Reclaim Period: 03/22/2005
End Reclaim Period: 04/22/2005
Logical Block Protected:
Drive Encryption Key Manager:
Encrypted:
Compressed:
Compressed Capacity:Exemplo: Exibir informações detalhadas sobre um volume de conjunto de armazenamento específico
Exiba detalhes sobre um volume do conjunto de armazenamentos denominado 000642. O volume está em um conjunto de armazenamentos associado a uma classe de dispositivo 3592. Veja Descrições de campo para descrições de campo.query volume 000642 format=detailed Volume Name: 000642
Storage Pool Name: 3592POOL
Device Class Name: 3592CLASS
Estimated Capacity: 2.0 G
Scaled Capacity Applied:
Pct Util: 0.0
Volume Status: Filling
Access: Read/Write
Pct. Reclaimable Space: 0.0
Scratch Volume?: Yes
In Error State?: No
Number of Writable Sides: 1
Number of Times Mounted: 1
Write Pass Number: 1
Approx. Date Last Written: 03/22/2004 15:23:46
Approx. Date Last Read: 03/22/2004 15:23:46
Date Became Pending:
Number of Write Errors: 0
Number of Read Errors: 0
Volume Location:
Volume is MVS Lanfree Capable: No
Last Update by (administrator):
Last Update Date/Time: 03/22/2004 15:23:46
Begin Reclaim Period: 03/22/2005
End Reclaim Period: 04/22/2005
Logical Block Protected: Yes
Drive Encryption Key Manager: IBM Storage Protect
Encrypted:
Compressed:
Compressed Capacity: Exemplo: exibir os volumes nos quais um conjunto de retenção reside
Exibir informações sobre conjuntos de retenções que têm dados no volume do conjunto de armazenamentos de retenção especificado. Veja Descrições de campo para descrições de campo. Para o volume do conjunto de armazenamentos de retenção PT68LJL6, emita o comando:query volume PT68LJL6 listretset=yes
Volume Name Storage Device Estimated Pct Volume Retention
Pool Name Class Name Capacity Util Status Set IDs
----------- -------- -------- -------- ------ ------------ ------------
PT68LJL6 RETPOOL VTLDEVC 30.0 G 100.0 Full 377 379 380
383 384
385 409 410
Descrições dos campos
- Nome do Volume
- Nome do volume do conjunto de armazenamento.
- Nome do conjunto de armazenamentos
- Conjunto de armazenamento para o qual o volume está definido.
- Nome da classe de dispositivo
- A classe de dispositivo designada ao conjunto de armazenamentos.
- Capacidade estimada
- A capacidade estimada do volume, em megabytes (M), gigabytes (G) ou terabytes (T).
Para dispositivos DISK, esse valor é a capacidade do volume.
Para dispositivos de acesso sequencial, esse valor é uma estimativa do espaço total disponível no volume, que é baseado na classe de dispositivo.
- Capacidade em Escala Aplicada
- A porcentagem de capacidade à qual um volume está escalado. Por exemplo, um valor igual a 20 para um volume cuja capacidade máxima é 300 GB indica que o volume pode armazenar somente 20 por cento de 300 GB, ou seja, 60 GB. Este atributo se aplica apenas aos dispositivos IBM® 3592.
- Percentual de Utilização
- Uma estimativa da utilização do volume. A utilização inclui todo o espaço que é ocupado por arquivos e agregados, incluindo espaço vazio dentro de agregados.
Para volumes DISK, a utilização também inclui espaço ocupado por dados em cache.
- Status do Volume
- Status do volume.
- Retention Set ID
- A lista de conjuntos de retenções que têm dados armazenados no volume do conjunto de armazenamentos de retenção especificado.
- Acesso
- Especifica se o volume está disponível para o servidor.
- Percentual de de espaço recuperável (somente para volumes de acesso sequencial)
- Quantidade de espaço neste volume que pode ser reorganizado
por que os dados foram expirados ou eliminados. Esse valor é comparado ao limite de recuperação do conjunto de armazenamentos para determinar se a recuperação é necessária. O espaço recuperável inclui o espaço vazio nos agregados.
Ao determinar quais volumes recuperar em um conjunto de armazenamentos, o servidor primeiro determina o limite de recuperação. O limite de recuperação é determinado pelo valor do parâmetro THRESHOLD no comando RECLAIM STGPOOL ou, se esse valor não for especificado, o valor do parâmetro RECLAIM em uma definição do conjunto de armazenamento. O servidor examina, então, a porcentagem de espaço recuperável para cada volume do conjunto de armazenamento. Se a porcentagem de espaço recuperável de um volume for maior que o limite de recuperação do conjunto de armazenamento, o volume será um candidato à recuperação.
Por exemplo, suponha que o conjunto de armazenamentos FILEPOOL tenha um limite de recuperação de 70 por cento. Esse valor indica que o servidor pode recuperar qualquer volume do conjunto de armazenamento que tenha uma porcentagem de espaço recuperável maior que 70 por cento. O conjunto de armazenamento possui três volumes:- FILEVOL1 com 65 por cento de espaço recuperável
- FILEVOL2 com 80 por cento de espaço recuperável
- FILEVOL3 com 95 por cento de espaço recuperável
Quando a recuperação inicia, o servidor compara o percentual de espaço recuperável para cada volume com o limite de recuperação de 70 por cento. Neste exemplo, FILEVOL2 e FILEVOL3 são candidatos à recuperação, porque suas porcentagens de espaço recuperável são maiores que 70.
Para volumes que pertencem a um conjunto de armazenamentos SnapLock, o valor é exibido, mas não usado.
- Volume utilizável? (somente para volumes de acesso sequencial)
- Se esse volume é retornado a utilizável quando o volume fica vazio.
- Em estado de erro?
- Especifica se o volume está em estado de erro. O servidor não pode gravar em volumes em estado de erro.
- Número de Lados Graváveis
- Essas informações são reservadas para o IBM Storage Protect
- Número de Vezes Montado
- O número de vezes que o servidor abriu o volume para usá-lo. O número de vezes que o servidor abriu o volume não é sempre o mesmo que o número de vezes que o volume foi montado fisicamente em uma unidade. Depois que um volume é montado fisicamente, o servidor pode abrir o mesmo volume várias vezes para diferentes operações, por exemplo, para diferentes sessões de backup de cliente.
- Número de aprovações de gravação (somente para volumes de acesso sequencial)
- O número de vezes que o volume foi gravado a partir do início até o final.
- Data aproximada da última gravação
- Data aproximada em que o volume foi gravado pela última vez.
- Data aproximada da última leitura
- Data aproximada em que o volume foi gravado pela última vez.
- Data em que se Tornou Pendente
- Data em que o status do volume foi alterado para pendente.
- Número de Erros de Gravação
- Número de erros de gravação que ocorreram no volume.
- Número de Erros de Leitura
- Número de erros de leitura que ocorreram no volume.
- Localização do Volume
- A localização do volume.
- O volume é Compatível com MVS Lanfree
- Especifica se o volume possui capacidade livre de LAN. Um volume sem LAN é aquele que foi definido e usado (pelo menos uma vez) pelo servidor do gerenciador de dados do IBM Storage Protect z/OS® .
- Última atualização por (administrador)
- O último administrador que definiu ou atualizou o volume.
- Data/hora da última atualização
- Especifica quando o volume foi definido ou atualizado pela última vez.
- Iniciar Período de Reorganização
- Representa a data após a qual o servidor inicia a recuperação deste volume, mas não posterior à data representada pelo período de recuperação
final. Se, quando o período de recuperação começar, houver arquivos
no volume que não tenham expirado, eles serão movidos para um novo WORM durante
o processamento de recuperação. Este campo exibirá uma data apenas se esse volume
estiver em um conjunto de armazenamento para o qual o valor do parâmetro RECLAMATIONTYPE
seja SNAPLOCK.
Se mais de um archive for armazenado no mesmo volume, o início do período de recuperação do volume será baseado na data do archive mais recente. Para volumes SnapLock, o parâmetro RETVer do comando DEFINE COPYGROUP determina por quanto tempo um archive é armazenado. Se RETVer for definido como 100 dias, o período de recuperação do volume começará 100 dias depois de o primeiro archive ser armazenado nele. Se um segundo archive for armazenado no mesmo volume, a data inicial de recuperação será ajustada em 100 dias depois de o novo archive ser armazenado. Se o valor RETVer for alterado depois de o primeiro archive ser armazenado, a última data de recuperação será aplicada a todos os archives no volume. Por exemplo, considere que RETVer seja definido como 100 para um archive inicial, mas depois seja alterado para 50. Se um segundo archive for armazenado no volume três dias após o primeiro, o período de recuperação não será iniciado até 100 dias depois que o primeiro archive foi armazenado.
- Finalizar Período de Reorganização
- Representa a data até a qual o IBM Storage Protect deve concluir o processamento de recuperação neste volume para assegurar a proteção contínua dos dados Também representa o atributo de arquivo físico Data do Último Acesso no Arquivador NetApp, que impede a exclusão do arquivo até essa data. Este campo exibirá uma data apenas se esse volume estiver em um conjunto de armazenamento para o qual o valor do parâmetro RECLAMATIONTYPE seja SNAPLOCK.
- Gerente de chave de criptografia da unidade
- O gerenciador de chaves de criptografia de unidade. Esse campo aplica-se somente a volumes em um conjunto de armazenamentos que está associado a um tipo de dispositivo 3592, LTO ou ECARTRIDGE.
- Bloco Lógico Protegido
- Especifica se a proteção do bloco lógico está ativada para o volume. É possível usar a proteção do bloco lógico apenas com os seguintes tipos de unidades e mídia:
- IBM LTO5 e posterior
- IBM 3592 Geração 3 unidades e posteriormente com 3592 de mídia Geração 2 e posterior
- Unidades Oracle StorageTek T10000C e T10000D
Comandos Relacionados
| Comando | descrição |
|---|---|
| DEFINIR DEVCLASS | Define uma classe de dispositivo. |
| DEFINIR VOLUME | Designa um volume a ser utilizado para armazenamento em um conjunto de armazenamento especificado. |
| EXCLUIR VOLUME | Exclui um volume de um conjunto de armazenamento. |
| ATUALIZAR DEVCLASS | Altera os atributos de uma classe de dispositivo. |
| ATUALIZAR VOLUME | Atualiza os atributos de volumes do conjunto de armazenamento. |
| VARIADO | Especifica se um volume do disco está disponível ao servidor para uso. |