Comando SET

SET BEEP valor

SET BEEP 2

Especifica o número de beeps a tocar quando o processamento de um comando é concluído.

O parâmetro valor deve estar entre 1 e 255.

SET CENTURY valor

SET CENTURY 40

Especifica o ano do início do século para anos com dois dígitos.

O parâmetro valor deve estar entre 0 e 99.

Se o valor de início do século é definido como 40, os anos de dois dígitos de 40 a 99 são interpretados como 1940 a 1999 e os anos de dois dígitos 00 a 39 são interpretados como 2000 a 2039.

SET CLEAN {ON | OFF}

SET CLEAN ON

Quando esta opção está ativada, o Analytics substitui os dados de caracteres inválidos por brancos e os dados numéricos por zeros.

SET DATE <TO> {0 | 1 | 2 | cadeia}

SET DATE "AAAA/MM/DD"

Especifica como o Analytics exibe datas e a parte de data de datahoras em exibições, relatórios e arquivos exportados.

• SET DATE 0 define a data no formato MM/DD/AAAA

• SET DATE 1 define a data no formato MM/DD/AA

• SET DATE 2 define a data no formato DD/MM/AA

• SET DATE "<cadeia>" define a data no formato personalizado definido

  Ao usar o comando SET DATE para especificar formatos de hora personalizados, você deve usar 'D' para dia, 'M' para mês e 'Y' para ano, mesmo se caracteres de formato de data diferentes tenham sido especificados na caixa de diálogo Opções. Por exemplo:

  SET DATE "DD MMM AAAA"

SET DELETE_FILE {ON | OFF}

SET DELETE_FILE ON

Configuração padrão: OFF

Especifique ON para excluir automaticamente o arquivo de dados associado quando você excluir um layout de tabela.

Especifique OFF para evitar que o arquivo de dados associado seja excluído quando você excluir um layout de tabela.

Você deve incluir o sublinhado ( _ ) em DELETE_FILE.

A execução de SET DELETE_FILE, sem qualquer parâmetro, na linha de comando exibe o estado de ativação de DELETE_FILE.

SET DESIGNATION valor

SET DESIGNATION "Produzido por ABC Corporation"

O parâmetro valor é uma cadeia entre aspas que especifica o rótulo a ser exibido no topo de cada página impressa.

SET ECHO {ON | NONE}

SET ECHO NONE
Comandos e resultados COM do em scripts executados do log
SET ECHO ON

Especifique NONE para interromper a gravação de comandos e resultados de scripts no log de comandos do Analytics. Especifique ON para retomar a gravação.

O comando SET ECHO se aplica apenas ao registro de comandos e resultados em scripts. Os comandos executados por meio da interface do usuário ou emitidos na linha de comando, e seus resultados, são sempre registrados, independentemente da definição de ECHO.

Você pode executar o comando SET ECHO NONE/ON em um script ou da linha de comando, mas, onde quer que o comando seja executado, apenas o registro de comandos e resultados em scripts é afetado.

A execução de SET ECHO, sem qualquer parâmetro, na linha de comando exibe o estado de ativação do registro de comandos e resultados em scripts.

SET EXACT {ON | OFF}

SET EXACT ON

Configuração padrão: OFF

Controla como o Analytics compara campos de caracteres, expressões ou valores literais.

• SET EXACT está OFF o Analytics usa a cadeia mais curta para comparar duas cadeias de comprimento diferente. A comparação começa com os caracteres à esquerda e segue para a direita.

  Por exemplo, "AB" é igual a "AB", e também é considerada igual a "ABC".

• SET EXACT está ON as cadeias comparadas devem ser idênticas para haver uma correspondência. Na comparação de duas cadeias de tamanho diferente, o Analytics usa a cadeia mais curta com espaços acrescentados à direita para igualar o tamanho da cadeia mais longa.

  Por exemplo, "AB" é igual a "AB", mas não é considerada igual a "ABC".

Para obter mais exemplos mostrando SET EXACT, consulte "Comparações exatas de caractere" na guia Tabela (caixa de diálogo Opções).

Você pode usar a função ALLTRIM( ) para remover espaços em branco à esquerda e à direita e garantir que apenas os caracteres de texto e os espaços internos sejam comparados.

Por exemplo: ALLTRIM(" AB") = ALLTRIM("AB") será verdadeiro se a função ALLTRIM( ) for usada para os valores; caso contrário, será falso.

Alguns comandos e funções do Analytics são afetados pelo SET EXACT e outros não:

SET FILTER <TO> {teste | nome_filtro}

SET FILTER TO NoProd = "070104347"

SET FILTER TO FiltroNoProd

