Anterior Sumário Próximo OpenBASE! o Banco de Dados inteligente. Fale conosco!

DATABASE

Propósito

Abrir um banco de dados OpenBASE.

Sintaxe

DATABASE <nome> <codigo> [<nivel> | *] <modo>

Argumentos

<nome>

representa o nome do banco de dados.

<codigo>

representa o código de segurança definido para o banco de dados.

<nivel>

representa o nível de acesso às informações dos itens do banco de dados.

* representa a palavra de nível correspondente ao BDCNFG.

<modo>

representa o modo de abertura do banco de dados .

Utilização

O nome do banco deve ter no máximo 12 caracteres e pode ser passado um percurso para este banco. Neste caso, não deve ultrapassar 40 caracteres.

Caso não se passe o percurso, o comando DATABASE procura o banco de dados no diretório indicado no arquivo ".tscnfg" no diretório HOME do usuário ou no diretório padrão para banco de dados (/usr/tsgbd/tsdic/).

O código de segurança deve ser o mesmo definido no banco de dados para que seja possível a sua abertura. Isto serve para que somente pessoas autorizadas utilizem as informações contidas no banco de dados.

O nível de acesso (<nível>) é uma outra forma de proteção às informações de um banco de dados, pois permite a definição de níveis de privacidade para os itens do banco de dados. Além disso, a palavra de nível não precisa ser definida no programa-fonte, pode-se especificar um "*" (asterisco) no local destinado à palavra de nível no comando DATABASE, com isso, o programa abrirá o banco de dados com a palavra de nível definida pelo utilitário BDCNFG.

O modo de abertura também é uma forma de proteger as informações de um banco de dados. Existem três modos de abertura :

Modo de abertura igual a 1 permite somente leitura.

Modo de abertura igual a 2 permite leitura e gravação.

Modo de abertura igual a 3 permite a abertura exclusiva do banco de dados para leitura e gravação, sem permitir concorrência com outros usuários. Isto é útil para manutenção das informações contidas no banco de dados.

Os utilitários do OpenBASE abrem o banco de dados com modo de abertura igual a 3 evitando concorrência com outros usuários.

Outras maneiras de se abrir um banco de dados OpenBASE se faz através das variáveis do sistema OPUS :

NAME determina o nome de um banco de dados a ser aberto. Útil quando se tem bancos de dados com mesma estrutura, por exemplo, folhas de pagamento de diferentes empresas.

SECURITY determina o código de segurança para um banco de dados. Útil quando se deseja que somente pessoas autorizadas utilizem o sistema. Funciona como uma password para o banco de dados.

LEVEL determina o nível de privacidade das informações. Útil quando se deseja que somente pessoas autorizadas leiam ou atualizem as informações do banco de
dados. Por exemplo, o item salário somente alguns podem atualizar.

MODE determina o modo de abertura para um banco de dados.

Estas variáveis são verificadas em tempo de execução e caso ocorra uma incoerência entre os valores passados e os definidos no banco de dados a função DBERR() retornará um valor diferente de 0 (zero).

Exemplo

O exemplo a seguir mostra-nos como abrir um banco de dados OpenBASE no diretório padrão para o sistema.

DATABASE bdemp 33 a 2

* 33 a 2 são respectivamente codigo de segurança, nivel de

* acesso e modo de abertura default.

USE tab_clie

O exemplo a seguir mostra a utilização das variáveis NAME,SECURITY, LEVEL e MODE.

@ 10,10 SAY "Nome do Banco de Dados " GET NAME; PIC rep("x",40)

@ 11,10 SAY "Codigo de Segurança " GET SECURITY; PIC "9999999999"

@ 12,10 SAY "Nivel de Acesso " GET LEVEL;

PIC "xxxxxx"

@ 13,10 SAY "Modo de Abertura " GET MODE PIC "9"; RANGE 1,3

READ

DATABASE bdemp1 33 a 2

Consulte

$NODATABASE, SET MESSAGE, USE, DBERR( ) e DBMESS( ).

Anterior Sumário Próximo OpenBASE! o Banco de Dados inteligente. Fale conosco!