Abre uma tabela na área de trabalho atual e os arquivos relacionados a ela.
Sintaxe
USE Tabela [INDEX Indices] [ALIAS Alias] [EXCLUSIVE | SHARED] [NEW] [READONLY] [VIA Driver]]
Argumento | Obrigat. | Tipo | Descrição |
Tabela | Nome do arquivo da tabela a ser aberta | ||
Indices | Nomes dos índices a serem abertos junto com a tabela | ||
Alias | Alias da tabela a ser aberta | ||
Driver | Nome do RDD a ser utilizado na abertura da tabela |
Retorno | Descrição |
NIL | Sem retorno |
Descrição
Este comando associa uma tabela especificada pelo primeiro parâmetro (Tabela) à área de trabalho atual através de um driver especificado através do parâmetro Driver.
Também pode abrir os arquivos de índices relacionados com a tabela.
No caso do Ctree os arquivos de índices permanentes já são abertos automaticamente, mas nos demais RDDs deve especificar os arquivos de índices que se deseja abrir através do parâmetro Indices.
O Alias pode ser especificado através do parâmetro Alias. Pode-se especificar se a tabela será aberta em modo exclusivo ou compartilhado (através das opções “EXCLUSIV” e “SHARED”).
O usuário pode optar por abrir a tabela em modo somente leitura através da opção “READONLY”, onde nenhuma alteração será efetivada na tabela. A opção “NEW” determina que a tabela especificada será aberta na próxima área de trabalho disponível e será setada como a área de trabalho corrente.
Exemplo
Este exemplo demonstra como utilizar o comando USE para associar uma tabela (do tipo Ctree) a próxima área de trabalho disponível e torná-la ativa em modo compartilhado e somente leitura:
USE Cliente VIA “CTREECDX” NEW SHARED READONLY
CLOSEAREA
DBUSEAREA