Abrir um arquivo.
USE <arq.ban>
USE <microesquema>
USE *
<microesquema>
ENDUSE
USE <biblioteca> (<membro>)
<arq.ban> representa o nome de um arquivo do banco de dados aberto pelo último comando DATABASE.
<microesquema> representa o nome de um arquivo no diretório corrente onde foi feita a descrição de um arquivo externo.
USE * ... ENDUSE determina que a descrição do micro-esquema será feita na própria fonte. ENDUSE termina a descrição do arquivo.
<biblioteca> representa o nome de um arquivo no diretório corrente, onde foram feitas várias definições de arquivos externos.
<membro> representa o nome do micro-esquema definido dentro de uma biblioteca.
Abre um arquivo, seja ele de que tipo for e o deixa disponível para uso, até que um outro arquivo seja aberto ou selecionado.
O comando USE é um comando muito utilizado na linguagem.
Embora tenha uma sintaxe parecida para todos os casos funciona de forma distinta para arquivos do banco de dados e para arquivos externos. Para se abrir um arquivo externo existem várias formas de utilização uma para cada caso, dependendo da forma como foi definida sua aplicação. Os itens de um arquivo externo são declarados em memória como variáveis locais, portanto todas as variáveis de um arquivo externo ficam disponíveis em memória.
Pode-se determinar uma área de trabalho para um arquivo através do comando SELECT.
Em uma mesma fonte podem ser utilizados arquivos de banco de dados e arquivos externos desde que seus nomes sejam diferentes, pois o comando USE primeiro verifica no dicionário de dados a existência do arquivo e depois pesquisa o diretório corrente a procura do micro-esquema.
O exemplo a seguir mostra-nos como definir um arquivo externo dentro do código fonte do programa.
SELECT x
USE * && Inicia a declaração de um arquivo externo.
agenda I LEN(112)
telefone n14 KEY
ramal u05
nome u35
endereco u50
aniversario u08
ENDUSE && Termina a declaração
O exemplo a seguir mostra-nos como abrir um arquivo de um banco de dados, determinando uma área de trabalho para este.
DATABASE bdemp1 33 a 2
SELECT a
USE tab_func
LOCATE
O exemplo a seguir mostra-nos como abrir um arquivo externo, através de micro-esquema definido no diretório corrente. Observe durante a compilação a declaração dos itens.
SELECT a
USE usuarios.d
LOCATE
O exemplo a seguir mostra-nos como utilizar um arquivo externo que foi declarado dentro de uma biblioteca de micro-esquemas.
USE bibext.d (agendatel)
LOCATE FOR numero = 05122217455
DO WHILE FOUND( )
? nome
ENDDO
$FILES, CLOSE FILE, DATABASE, RESTORE, SAVE, SELECT, AFILES( ) e AJOINS( ).