QUERY RETMEDIA (consulta a mídia do conjunto de armazenamentos de retenção de fita)

Classe de privilégio

Parâmetros

nome_do_volume

Especifica o nome do volume a ser consultado. É possível utilizar caracteres curingas para especificar vários nomes. Este parâmetro é opcional. O servidor procura os nomes correspondentes entre os volumes elegíveis a seguir:

• Os volumes de backup de banco de dados, conforme especificado pelo parâmetro SOURCE desse comando.
• Volumes de conjunto de armazenamentos de retenção de fita de conjuntos de armazenamentos de retenção especificados pelo parâmetro RETENTIONSTGPOOL. Se você não utilizar o parâmetro RETENTIONSTGPOOL, o servidor consultará os volumes dos conjuntos de armazenamentos de retenção de fita que foram especificados anteriormente pelo comando SET DRMRETENTIONSTGPOOL.

WHEREState

Especifica o estado de volumes a serem consultados. Este parâmetro é opcional. O padrão é ALL. Os valores possíveis são:

All

Inclui todos os volumes em todos os estados.

MOuntable

Inclui volumes que contêm dados válidos, são registrados na biblioteca e são acessíveis para processamento interno.

NOTMOuntable

Inclui volumes que estão no local, contêm dados válidos, mas são retirados da biblioteca e não são acessíveis para processamento interno.

COUrier

Inclui volumes que estão sendo movidos para um local externo.

VAult

Inclui volumes externos, contém dados válidos e não são acessíveis para processamento interno.

VAULTRetrieve

Inclui volumes que estão na área segura externa e que podem ser migrados de volta ao local:

• Um volume do conjunto de armazenamentos de retenção de fita poderá estar no estado VAULTRETRIEVE se todos os dados no volume expirarem. O volume pode ser trazido de volta ao local e restaurado.
• Um volume de backup de banco de dados é considerado no estado VAULTRETRIEVE se ele estiver associado a uma série de backup de banco de dados expirada com base no valor especificado usando o comando SET DRMDBBACKUPEXPIREDAYS.

Importante: Ao emitir o comando QUERY RETMEDIA com a configuração de parâmetro WHERESTATE=VAULTRETRIEVE , o servidor dinamicamente determina quais volumes podem ser movimentados de volta no local. Portanto, para garantir que você identifique todos os volumes que estão no estado VAULTRETRIEVE, emita o comando QUERY RETMEDIA com a configuração de parâmetro WHERESTATE=VAULTRETRIEVE sem os parâmetros BEGINDATE, ENDDATE, BEGINTIME ou ENDTIME. Os comandosLast Update Date/Timecampo na saída para o comando QUERY RETMDIA com a configuração do parâmetro WHERESTATE=VAULTRETRIEVE exibe a data e hora em que um volume foi deslocado para o estado VAULT, não VAULTRETRIEVE.

COURIERRetrieve

Inclui volumes que estão em trânsito no local interno.

ONSITERetrieve

Inclui volumes que foram recuperados de uma área segura externa. Os volumes estão no local, podem ser registrados na biblioteca e os dados do volume podem ser restaurados.

RESToreonly

Inclui volumes que são registrados na biblioteca para permitir a restauração de dados do conjunto de retenções. Para garantir que o volume seja usado apenas para restauração de dados, o seu modo de acesso é somente leitura. Quando os dados forem restaurados e o volume não for mais necessário no local, ele poderá ser retornado para a área segura externa.

RETENTIONstgpool

Especifica o nome do conjunto de armazenamentos de retenção de fita cujos volumes devem ser processados. Este parâmetro é opcional. É possível utilizar caracteres curingas para especificar este nome.

Os conjuntos de armazenamento de retenção de fita que são especificados com o parâmetro RETENTIONSTGPOOL substituem os conjuntos de armazenamento de retenção de fita que são especificados com o comando SET DRMRETENTIONSTGPOOL . Se esse parâmetro não for especificado, o servidor selecionará os conjuntos de armazenamentos como a seguir:

