Comando SET

SET FOLDER

SET FORMAT

SET BEEP valor

SET BEEP 2

Configuração padrão: 0

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

O parâmetro valor deve estar entre 0 e 255. Se você especificar 0, o bipe será desativado.

Caixa de diálogo Opções: Opções de interface

SET CENTURY valor

SET CENTURY 40

Configuração padrão: 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.

Caixa de diálogo Opções: Opções de data e hora

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"

Configuração padrão: MM/DD/AAAA

Especifica o formato de apresentação para datas e a parte de data de datahoras em exibições, relatórios e arquivos exportados.

• 0 Define a data no formato MM/DD/AAAA.

• 1 Define a data no formato MM/DD/AA.

• 2 Define a data no formato DD/MM/AA.

• cadeia Define a data no formato personalizado especificado.

  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"

Caixa de diálogo Opções: Opções de data e hora

SET DELETE_FILE {ON | OFF}

SET DELETE_FILE ON

Configuração padrão: OFF

Controla se o arquivo de dados (*.fil) associado a um layout de tabela é excluído automaticamente quando você exclui o layout de tabela.

• ON O arquivo de dados associado é excluído automaticamente.

• OFF O arquivo de dados associado é não excluído.

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.

Caixa de diálogo Opções: Opções de tabela

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.

Caixa de diálogo Opções: Opções de exibição

SET ECHO {ON | NONE}

SET ECHO NONE
Os comandos e resultados de COMMENT nos scripts são excluídos do log.
SET ECHO ON

Controla se os comandos e resultados nos scripts são salvos no log de comandos do Analytics.

• ON Comandos e resultados nos scripts são salvos no log de comandos.

• OFF Comandos e resultados nos scripts não são salvos no log de comandos.

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.

• ON As cadeias de comparação devem ser idênticas para que ocorra 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".

• 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".

Para obter mais exemplos mostrando SET EXACT, consulte "Comparações exatas de caractere" em Opções de tabela.

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:

Caixa de diálogo Opções: Opções de tabela

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

SET FOLDER /Tabelas/Resultados

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

Controla se o Analytics exibirá automaticamente o layout de tabela atual e as definições de campos calculados quando você abrir uma nova tabela.

• ON O layout de tabela atual e as definições de campos calculados são exibidos automaticamente. Os resultados também são salvos no log de comando.

• OFF O layout de tabela atual e as definições de campos calculados não são exibidos.

Caixa de diálogo Opções: Opções de tabela

SET FUZZYGROUPSIZE <TO> num

SET FUZZYGROUPSIZE TO 10

Configuração padrão: 20 itens

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 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 LOCKAUTOSAVEFILE {ON | OFF}

SET LOCKAUTOSAVEFILE ON

Configuração padrão: OFF

Especifica o mecanismo para salvar dados no arquivo de log do Analytics (*.LOG).

• ON Os dados de log são salvos diretamente no disco, sem usar um buffer de gravação.

  Salvar dados de log diretamente no disco sem usar um buffer de gravação pode ajudar a evitar a corrupção do arquivo de log quando scripts são executados e possivelmente conflitam com outros processos no computador, como monitoramento antivírus ou backups automáticos.

  Nota

  Especificar ON pode fazer com que o Analytics seja executado mais lentamente. Use essa opção apenas se tiver problemas com corrupção de arquivos de log.

• OFF Os dados de log são salvos em um buffer de gravação antes de serem salvos no disco.

  O buffer de gravação é um local de armazenamento de dados temporário que oferece acesso mais rápido que o disco rígido e, portanto, agiliza de forma geral a execução de scripts do Analytics.

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 100

Para registros processados pelo comando LOOP, especifica o número máximo de comandos que podem ser executados para qualquer registro individual.

O intervalo de num vai de 0 a 32767. Se você especificar 0, o limite de execuções de comando por registro será desativado.

Como são calculadas as execuções de comando por registro

