QUERY SCRIPT (Consultar scripts IBM Storage Protect )

Utilize este comando para exibir informações sobre scripts.

É possível utilizar este comando com o comando DEFINE SCRIPT para criar um novo script utilizando o conteúdo de outro script.

Classe de privilégio

A classe de privilégio necessária para este comando depende de se o parâmetro Outputfile está especificado no comando.

Se o parâmetro Outputfile não for especificado, qualquer administrador poderá emitir esse comando.
Se o parâmetro Outputfile for especificado e a opção do servidor REQSYSAUTHOUTFILE for configurada como YES, o administrador deverá ter privilégio no sistema.
Se o parâmetro Outputfile for especificado e a opção do servidor REQSYSAUTHOUTFILE for configurada como NO, o administrador deverá ter privilégio de operador, política, armazenamento ou sistema.

Sintaxe

Parâmetros

nome_do_script

Especifica o nome do script para o qual as informações devem ser exibidas. Você pode utilizar um caractere curinga para especificar este nome.

Importante: Se você não especificar um script, a consulta exibe informações sobre todos os scripts. O momento em que é utilizado para processar esse comando e a quantidade de informações exibidas pode ser extensa.

Format

Especifica o formato de saída para a exibição das informações do script. O padrão é STANDARD. Os valores possíveis são:

Standard: Especifica que serão exibidos apenas o nome e a descrição do script.
Detailed: Especifica que serão exibidas as informações detalhadas sobre o script. Essas informações incluem os comandos no script e seus números de linhas, a data da última atualização e o administrador que concluiu as atualizações.
Lines: Especifica que serão exibidos o nome do script, o número da linha dos comandos, as linhas de comentários e os comandos no script.
Raw: Especifica que os comandos contidos no script serão gravados em um arquivo nomeado com o parâmetro Outputfile. Este formato é uma maneira de direcionar a saída de um script para um arquivo para que ele possa ser copiado em outro script usando o comando DEFINE SCRIPT .
Se nenhum arquivo de saída for especificado, o servidor IBM Storage Protect emitiará o "script de consulta" com "format = raw" para o console.

Outputfile

Especifica o nome do arquivo para o qual a saída será direcionada quando você especificar FORMAT=Raw. O arquivo que você especifica deve estar no servidor que está executando este comando. Se o arquivo existir, a saída da consulta é anexada ao final do arquivo.

Exemplo: Listar as descrições do script

Exibir as informações padrão sobre os scripts.

query script *

Name             Description
---------------  ----------------------------------------------------
QCOLS            Display columns for a specified SQL table
QSAMPLE          Sample SQL Query
EXAMPLE          Backup the store pools and database when no sessions

Exemplo: Exibir o conteúdo de um script com números de linhas

Exibe as linhas de informações para um script nomeado Q_AUTHORITY.

query script q_authority format=lines

Name         Line    Command                                          
             Number  
----------   ------  -------------------------------------------------
Q_AUTHORITY  1       /* ------------------------------------------*/  
             5       /* Script Name:  Q_AUTHORITY                 */  
             10      /* Description: Display administrators that  */  
             15      /*              have the authority to issue  */  
             20      /*              commands requiring a         */  
             25      /*              specific privilege.          */  
             30      /* Parameter 1: privilege name - in the form */  
             35      /*              x_priv - EX. policy_priv     */  
             40      /* Example:  run q_authority storage_priv    */  
             45      /* ------------------------------------------*/  
             50      select admin_name from admins where -            
             55        upper(system_priv) <> 'NO' or -             
             60        upper($1) <> 'NO'

Exemplo: Criar um script a partir de um script existente

Consulte o script ENGDEV e direcione a saída para um arquivo nomeado MY.SCRIPT.

query script engdev format=raw outputfile=my.script

Exemplo: Exibir informações detalhadas do script

Exiba as informações detalhadas sobre os scripts. Veja Descrições de campo para descrições de campo.

query script * format=detailed

                          Name: QCOLS
                   Line Number: DESCRIPTION
                       Command: Display columns for a specified SQL
                                table
Last Update by (administrator): SERVER_CONSOLE
         Last Update Date/Time: 12/02/1997 16:05:29
 
                          Name: QCOLS
                   Line Number: 1
                       Command: select colname from columns where 
                                tabname='$1'
Last Update by (administrator): SERVER_CONSOLE
         Last Update Date/Time: 12/02/1997 16:05:29

Descrições dos campos

Name: O nome do script.
Line Number: Número da linha do script ou a cadeia DESCRIPTION.
Command: O comando incluído no número da linha que é exibido no campo anterior.
Last Update by (administrator): O nome do administrador que definiu ou atualizou mais recentemente o script.
Last Update Date/Time: A data e a hora em que o administrador definiu ou atualizou mais recentemente o script.

Comandos Relacionados

Tabela 1. Comandos Relacionados a QUERY SCRIPT
Comando	descrição
COPIAR SCRIPT	Cria uma cópia de um script.
DEFINIR SCRIPT	Define um script para o servidor IBM Storage Protect.
EXCLUIR SCRIPT	Exclui o script ou linhas individuais do script.
RENOMEAR SCRIPT	Renomeia um script para um novo nome.
CORRER	Executa um script.
ATUALIZAR SCRIPT	Altera ou inclui linhas em um script.