Cria um filtro global (filtro de exibição) na tabela aberta e especifica um teste lógico ou o nome de um filtro salvo existente.

A execução de SET FILTER, sem qualquer parâmetro, remove todos os filtros da tabela aberta.

SET FOLDER caminho da pasta

Especifica a pasta do projeto do Analytics na guia Visão geral para a saída do comando. A pasta de saída padrão é a pasta que contém a tabela ativa.

Este é um caminho no estilo DOS usando o formato /nome_pasta/nome_subpasta, onde a barra (/) inicial indica o nível raiz na guia Visão geral. Você deve especificar um caminho de arquivo completo.

• SET FOLDER /Tabelas/Resultados define a pasta de saída com o a subpasta Resultados. A subpasta Resultados será criada, caso não exista.

• SET FOLDER / define a pasta de saída no nível de raiz na guia Visão geral

• SET FOLDER define a pasta de saída para o padrão (a pasta que contém a tabela ativa)

A pasta de saída permanece como foi definida, até que seja redefinida ou até que o projeto seja fechado. Após a abertura do projeto, a pasta de saída irá reverter o padrão da pasta da tabela ativa.

SET FORMAT {ON | OFF}

SET FORMAT ON

Configuração padrão: OFF

Se você usar o parâmetro ON, o Analytics exibirá automaticamente o layout de tabela atual e as definições dos campos calculados quando uma nova tabela for aberta. Os resultados aparecem no log de comando.

SET FUZZYGROUPSIZE <TO> num

SET FUZZYGROUPSIZE TO 10

Especifica o número máximo de itens que podem aparecer no grupo de duplicatas parciais nos resultados de saída. O parâmetro num não pode ser menor que 2 ou maior que 100. O tamanho padrão é 20. O tamanho especificado permanece em vigor durante a sessão do Analytics.

SET GRAPH tipo

SET GRAPH LINE

Especifica o tipo de gráfico a ser usado para todos os gráficos gerados subsequentemente. A execução de comandos deve ser compatível com o tipo de gráfico especificado. Por exemplo, o comando BENFORD não pode produzir um gráfico PIE2D ou PIE3D. Se um tipo de gráfico incompatível for especificado, o tipo de gráfico padrão será usado (BAR3D).

O parâmetro tipo deve ser um dos seguintes:

• PIE2D

• PIE3D

• BAR2D

• BAR3D – este é o tipo de gráfico padrão.

• STACKED2D

• STACKED3D

• LAYERED

• LINE

• BENFORD – combina gráfico de barras 2D e gráfico de linhas 2D.

SET HISTORY <TO> valor

SET HISTORY TO 50

Especifica o número máximo de entradas do histórico da tabela para manter. O parâmetro valor deve estar entre 1 e 100.

SET INDEX <TO> valor

SET INDEX TO "CódigoCliente.INX"

Especifica o índice a ser aplicado à tabela ativa.

SET LEARN <TO> script

SET LEARN TO RegInventário

Especifica o nome do arquivo de script que o Gravador de Script usa para gravar comandos.

SET LOG <TO> {arquivo | OFF}

SET LOG TO "análise.log"

SET LOG OFF

O primeiro comando ativa o registro em log no log especificado. O log especificado será criado, se não existir.

O segundo comando restaura o registro ao log de comandos original do Analytics.

SET LOOP <TO> num

SET LOOP TO 20

Especifica o número máximo de loops executados pelo comando LOOP antes que o comando seja encerrado.

O intervalo de num vai de 0 a 32767, onde 0 desliga o teste de loop.

SET MARGIN lado <TO> valor

SET MARGIN TOP TO 100

Especifique LEFT, RIGHT, TOP ou BOTTOM do parâmetro lado. Se você quiser alterar a margem de todos os lados, será necessário especificar cada margem com um comando SET MARGIN separado. A especificação de um valor de 100 cria uma margem de 1 polegada.

SET MATH <TO> {FIRST | LAST | MIN | MAX}

SET MATH TO MIN

Configuração padrão: MAX

Especifica como a precisão decimal funciona quando dois operandos são avaliados em uma expressão numérica.

• FIRST use o número de casas decimais do primeiro operando em um par de operandos
• LAST use o número de casas decimais do último operando em um par de operandos
• MIN use o número mínimo de casas decimais em um par de operandos
• MAX use o número máximo de casas decimais em um par de operandos

Em expressões com vários operandos, a configuração SET MATH funciona com base em pares, aplicando a configuração especificada a cada par de operandos, arredondando conforme a necessidade, à medida que os operandos são avaliados na ordem matemática padrão (parênteses, ordem, multiplicação e divisão, adição e subtração).

Se a configuração SET MATH reduzir o número de casas decimais em um resultado, este será arredondado e não truncado.

