Abrir um banco de dados OpenBASE.
DATABASE <nome> <codigo> [<nivel> | *] <modo>
|
<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 . |
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).
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
$NODATABASE, SET MESSAGE, USE, DBERR( ) e DBMESS( ).