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

Analytics não Unicode 1 byte = 1 caractere
Analytics Unicode, dados em ASCII estendido (ANSI) 1 byte = 1 caractere
Analytics Unicode, dados Unicode 2 bytes = 1 caractere

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