Em geral a referência á uma base é efetuada através da especificação de uma cadeia que define a base propriamente dita e alguns parâmetros. A cadeia possui a seguinte sintaxe:
<parâmetro> = <valor>; <parâmetro>=<valor>; ……
<parâmetro> é um dos seguintes identificadores de três letras:
|
DSN |
arquivo do dicionário OpenBase |
obrigatório |
|
SEC |
código de segurança |
default : 1 |
|
LEV |
nível de acesso |
opcional |
|
HST |
máquina onde se encontra a base |
opcional |
|
CWD |
diretório absoluto em relação ao qual são definidos os arquivos da base |
default : diretório do dicionário |
|
COL |
COL=atomic ou COL=all |
default : atomic |
|
ISL |
nível de isolamento |
default : 1 |
Exemplo:
DSN=c:/temp/dic;SEC=10;LEV=senha;
É imperativo especificar o parâmetro CWD quando um item nome de um esquema OpenBase for especificado na forma de um caminho relativo. Caso contrário o TSQL poderá não visualizar certas tabelas da base. Desta forma quando CWD não é especificado, os itens nome de tabela devem ser especificados na forma do caminho completo de um arquivo a partir da raiz ou na forma do nome do arquivo quando o arquivo reside no diretório da base.
O parâmetro COL especifica a visibilidade dos campos do tipo POS para a SQL. No modo atomic somente os subcampos do último nível são visíveis sendo que todos os subcampos de um campo devem ser nomeados. No modo all todos os campos são visíveis.
Exemplo:
|
data |
U8 |
|
ano |
U4 POS data |
|
mes |
U2 POS data + 4 |
|
dia |
U2 POS data + 6 |
No exemplo, para COL=atomic, somente os campos ano, mes e dia são visíveis para a SQL. Se o campo ano não tivesse sido especificado, somente o campo data seria visível tendo em vista que todos os subcampos de um campo devem ser nomeados para serem visíveis.
Se COL=all, todos os campos data, ano, mes e dia são visíveis. Esta modalidade não é recomendada para a execução de comandos SQL do tipo INSERT considerando que os valores de data e mes por exemplo são superpostos .Em geral ela só deve ser utilizada para comandos de leitura (SELECT). O modo atomic é fortemente recomendado no caso do acesso ODBC. O modo all pode ser utilizado para recuperar dados em casos muito específicos.
O parâmetro ISL permite definir o nível de isolamento que tem efeito somente quando o bloqueio não é de banco (Veja capítulo 1).
O parâmetro HST especifica a máquina na qual reside a base. Se ele não for especificado a base é considerada residente na máquina local e a conexão entre a aplicação e o sistema TSQL não será do tipo cliente/servidor. No TSQLwi e no ODBC não é necessário especificar o parâmetro HST tendo em vista que eles possuem formas específicas para definir a máquina.
No caso mais específico do programa TSQLwi apresentado no apêndice 6, a cadeia aqui descrita não deve ser especificada para a conexão com o servidor considerando que os parâmetros da cadeia são fornecidos através os campos de uma interface teoricamente auto explicativa.