• Se o comando SET DRMRETENTIONSTGPOOL foi emitido anteriormente com nomes válidos de conjunto de armazenamentos de retenção de fita, o servidor processará apenas esses conjuntos de armazenamentos.
• Se o comando SET DRMRETENTIONSTGPOOL não foi emitido, ou se todos os conjuntos de armazenamentos de retenção de fita foram removidos usando o comando SET DRMRETENTIONSTGPOOL, o servidor processará todos os volumes do conjunto de armazenamentos de retenção de fita com base no valor especificado pelo parâmetro WHERESTATE.

BEGINDate

Especifica a data de início usada para selecionar volumes. Este parâmetro é opcional. Os volumes serão considerados elegíveis se o comando MOVE RETMEDIA tiver mudado o volume para o seu estado atual na data especificada ou depois dela. O padrão é a data mais antiga para a qual existem informações do volume.

A data pode ser especificada utilizando-se um dos seguintes valores:

Valor	descrição	Exemplo
MM/DD/AAAA	Uma data específica.	15/01/2020
TODAY	A data atual.	TODAY
HOJE-dias ou -dias	A data atual menos os dias especificados. O número máximo de dias é 9999.	TODAY-7 ou -7 Para consultar volumes que começam com registros mudados para o seu estado atual há uma semana, é possível especificar BEGINDATE=TODAY-7 ou BEGINDATE=-7.
EOLM (Final do Último Mês)	O último dia do mês anterior.	EOLM
EOLM-dias	O último dia do mês anterior menos os dias especificados.	EOLM-1 Para incluir arquivos que estavam ativos um dia antes do último dia do mês anterior.
BOTM (Início deste Mês)	O primeiro dia do mês atual.	BOTM
BOTM +dias	O primeiro dia do mês atual, mais os dias especificados.	BOTM+9 Para incluir arquivos que estavam ativos no 10º dia do mês atual.

ENDDate

Especifica a data de encerramento usada para selecionar volumes. Este parâmetro é opcional. Os volumes serão considerados elegíveis caso o comando MOVE RETMEDIA tenha mudado o volume para o seu estado atual na data especificada ou antes dela. O padrão é a data atual.

A data pode ser especificada utilizando-se um dos seguintes valores:

Valor	descrição	Exemplo
MM/DD/AAAA	Uma data específica.	15/09/2019
TODAY	A data atual.	TODAY
HOJE-dias ou -dias	A data atual menos os dias especificados. O número máximo de dias é 9999.	TODAY-7 ou -7. Para consultar volumes que começam com registros mudados para o seu estado atual há uma semana, é possível especificar BEGINDATE=TODAY-7 ou BEGINDATE=-7.
EOLM (Final do Último Mês)	O último dia do mês anterior.	EOLM
EOLM-dias	O último dia do mês anterior menos os dias especificados.	EOLM-1 Para incluir arquivos que estavam ativos um dia antes do último dia do mês anterior.
BOTM (Início deste Mês)	O primeiro dia do mês atual.	BOTM
BOTM +dias	O primeiro dia do mês atual, mais os dias especificados.	BOTM+9 Para incluir arquivos que estavam ativos no 10º dia do mês atual.

BEGINTime

Especifica o horário de início usado para selecionar volumes. Este parâmetro é opcional. Os volumes serão considerados elegíveis se o comando MOVE RETMEDIA tiver mudado o volume para o seu estado atual durante ou após o horário e data especificados. O padrão é meia-noite (00:00:00) na data especificada com o parâmetro BEGINDATE.

A hora pode ser especificada utilizando-se um dos seguintes valores:

Valor	descrição	Exemplo
HH:MM:SS	Um horário específico na data de início especificada	12:33:28
NOW	A hora atual na data de início especificada	NOW
NOW+HH:MM ou +HH:MM	O horário atual mais as horas e minutos da data de início especificada	NOW+03:00 or +03:00 Se você emitir o comando QUERY RETMEDIA às 9:00 com BEGINTIME=NOW+03:00 ou BEGINTIME=+03:00, o servidor exibe volumes que foram alterados para o seu estado atual às 12:00 na data de início especificada.
NOW-HH:MM ou -HH:MM	O horário atual menos as horas e minutos da data de início especificada	NOW-03:30 ou -03:30 Se você emitir o comando QUERY RETMEDIA às 9:00 com BEGINTIME=NOW-03:30 ou BEGINTIME=-03:30, o servidor exibe volumes que foram alterados para o seu estado atual, às 5:30, na data de início especificada.