Para um registro específico, o número usado para comparação com o máximo de SET LOOP é o total de todos os comandos no bloco GROUP-LOOP que processa o registro. O detalhamento do comando é mostrado abaixo.

SET MARGIN lado <TO> valor

SET MARGIN TOP TO 100

Configuração padrão: 51 (51/100 de uma polegada)

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.

Caixa de diálogo Opções: Opções de impressão

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 Controle de arredondamento e precisão decimal em expressões numéricas.

SET MONTHS <TO> cadeia

SET MONTHS "Jan,Feb,Mar,Apr,May,Jun,Jul,Aug,Sep,Oct,Nov,Dec"

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.

Caixa de diálogo Opções: Opções de data e hora

SET NOTIFYFAILSTOP {ON | OFF}

SET NOTIFYFAILSTOP ON

Configuração padrão: OFF

Controla o comportamento do script quando o comando NOTIFY falha.

• ON O processamento do script será interrompido, com o registro de uma mensagem no log, se um comando NOTIFY no script falhar. O script é interrompido após a falha inicial ou após a quantidade especificada em NOTIFYRETRYATTEMPTS, caso nenhuma das tentativas obtenha sucesso.
• OFF O processamento do script continuará mesmo se um comando NOTIFY no script falhar.

Caixa de diálogo Opções: Opções de comando

SET NOTIFYRETRYATTEMPTS <TO> num

SET NOTIFYRETRYATTEMPTS TO 10

Configuração padrão: 5 tentativas

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.

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

Caixa de diálogo Opções: Opções de comando

SET NOTIFYRETRYINTERVAL <TO> segundos

SET NOTIFYRETRYINTERVAL TO 30

Configuração padrão: 10 segundos

Especifica a quantidade de tempo em segundos entre NOTIFYRETRYATTEMPTS. Insira um número entre 1 e 255.

Caixa de diálogo Opções: Opções de comando

SET ORDER <TO> valores

SET ORDER TO aAbBcC...

SET ORDER

Configuração padrão: o padrão do sistema

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 especificado.

O segundo comando retorna a sequência de ordenação para a configuração padrão do sistema.

Para obter mais informações, consulte A opção Critério de Ordenação e as sequências de ordenação.

SET OVERFLOW {ON | OFF}

SET OVERFLOW OFF

Configuração padrão: ON

Controla o comportamento do script quando ocorre um estouro numérico.

• ON O processamento do script será interrompido, com o registro de uma mensagem no log, se um estouro numérico ocorrer.

• OFF O processamento do script continuará mesmo se um estouro numérico ocorrer.

Caixa de diálogo Opções: Opções numéricas

SET PASSWORD num <TO> cadeia

SET PASSWORD 1 TO "senha123"

Cria uma definição de senha e especifica 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"

Configuração padrão: 0;30;60;90;120;10000

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

Caixa de diálogo Opções: Opções de data e hora

SET PICTURE formato

SET PICTURE "(9.999.999,99)"

Configuração padrão: -999999,99

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

Caixa de diálogo Opções: Opções numéricas

SET PYTHONPATH TO "C:\temp\testpython\venv\Scripts\python.exe"

Configuração padrão: campo vazio

Especifica o caminho completo e o nome do executável do Python (python.exe) a ser usado na integração de scripts Analytics-Python.

SET READAHEAD <TO> tamanho_buffer

SET READAHEAD TO 100

Configuração padrão: 33 quilobytes

Especifica o tamanho da leitura do bloco de dados (buffer de dados) em quilobyte. Insira um número de 5 a 255. Somente modifique essa configuração se aconselhado pelo Suporte.

Caixa de diálogo Opções: Opções de tabela

SET RETRY <TO> num

SET RETRYIMPORT <TO> num

SET RETRY TO 20

Configuração padrão: 0 tentativa

Especifica o número de vezes que o Analytics tenta executar um comando 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.

Há um período de espera de 1 segundo entre as novas tentativas.