Para obter mais informações, consulte Controlar arredondamentos em expressões numéricas.

SET MONTHS <TO> cadeia

Especifica as abreviações de três caracteres para nomes do mês. O parâmetro cadeia é a lista de abreviações de meses separadas por vírgula.

SET NOTIFYFAILSTOP {ON | OFF}

SET NOTIFYFAILSTOP ON

Configuração padrão: OFF

• NOTIFYFAILSTOP está OFF o Analytics permite a continuidade do script, mesmo em caso de falha de um comando NOTIFY no script.
• NOTIFYFAILSTOP está ON o Analytics interrompe o processamento do script e grava uma mensagem no log em caso de falha de um comando NOTIFY no script. O script é interrompido após a falha inicial ou após a quantidade especificada em NOTIFYRETRYATTEMPTS, caso nenhuma das tentativas obtenha sucesso.

SET NOTIFYRETRYATTEMPTS <TO> num

SET NOTIFYRETRYATTEMPTS TO 10

Especifica o número de vezes que o comando NOTIFY deve tentar enviar um e-mail se a tentativa inicial falhar. Insira um número de 0 a 255. Caso seja usado 0, nenhuma tentativa adicional é feita após a primeira falha. O valor padrão é 5.

Um possível motivo para que o comando NOTIFY falhe ao enviar um e-mail é a indisponibilidade do servidor de e-mail.

SET NOTIFYRETRYINTERVAL <TO> segundos

SET NOTIFYRETRYINTERVAL TO 30

Especifica a quantidade de tempo em segundos entre NOTIFYRETRYATTEMPTS. Insira um número entre 1 e 255. O valor padrão é 10 segundos.

SET ORDER <TO> valores

Especifica a sequência de ordenação dos campos de caractere. O parâmetro valores lista todos os caracteres do critério de ordenação selecionado.

SET OVERFLOW {ON | OFF}

SET OVERFLOW OFF

Configuração padrão: ON

Se OFF for especificado, o Analytics não interromperá o processamento quando ocorrer um erro de estouro.

SET PASSWORD num <TO> cadeia

SET PASSWORD 1 TO "senha123"

Usado para criar uma definição de senha e especificar um valor de senha para execução autônoma do script.

O parâmetro num identifica unicamente a definição de senha e deve ser um valor entre 1 e 10. Especifique o valor da senha como uma cadeia entre aspas.

SET PERIODS <TO> valor <;...n>

SET PERIODS TO "0,30,90,180,10000"

Especifica os períodos de vencimento padrão usados pelo comando AGE.

SET PICTURE formato

SET PICTURE "(9.999.999,99)"

Especifica a formatação padrão de valores numéricos.

SET READAHEAD <TO> tamanho

Especifica o tamanho da leitura do bloco de dados. Somente modifique essa configuração se aconselhado pelo Suporte.

SET RETRY <TO> num

SET RETRYIMPORT <TO> num

SET RETRY TO 50

Especifica o número de vezes que o Analytics tenta importar ou exportar dados se a tentativa inicial falhar. Insira um número de 0 a 255. Caso seja usado 0, nenhuma tentativa adicional é feita após a primeira falha. O padrão é 0.

Não há um período de espera entre as novas tentativas. Cada tentativa sucessiva é feita imediatamente após a falha precedente.

A capacidade de especificar novas tentativas é útil para fazer a conexão a bancos de dados ou serviços de dados de nuvem, que podem estar temporariamente indisponíveis.

Aplicável aos seguintes comandos:

• ACCESSDATA
• IMPORT GRCPROJECT
• IMPORT GRCRESULTS
• IMPORT SAP
• RETRIEVE
• REFRESH

  (para tabelas criadas inicialmente usando apenas ACCESSDATA ou IMPORT SAP)

• EXPORT . . . ACLGRC

  (exportar para o Resultados do HighBond)

SET SAFETY {ON | OFF}

SET SAFETY OFF

Especifique ON para exibir uma caixa de diálogo de confirmação ao sobrescrever os seguintes itens:

• campos nos layouts de tabela

• Tabelas do Analytics

• arquivos, incluindo arquivos de dados do Analytics (.fil)

Especifique OFF para evitar a exibição da caixa de diálogo.

A especificação de SET SAFETY sem qualquer parâmetro na linha de comando exibe o estado de ativação de SAFETY.

SET SEPARATORS <TO> valores

SET SEPARATORS TO ",.;"

Especifica os separadores de casas decimais, milhares e de lista usados pelo Analytics. Os valores SET SEPARATORS devem ter caracteres separadores válidos na seguinte ordem:

• casa decimal (ponto, vírgula ou espaço)

• milhares (ponto, vírgula ou espaço)

