TOTVS DBACCESS

ATENDIMENTO CAT
LINHA DATASUL
 DBACCESS
CONCEITO DBACCESS

O DBAccess uma ferramenta para conexo base de dados, possibilitando o

acesso aos SGBDs mais utilizados, sem a necessidade de gerao de cdigo
especfico para cada banco.

Possui tambm um monitor, onde possvel visualizar os usurios conectados, o

consumo de recursos, bem como o log das interaes com o banco de dados.
 DBACCESS
BANCOS HOMOLOGADOS

Os bancos homologados para o DBAccess so: o DB2, MS SQL Server, Informix,

Oracle, PostgreSQL, Informix. Para a linha de produto Microsiga Protheus, o Progress
OpenEdge tambm homologado.

O MySQL, apesar de no homologado, suportado na verso 5.5.9 para uso com o

TSS.

Observao: Verificar no TDN os bancos e as verses homologadas.

 DBACCESS
INSTALAO

O processo de instalao simplificado: execuo do instalador e avano nas demais

telas.

Por padro, o DBAccess ser instalado no diretrio DBAccess, abaixo do diretrio

Program Files(x86) ou Arquivo de Programas(x86).

Prtica:
Instalao do DBAccess
 DBACCESS
INICIALIZAO

Aps a instalao, possvel executar o DBAccess em modo console ou via Servio

do Windows.

Para executar em modo console, criar um atalho para o executvel e acrescentar ao

final da linha de comando o parmetro console.

Para instalar o Servio, substituir o parmetro console por install. Caso no seja
informado, o servio ser criado como Totvs DBAccess 4.2 Server.
 DBACCESS
INICIALIZAO
(continuao)
Aps a primeira execuo, no diretrio do DBAccess sero criados os arquivos dbacess.ini,
dbaccess.log e dbconsole.log.

dbaccess.ini: contm as configuraes do DBAccess (a princpio vazio);

DBConsole.log: registra o incio e finalizao do registro e informaes sobre conexo;

DBAccess.log: registra o incio do DBAccess, as advertncias e erros ocorridos.

Prtica:
Inicializao do DBAccess
 DBACCESS
CRIAO ODBC

A conexo do DBAccess com o SGBD (com exceo do banco Oracle) realizada

utilizando-se de ODBC.

Para cada SGBD h um detalhamento da configurao da ODBC que precisa ser realizada
para garantir a conexo do DBAccess. Esse detalhamento pode ser consultado nas FAQs
do TDN

Caso o SGBD utilizado seja o Oracle, no necessrio a criao de ODBC: nesse caso
ser necessrio a criao do Ambiente no Monitor do DBAccess e posterior edio do
arquivo dbaccess.ini, adicionando na seo Oracle a varivel ClientLibrary indicando o
arquivo oci.dll do Oracle

Prtica:
Configurao de ODBC
 DBACCESS
CONFIGURAO

Aps a inicializao do DBAccess, necessrio executar o aplicativo DBMonitor para

efetuar a configurao e testes de conexo ao banco de dados.

Confirmar a porta do DBAccess (por padro 7890) e clicar na guia Configuraes e em

seguida a guia correspondente ao SGBD a ser utilizado.
 DBACCESS
CONFIGURAO
(continuao) necessrio criar uma Nova Conexo, digitando os valores correspondentes ao Alias
criado previamente na conexo ODBC (para ambientes 64 bits, utilizar o executar
odbcad32.exe localizado no diretrio SysWOW64 do Windows).
 DBACCESS
TESTE DE CONEXO

Aps a configurao da Conexo, possvel efetuar uma validao da mesma.

Na guia Assistentes, selecionar a opo Validao de Conexo.

Aps a mensagem de boas-vindas, selecionar o SGBD e, logo aps digitar o nome da fonte
de dados ODBC.

Caso a conexo seja bem sucedida, ser retornada uma caixa de mensagem com a
mensagem Conexo OK!.

Prtica:
Conexo DBAccess
 DBACCESS
LICENCIAMENTO

Por padro so liberados 2 usurios de conexo ao DBAccess. Sendo esse o caso, no

necessrio o preenchimento das linhas License Server e License Port no arquivo
dbaccess.ini.

Porm, caso tenha sido contratado um licenciamento diferente, essa configurao se faz
necessrio.

Tipos de Licenciamento: por processador ou por usurio.

 DBACCESS
LICENCIAMENTO
(continuao)
Ao iniciar o servio do DBAccess, o mesmo estabelece conexo com o servidor de licenas
e verifica se o License Server possui alguma licena 4091 (processor).

Se existir, o DBAccess consumir o nmero de licenas igual ao nmero de processadores

(core) encontrado no equipamento onde est sendo executado.

Caso o total de licenas 4091 seja 0 (zero), verificada a quantidade de licenas 4092
(user). Se encontrado, por padro todas as licenas 4092 so consumidas
instantaneamente.
 DBACCESS
LICENCIAMENTO
(continuao)
Se utilizados, em um determinado ambiente, mais de um servio do DBAccess, possvel
limitar a quantidade de licenas no arquivo dbaccess.ini.

Na seo [General], deve-se inserir a chave LicenseLimit=nn, onde nn o nmero de

licenas que o DBAccess vai solicitar ao License Server.
 DBACCESS
ATUALIZAO

A atualizao d-se atravs de uma nova instalao.

Caso a nova instalao seja realizada no mesmo diretrio de instalao da verso anterior,
anteriormente pode ser copiado as configuraes da mesma (dbaccess.ini).
 DBACCESS
CONFIGURAES
ADICIONAIS

Seo General: Contm as informaes comuns (globais) para os ambientes

administrados pelo servidor.

ConsoleMaxSize: Caso o arquivo (dbconsole.log) ultrapasse o tamanho definido,

o arquivo ser renomeado, automaticamente, para a extenso .BAK e um novo
ser criado. Caso j exista um arquivo .BAK, o sistema o apagar para que seja
possvel renomear o arquivo de log atual que atingiu o tamanho limite.

Port: por padro a porta utilizada pelo DBAccess 7890. Caso surja a
necessidade de alterar a mesma (j em uso ou criao de outro ambiente),
especificar a porta nesse parmetro.
 DBACCESS
CONFIGURAES
ADICIONAIS
Seo Service: contm configuraes especficas para a configurao do TOTVS
DBAccess como um servio do Windows. Estas chaves podem ser utilizadas quando da
necessidade de instalar no mesmo equipamento mais de uma instncia do
TOTVS DBAccess

Name: permite especificar um nome diferenciado para o servio do TOTVS

DBAccess. Por padro, o nome do servio do TOTVS DBAccess "DBACCESS.

DisplayName: Atravs desta chave, na seo [Service], possvel especificar

uma descrio diferenciada para o servio do TOTVS DBAccess. Por padro, a
descrio original do servio "TOTVS DBAccess 4.2 Server".
TOTVS DBACCESS

ATENDIMENTO CAT
LINHA DATASUL