Comando OPEN
Abre uma tabela do Analytics e o arquivo de dados associado.
Sintaxe
OPEN {nome_tabela|arquivo_de_dados <FORMAT nome_do_layout>} <BUFFERLENGTH comprimento> <CRLF> <DBASE> <INDEX arquivo_índice> <PRIMARY|SECONDARY> <SKIP bytes> <RELATION campo_chave>
Parâmetros
Nome | Descrição | ||||||
---|---|---|---|---|---|---|---|
nome_tabela |
O nome da tabela do Analytics a ser aberta. |
||||||
arquivo_de_dados |
O arquivo de dados a ser associado à tabela especificada por FORMAT nome_do_layout. O Analytics assume uma extensão de arquivo .fil se nenhuma extensão for especificada. Para abrir um arquivo sem extensão, insira um ponto (.) no final do nome do arquivo. |
||||||
FORMAT nome_do_layout opcional |
O layout da tabela do Analytics será aplicado ao arquivo de dados aberto como tabela. |
||||||
BUFFERLENGTH n opcional |
O comprimento em bytes da área de entrada do buffer a ser alocada à tabela. O valor padrão é 33.000 bytes. Áreas maiores do buffer podem melhorar a velocidade de processamento à custa de RAM disponível para armazenamento dos comandos do Analytics. Se nenhum bloco de comprimento variável da IBM que excede o comprimento do buffer for lido, o Analytics exibirá uma mensagem de erro e para o processamento. O valor padrão é definido no campo Tamanho de buffer na guia Tabela na caixa de diálogo Opções. Raramente será necessário alterar BUFFERLENGTH N, pois o padrão é suficiente para tratar quase todas as situações. |
||||||
CRLF opcional |
Especifica que um arquivo ASCII do comprimento variável será lido. O Analytics ajusta automaticamente os comprimentos de registro variáveis. Por padrão, os arquivos são considerados arquivos de comprimento fixo. |
||||||
DBASE opcional |
Especifica que a origem de dados é um arquivo dBASE. O Analytics reconhece o tipo de arquivo do dBASE e automaticamente cria uma tabela a partir da descrição do arquivo. Esse parâmetro pode ser omitido para arquivos do dBASE com extensão .dbf. | ||||||
INDEX arquivo_índice opcional |
O arquivo de índice a ser aplicado à tabela quando ela fora aberta. A extensão de arquivo usada para o nome de arquivo de índice é .inx, quando nenhuma extensão for especificada. Você pode especificar INDEX com tabelas primárias ou secundárias. |
||||||
PRIMARY | SECONDARY opcional |
Especifica que uma tabela é aberta como tabela primária ou tabela secundária. Se omitido, a tabela é aberta como uma tabela primária. | ||||||
SKIP bytes opcional |
O número de bytes a serem ignorados no início físico da tabela. SKIP pode ser usado para ignorar os registros do cabeçalho da tabela ou as partes iniciais da tabela que não seguem o layout do restante da tabela. Se omitido, a tabela será lida começando no primeiro byte. Nota
Para dados Unicode, especifique apenas um número de bytes par. A especificação de um número ímpar de bytes pode causar exibição incorreta de caracteres. |
||||||
RELATION campo_chave opcional |
Especifica que a tabela deve ser aberta como uma tabela relacionada ad hoc. O Analytics não mantém esta relação, quando a tabela estiver fechada. Você também deverá especificar o parâmetro INDEX ao usar RELATION. campo_chave é o campo-chave ou expressão usado para criar a relação entre duas tabelas. |
Exemplos
Abertura de uma tabela durante a especificação de um layout da tabela
Abra a tabela April_2012 usando o layout da tabela Março_2012:
OPEN Abril_2012 FORMAT Março_2012
Abertura de um arquivo dBASE
Abra um arquivo dBASE denominado Estoque.dbf para qual não há tabela existente:
OPEN Estoque
Abertura de uma tabela e aplicação de um índice já existente
Para abrir uma tabela primária ou secundária e aplicar um índice da tabela já existente, use a sintaxe abaixo:
OPEN Contas_a_receber INDEX Número_do_cliente_CR
OPEN Cliente SECONDARY INDEX Número_do_cliente
Abertura de uma tabela e criação de uma relação ad hoc com outra tabela
Você precisa estabelecer um relacionamento temporário entre uma tabela aberta denominada Clientes (a tabela primária) e uma tabela denominada Contas_a_receber (a tabela secundária).
Use um índice chamado Índice_cliente e um campo-chave na tabela primária denominado Sobrenome:
OPEN Contas_a_receber INDEX Índice_cliente RELATION Sobrenome