ENDTime

Especifica o horário de término usado para selecionar volumes. Este parâmetro é opcional. Os volumes serão considerados elegíveis se o comando MOVE RETMEDIA tiver mudado o volume para seu estado atual durante ou antes da hora e data especificadas. O padrão é 23:59:59.

A hora pode ser especificada utilizando-se um dos seguintes valores:

Valor	descrição	Exemplo
HH:MM:SS	Um horário específico na data de encerramento especificada	10:30:08
NOW	O horário atual na data de encerramento especificada	NOW
NOW+HH:MM ou +HH:MM	A hora atual acrescida das horas e minutos na data de término especificada	NOW+03:00 ou +03:00 Se você emitir o comando QUERY RETMEDIA às 9:00 com ENDTIME=NOW+03:00 ou ENDTIME=+03:00, o servidor processa volumes que foram alterados para o seu estado atual, às 12:00, na data de encerramento especificada.
NOW-HH:MM ou -HH:MM	A hora atual menos as horas e os minutos na data de término especificada	NOW-03:30 ou -03:30 Se você emitir o comando QUERY RETMEDIA às 9:00 com ENDTIME=NOW-03:00 ou ENDTIME=-03:00, o servidor processa volumes que foram alterados para o seu estado atual, às 6:00, na data de encerramento especificada.

Source

Especifica se quaisquer volumes de backup de banco de dados que contêm volumes dos conjuntos de armazenamentos de retenção de fita estão selecionados. Este parâmetro é opcional. O padrão é DBBACKUP. É possível especificar um dos valores a seguir:

DBBackup

Os volumes de backup de banco de dados completo e incremental são selecionados.

DBSnapshot

Os volumes de backup de banco de dados de captura instantânea são selecionados.

DBNone

Nenhum volume de backup de banco de dados é selecionado.

Format

Especifica as informações a serem exibidas. Este parâmetro é opcional. O padrão é STANDARD. É possível especificar um dos valores a seguir:

Standard

Especifica que as informações parciais serão exibidas.

Detailed

Especifica que as informações detalhadas serão exibidas.

Cmd

Especifica que comandos executáveis serão construídos para os volumes selecionados. Se você especificar FORMAT=CMD, deverá especificar também o parâmetro CMD.

WHERELOcation

Especifica a localização dos volumes a serem consultados. Este parâmetro é opcional. O comprimento máximo da localização é 255 caracteres. Coloque o texto entre aspas, se contiver algum espaço em branco. Se você especificar um nome de servidor de destino, o gerenciador de recuperação de desastres exibirá todos os volumes de backup de banco de dados e os volumes do conjunto de cópias em armazenamento primário que estão no servidor de destino.

CMd

Especifica a criação de comandos executáveis para processar o volume e o local obtidos por esse comando. Este parâmetro é opcional. Você deve colocar a especificação do comando entre aspas. O comprimento máximo para este parâmetro é de 255 caracteres. O gerenciador de recuperação de desastres escreve os comandos para um arquivo que é especificado pelo parâmetro CMDFILENAME ou o comando SET DRMCMDFILENAME , ou gerado pelo comando QUERY RETMEDIA . Se o comprimento do comando for maior que 240 caracteres, ele é dividido em várias linhas e caracteres de continuação (+) são incluídos. Talvez seja necessário alterar o caractere de continuação, dependendo do sistema operacional.

Se você não especificar o parâmetro FORMAT=CMD, esse comando não criará nenhuma linha de comandos.

cordão

Sequência de comandos. A cadeia não deve conter aspas embutidas. Por exemplo, o parâmetro CMD a seguir é válido:

cmd="checkin libvol lib8mm &vol status=scratch"

O exemplo a seguir não é válido:

cmd=""checkin libvolume lib8mm" &vol status=scratch""

substituição

Especifica uma variável de substituição para informar QUERY RETMEDIA para substituir um valor para a variável. As variáveis não fazem distinção entre maiúsculas e minúsculas, e não devem conter espaços em branco após o e comercial (&). É possível especificar os valores a seguir:

&VOL

Uma variável com nome de volume.

&LOC

Uma localização de volume.

&VOLDSN