• lista (ponto e vírgula, vírgula ou espaço)

Entre os três separadores, o separador de casas decimais deve ser exclusivo. Você deve especificar todos os três separadores ao usar o comando. O separador de lista é usado principalmente para separar os parâmetros de função.

SET SESSION <nome_sessão>

SET SESSION

SET SESSION "Análise"

Cria uma nova sessão no log de comandos do Analytics. A sessão é identificada pelo carimbo de data/hora atual.

O nome_sessão opcional permite acrescentar até 30 caracteres de informações de identificação adicionais. Aspas são permitidas, mas não obrigatórias.

SET SORTMEMORY num

SET SORTMEMORY 800

Especifica a memória máxima alocada para processos de ordenação e indexação. O parâmetro num deve ser um valor de 0 a 2.000 megabytes (MB), a ser inserido em incrementos de 20 MB. Se a memória de ordenação for definida como 0, o Analytics usará a memória disponível no momento.

SET SUPPRESSTIME {ON | OFF}

SET SUPPRESSTIME ON

Configuração padrão: OFF

Para uso apenas na definição de uma tabela do Analytics que use uma fonte de dados ODBC (comando IMPORT ODBC) ou acesso direto a um banco de dados (comando DEFINE TABLE DB).

Se você usa o parâmetro ON, o Analytics suprime a parte de hora de valores datahora na definição da tabela. Por exemplo, 20141231 235959 é lido, exibido e processado subsequentemente como 20141231.

A inclusão desse comando em um script do Analytics anterior a datahora (anterior à versão v.10.0) que assume que a parte de hora dos dados de data hora será truncada permite que o script execute na versão do Analytics com suporte a datahora.

O Analytics suprime a parte de hora usando apenas a parte de data do formato de datahora. Os dados de hora continuam presentes no arquivo .fil ou na tabela do banco de dados. Se necessário, você pode redefinir o campo ou definir um novo campo para incluir a parte de hora dos dados.

Se SET SUPPRESSTIME = OFF, as tabelas do Analytics que usam ODBC ou acesso direto ao banco de dados incluem valores completos de datahora.

Você pode executar o comando SET SUPPRESSTIME ON/OFF em um script ou da linha de comando.

A execução de SET SAFETY, sem qualquer parâmetro, na linha de comando exibe o estado de ativação da supressão da parte de hora dos dados de datahora.

SET SUPPRESSXML {ON | OFF}

SET SUPPRESSXML ON

Configuração padrão: OFF

Especifica que a saída do comando é em texto simples, e não texto formatado.

SET TEST {ON | OFF}

SET TEST ON

Especifica se os resultados dos testes IF, WHILE, FOR e NEXT associados com os comandos GROUP devem ser gravados no log.

SET TIME <TO> cadeia

SET TIME "hh:mm:ss PM"

Especifica como o Analytics exibe a parte de hora de datahoras e valores de hora independentes em exibições, relatórios e arquivos exportados.

Ao usar o comando SET TIME para especificar formatos de hora personalizados, você deve usar 'h' para hora, 'm' para minuto e 's' para segundo, mesmo se caracteres de formato de hora diferentes tenham sido especificados na caixa de diálogo Opções Por exemplo:

SET TIME TO "hh:mm"

SET UTCZONE {ON | OFF}

SET UTCZONE OFF

Configuração padrão: ON

• UTCZONE está ON o Analytics altera a exibição de horas locais com um ajuste de UTC para o UTC equivalente à hora local. (UTC é o Tempo Universal Coordenado, o tempo em vigor em zero graus de longitude.)
• UTCZONE está OFF o Analytics exibe horas locais com um ajuste de UTC, sem convertê-las ao UTC.

Por exemplo:

• 01 Jan 2015 04:59:59 (SET UTCZONE ON)
• 31 Dez 2014 23:59:59-05:00 (SET UTCZONE OFF)

A conversão de hora local para UTC é apenas para fins de exibição e não afeta os dados originais. Você pode alternar entre os dois modos de exibição sempre que quiser.

SET VERIFY {ON | OFF | BLANK}

SET VERIFY ON

Quando ON for especificado, o Analytics automaticamente verificará o conteúdo de um campo de dados correspondente ao tipo de dados do campo no layout da tabela, sempre que uma tabela for aberta. Quando BLANK for especificado, o Analytics substituirá os dados de caracteres inválidos por brancos e os dados numéricos inválidos com zeros, além da verificação descrita para o parâmetro ON.

SET WIDTH <TO> caracteres

SET WIDTH TO 20

Especifica a largura da exibição padrão em caracteres para campos numéricos calculados, ou expressões numéricas ad hoc, quando o Analytics não pode determinar a largura máxima.