DEFINE SCRIPT (Definir um script IBM Storage Protect ).

Editar on-line

Use esse comando para definir um script IBM Storage Protect ou para criar um novo script IBM Storage Protect usando o conteúdo de outro script.

A primeira linha do script pode ser definida com este comando. Para incluir linhas subsequentes no script, utilize o comando UPDATE SCRIPT.

Dicas:

Ao rotear comandos dentro de scripts, coloque o servidor ou grupo de servidores entre parênteses e omita os dois pontos. Caso contrário, se a sintaxe incluir um sinal de dois pontos, o comando não será roteado quando o comando RUN for emitido. Em vez disso, o comando é executado apenas no servidor do qual o comando RUN é emitido.
Não é possível redirecionar a saída de um comando em um script IBM Storage Protect . Em vez disso, execute o script e, em seguida, especifique o redirecionamento do comando. Por exemplo, para direcionar a saída de script1 para o diretório c:\temp\test.out, execute o script e especifique o redirecionamento do comando como no seguinte exemplo:
```
run script1 > c:\temp\test.out
```

Classe de privilégio

Para emitir este comando, deve-se ter privilégio de operador, de critério, de armazenamento ou de sistema.

Sintaxe

Parâmetros

script_name (Obrigatório)

Especifica o nome do script a ser definido. É possível especificar um nome de até 30 caracteres.

linha_de_comando

Especifica o primeiro comando a ser processado em um script. É necessário especificar um destes parâmetros (e opcionalmente, o parâmetro LINE) ou o parâmetro FILE.

O comando especificado pode incluir variáveis de substituição e pode ser continuado em várias linhas, se você especificar um caractere de continuação (-) como o último caractere no comando. As variáveis de substituição são especificadas com um caractere '$', seguido de um número que indica o valor do parâmetro quando o script for processado. É possível especificar até 1200 caracteres na linha de comandos. Coloque o comando entre aspas, se contiver espaços em branco.

É possível executar comandos de maneira serial, em paralelo, ou de maneira serial e em paralelo, especificando os comandos de script SERIAL ou PARALLEL para o parâmetro COMMAND_LINE. É possível executar diversos comandos em paralelo e aguardar até que eles sejam concluídos antes de continuar com o próximo comando. Os comandos são executados serialmente até que o comando paralelo seja encontrado.

Restrição: Se você especificar um script com o comando PARALLEL , não inclua um comando SHOW, QUERYou SELECT no script. Essa restrição se aplica a todos os scripts, incluindo aqueles que chamam outros scripts.

É possível utilizar instruções condicionais de fluxo lógico. Essas instruções incluem IF, EXIT e GOTO.

Line: Especifica o número de linhas para a linha de comandos. Como os comandos são especificados em várias linhas, os números de linhas são utilizados para determinar a ordem de processamento quando o script for executado. A primeira linha ou linha 001 é o padrão. Este parâmetro é opcional.

File

Especifica o nome do arquivo cujo conteúdo é lido no script a ser definido. O arquivo deve residir no servidor no qual este comando está sendo executado. Se especificar o parâmetro FILE, você não poderá especificar uma linha de comandos ou número da linha.

É possível criar um script consultando outro script e especificando os parâmetros FORMAT=RAW e OUTPUTFILE. A saída da consulta do script é direcionada a um arquivo que você especifica com o parâmetro OUTPUTFILE. Para criar o novo script, o conteúdo do script a ser definido é lido pelo arquivo que você especificou com o parâmetro OUTPUTFILE.

DESCription

Especifica uma descrição para o script. É possível especificar até 255 caracteres para a descrição. Coloque a descrição entre aspas, se contiver espaços em branco. Este parâmetro é opcional.

Exemplo: Escreva um script para exibir clientes AIX

Defina um script que exibe todos os clientes AIX® .

define script qaixc "select node_name from nodes where platform_name='AIX'"
  desc='Display aix clients'

Exemplo: Gravar e executar um script para rotear um comando para um grupo de servidores

Defina e execute um script que roteará o comando QUERY STGPOOL para um grupo de servidores denominado DEV_GROUP.

define script qu_stg "(dev_group) query stgpool"

run qu_stg

Exemplo: Criar um script a partir de um script existente

Definir um script cujas linhas de comandos sejam lidas de um arquivo denominado MY.SCRIPT e dar o nome AGADM ao novo script. O arquivo deve estar no servidor, e ser lido pelo servidor.

define script agadm file=my.script

Comandos Relacionados

Tabela 1. Comandos relacionados a DEFINE SCRIPT
Comando	descrição
COPIAR SCRIPT	Cria uma cópia de um script.
EXCLUIR SCRIPT	Exclui o script ou linhas individuais do script.
SCRIPT DE CONSULTA	Exibe informações sobre scripts.
RENOMEAR SCRIPT	Renomeia um script para um novo nome.
CORRER	Executa um script.
ATUALIZAR SCRIPT	Altera ou inclui linhas em um script.