QUERY RETRULE (Consultar uma regra de retenção)

Editar on-line

Utilize este comando para exibir informações sobre uma ou mais regras de retenção.

Classe de privilégio

Qualquer administrador pode emitir este comando.

Sintaxe

Parâmetros

nome_da_regra

Especifica o nome da regra de retenção a ser consultada. Este parâmetro é opcional. Se você especificar uma regra de retenção, apenas essa regra de retenção será considerada durante o processamento de consulta. Se você não especificar uma regra, todas as regras de retenção serão exibidas.

Format

Especifica como as informações são exibidas. Este parâmetro é opcional. O valor 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 completas serão exibidas. Por exemplo, é possível ver quando a próxima tarefa de criação do conjunto de retenção será executada.

Exemplo: exibir informações detalhadas sobre uma regra de retenção

Exibir informações detalhadas sobre uma regra de retenção chamada WEEKLY. Consulte Descrições de campo para obter as descrições de campo

query retrule weekly format=detailed


                 Retention Rule Name: WEEKLY
                    Retention Period: 2,000
               Retention Destination: 
                   Number of Clients: 2
                         Description:
                           Hold Name:
                              Reason:
                               Stack: Yes   
              Maximum Copy Processes: Storage Rule
             Retention Rule Contents: FILEMAN TAPEMAN
                     Start Date/Time: 05/07/2018 08:44:35
Previously Scheduled Start Date/Time:
      Next Scheduled Start Date/Time: 07/02/2018 08:44:35
                      Schedule Style: Classic
            Retention Rule Frequency: Weekly
                         Day of Week: Any
                               Month:
                        Day of Month:
                       Week of Month:
                             Active?: Yes
      Last Update by (administrator): ADMIN1A
               Last Update Date/Time: 05/07/2018 08:44:35

Exemplo: exibir informações detalhadas sobre uma regra de retenção que tem conjuntos de retenção copiados para um conjunto de armazenamentos de retenção

Exiba informações detalhadas sobre uma regra de retenção denominada ADMIN com dados do conjunto de retenção copiados para um conjunto de armazenamentos de retenção denominado RETPOOL. Consulte Descrições de campo para obter as descrições de campo

query retrule weekly format=detailed


           Retention Rule Name: WEEKLY
              Retention Period: 2,000
         Retention Destination: RETPOOL
             Number of Clients: 2
                   Description:
                     Hold Name:
                        Reason:
                         Stack: Yes   
        Maximum Copy Processes: Storage Rule
       Retention Rule Contents: FILEMAN TAPEMAN
               Start Date/Time: 08/07/2019 08:30:00
Previously Scheduled Start Date/Time:
Next Scheduled Start Date/Time: 08/12/2019 09:30:00
                Schedule Style: Classic
      Retention Rule Frequency: Weekly
                   Day of Week: Any
                         Month:
                  Day of Month:
                 Week of Month:
                       Active?: Yes
Last Update by (administrator): ADMIN1A
         Last Update Date/Time: 08/07/2019 08:44:35

Descrições dos campos

Nome da regra de retenção: O nome da regra de retenção.
Período de retenção: O período de tempo, em dias, para o qual qualquer conjunto de retenção que é criado pela regra de retenção é retido pelo servidor. Caso nenhum período de retenção seja especificado, o valor NOLIMIT será exibido.
Destino de retenção: O nome do conjunto de armazenamentos de retenção para o qual os conjuntos de retenção são copiados.
Número de Clientes: O número de clientes que estão incluídos na regra de retenção. Se forem usados curingas no nó, especificações de espaço no arquivo ou ambos, esse valor refletirá o número de clientes que correspondem a essas especificações quando a consulta for executada.
descrição: Uma descrição da regra de retenção.
Nome da suspensão: O nome de uma suspensão de retenção na qual um ou mais conjuntos de retenção são incluídos.
Razão: O motivo da suspensão de retenção.
Pilha: Especifica se os dados do conjunto de retenção podem ser copiados para volumes de fita compartilhados.
Máximo de processos de cópia: O número máximo de processos paralelos que a regra de armazenamento executa ao copiar dados do conjunto de retenção para um conjunto de armazenamentos de retenção.
Conteúdos da regra de retenção: Os clientes que estão incluídos nos conjuntos de retenção criados por esta regra de retenção. Caso sejam especificados curingas para os nós ou espaços no arquivo, esses valores curingas serão exibidos na saída da consulta.
Data/Hora de Início: A data e hora de início do intervalo a partir de quando a regra de retenção é executada.
Data/Hora de início planejadas anteriormente: A data e hora de início da regra de retenção mais recente executada.
Próxima data/hora de início planejada: A data e hora de início em que a próxima execução de regra de retenção é planejada. Se o parâmetro ACTIVE for configurado como Sim, essa data corresponderá à data em que o próximo conjunto de retenção será criado por essa regra de retenção. Se o parâmetro ACTIVE for configurado como Não, esse campo ficará em branco.
Estilo de Planejamento: Especifica se as regras do planejamento clássico ou aperfeiçoado serão utilizadas.
Frequência da regra de retenção: A frequência com a qual um planejamento de regras de retenção é executada e a criação de um conjunto de retenção é iniciada. Se a configuração SCHEDSTYLE=ENHANCED for especificada, esse campo ficará em branco.
Dia da semana: O dia da semana em que a regra de retenção planejada é executada.
Mês: O mês do ano em que a regra de retenção planejada é executada. Se a configuração SCHEDSTYLE=CLASSIC for especificada, esse campo ficará em branco.
Semana do mês: A semana do mês em que a regra de retenção planejada é executada. Se a configuração SCHEDSTYLE=CLASSIC for especificada, esse campo ficará em branco.
Ativo: Indicação de se a regra de retenção está ativa ou inativa. Uma regra ativa é ativada para processamento pelo servidor.
Última atualização por (administrador): O ID do administrador que definiu ou fez a última atualização na regra de retenção.
Data/hora da última atualização: A data e hora em que um administrador definiu ou atualizou mais recentemente a regra de retenção.

Comandos Relacionados

Tabela 1. Comandos relacionados ao QUERY RETRULE
Comando	descrição
DEFINA RETRULE	Define uma regra de retenção.
EXCLUIR RETRULE	Exclui uma regra de retenção.
RENOMEAR RETRULE	Renomeia uma regra de retenção.
REGRA DE ATUALIZAÇÃO	Muda os atributos de uma regra de retenção.