O nome do arquivo que o servidor grava nas etiquetas de mídia de acesso sequencial. Por exemplo, quando você usa o prefixo padrão TSM, o nome do arquivo em um volume de fita de conjunto de armazenamento de retenção é TSM.BFS. Quando você usa um prefixo de TSM310 em uma classe de dispositivo de fita que é usada para backups de banco de dados, o nome do arquivo será TSM310.DBB.

&NL

O caractere de nova linha. Quando & NL é especificado, o comando QUERY RETMEDIA divide o comando na variável & NL e não anexa um caractere de continuação. Você deve especificar o caractere de continuação apropriado antes do &NL se necessário. Se o &NL não for especificado e a linha de comandos for maior que 240 caracteres, a linha é dividida em várias linhas e são adicionados caracteres de continuação (+).

CMDFilename

Especifica o nome completo do arquivo para conter os comandos especificados com parâmetro CMD . Este parâmetro é opcional.

Se você não especificar um nome com o comando SET DRMCMDFILENAME , o servidor criará um nome de arquivo anexando exec.cmds ao nome do caminho do diretório absoluto da instância IBM Storage Protect . Se você especificar uma cadeia de caracteres nula (""), os comandos serão exibidos apenas no console. É possível redirecionar os comandos para um arquivo usando o caractere de redirecionamento do sistema operacional.

Se a operação falhar após a criação do arquivo de comando, o arquivo não será excluído.

CMDFilename

Especifica o nome completo do arquivo para conter os comandos especificados com parâmetro CMD . Este parâmetro é opcional.

Se você não especificar um nome de arquivo com o comando SET DRMCMDFILENAME , o servidor criará um nome de arquivo anexando exec.cmd ao diretório que representa essa instância do servidor (geralmente, o diretório no qual o servidor IBM Storage Protect foi originalmente instalado)... Se você especificar uma cadeia de caracteres nula (""), os comandos serão exibidos apenas no console. É possível redirecionar os comandos para um arquivo, utilizando > ou >> fornecidos pelo sistema. O gerenciador de recuperação de desastres aloca o nome do arquivo especificado ou gerado. Se o arquivo existir, o gerenciador de recuperação de desastres tenta utilizá-lo e todos os dados existentes são sobrescritos.

Se a operação falhar após a criação do arquivo de comando, o arquivo não será excluído.

APPend

Especifica se o conteúdo do arquivo de comandos deve ser substituído ou se os comandos devem ser anexados ao arquivo. Este parâmetro é opcional. O padrão é NO. É possível especificar os seguintes valores:

No

O conteúdo do arquivo é sobrescrito.

Yes

Os comandos são anexados ao arquivo.

VOLSTAtus

Especifica o status do volume. Este parâmetro é opcional. É possível especificar os seguintes valores:

Empty

Apenas volumes vazios são processados.

Notempty

Apenas volumes não vazios são processados.

Full

Apenas os volumes completos são processados.

Descrições dos campos

Nome do Volume

O nome do backup do banco de dados ou do volume do conjunto de armazenamentos de retenção de fita.

Estado

Estado do volume.

Data/hora da última atualização

A data e hora em que o estado do volume foi atualizado pela última vez. Para volumes no estado VAULTRETRIEVE, este campo exibe a data e hora em que um volume foi movido para o estado VAULT, não VAULTRETRIEVE. O servidor não faz a transição de volumes para VAULTRETRIEVE. No momento em que o comando QUERY RETMEDIA é emitido, o servidor determina dinamicamente se os dados nos volumes do conjunto de armazenamentos de retenção de fita e nos volumes de backup de banco de dados não são mais válidos e se o volume pode ser trazido de volta para o local para reutilização ou descarte.

Local

O campo Localização é exibido quando o volume não é montável ou quando ele não está na biblioteca. O campo Localização estará vazio se o volume for montável e estiver na biblioteca.

Tipo de volume

Tipo do volume:

Retenção

Um volume do conjunto de armazenamentos de retenção de fita.

DBBackup

Um volume de backup de banco de dados incremental e completa.

DBSnapshot

Um volume do backup da captura instantâneo do banco de dados.

Nome do conjunto de armazenamentos

O nome do conjunto de armazenamentos de retenção de fita.

Nome da Biblioteca Automatizada

Nome da biblioteca automatizada, se o volume estiver localizado em uma biblioteca.

Comandos Relacionados