A capacidade de especificar novas tentativas é útil para fazer a conexão a bancos de dados ou serviços de dados na nuvem, que podem estar temporariamente indisponíveis. Tentar novamente um comando também pode ajudar se você encontrar problemas com a escrita de dados em disco, ou a leitura de dados do disco.

SET RETRY é aplicável aos seguintes comandos:

Caixa de diálogo Opções: Opções de comando

SET SAFETY {ON | OFF}

SET SAFETY OFF

Padrão: ON

Controla se uma caixa de diálogo de confirmação aparece antes de sobrescrever qualquer um destes itens:

• campos nos layouts de tabela

• Tabelas do Analytics

• arquivos, inclusive arquivos de dados do Analytics (*.fil)

• ON Uma caixa de diálogo de confirmação aparece, e você precisa aceitar a ação explicitamente.

• OFF Nenhuma caixa de diálogo aparece, e a ação é realizada automaticamente.

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

Caixa de diálogo Opções: Opções de interface

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.

Caixa de diálogo Opções: Opções numéricas

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

Configuração padrão: 0

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.

Caixa de diálogo Opções: Opções de tabela

SET SUPPRESSTIME {ON | OFF}

SET SUPPRESSTIME ON

Configuração padrão: OFF

Controla se o Analytics suprime a parte de hora dos dados de origem de datahora.

• ON O Analytics suprime a parte de hora dos valores de 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 tempo 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.

• OFF As tabelas do Analytics definidas com 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

Controla se a saída do comando na tela aparece como texto com ou sem formatação.

• ON A saída do comando na tela aparece como texto sem formatação.

• OFF A saída do comando na tela aparece como texto com formatação.

A especificação de SET SUPPRESSXML sem qualquer parâmetro na linha de comando exibe a configuração está ativada ou não no momento.

Caixa de diálogo Opções: Opções de comando

SET TEST {ON | OFF}

SET TEST ON

Configuração padrão: ON

Controla se os resultados dos testes IF, WHILE, FOR e NEXT associados com os comandos GROUP são registrados no log.

• ON Os resultados são registrados no log.

• OFF Os resultados não são registrados no log.

Caixa de diálogo Opções: Opções de comando

SET TIME <TO> cadeia

SET TIME "hh:mm:ss PM"

Configuração padrão: hh:mm:ss PM

Especifica o formato de apresentação para a parte de hora de datahoras e os valores de tempo 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"

Caixa de diálogo Opções: Opções de data e hora

SET UTCZONE {ON | OFF}

SET UTCZONE OFF

Configuração padrão: ON

Controla a exibição dos dados de tempo que incluem uma diferença UTC. UTC significa Tempo Universal Coordenado, a hora no grau zero da longitude.

• ON Os dados de tempo com uma diferença UTC são exibidos como o equivalente da hora em UTC.
• OFF Os dados de tempo com uma diferença UTC são exibidos sem a conversão para UTC.

Por exemplo:

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

Caixa de diálogo Opções: Opções de data e hora

SET VERIFY {ON | OFF | BLANK}

SET VERIFY BLANK

Configuração padrão: OFF

Controla a verificação automática de dados sempre que uma tabela é aberta ou um campo na tabela é processado por um comando.

• ON O Analytics verifica automaticamente se o conteúdo de um campo de dados corresponde ao tipo de dado do campo no layout da tabela. Na exibição de tabela, os campos afetados mostram ### ERR ###. O processamento dos dados será interrompido se um erro for encontrado.

• OFF Nenhuma verificação automática dos dados.

• BLANK O Analytics substitui os dados de caracteres inválidos por espaços em branco e os dados numéricos inválidos por zeros, além da verificação descrita para o parâmetro ON. O processamento de dados continuará se um erro for encontrado, e o erro será capturado em ERROR.LOG na pasta de projeto do Analytics.

Caixa de diálogo Opções: Opções numéricas

SET WIDTH <TO> caracteres

SET WIDTH TO 20

Configuração padrão: 12

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.

Caixa de diálogo Opções: Opções numéricas