O que é o DBACCESSCFG

O DBACCESSCFG é uma ferramenta de linha de comando multiplataforma (Windows e Linux, 32 e 64 bits) que permite configurar conexões e outros parâmetros do TOTVS | DBAccess.

Por ser uma ferramenta de linha de comando, ela não depende de interface gráfica e permite a automatização do processo de configuração do TOTVS | DBAccess.

O DBACCESSCFG não exige conexão com o TOTVS | DBAccess, apenas que esteja na mesma pasta que o arquivo dbaccess.ini.

A ferramenta irá gravar as informações no arquivo dbaccess.ini, que utilizará essas informações ao iniciar e/ou conectar com um SGBD.

Como utilizar

Ao executar o binário do DBACCESSCFG sem parâmetro algum, é possível visualizar quais são os parâmetros esperados pela ferramenta:

Quando o DBACCESSCFG consegue gravar o conteúdo com sucesso é apresentado a mensagem "Ini file successfully generated".

Parâmetros obrigatórios

-u - Nome do usuário

Neste parâmetro deve ser informado o nome do usuário da conexão com o SGBD. O nome do usuário deve ser informado de forma literal e sem aspas duplas ao redor.

-p - Senha do usuário

Neste parâmetro deve ser informado a senha do usuário da conexão com o SGBD. A senha deve ser informada de forma literal, sem aspas duplas ao redor, e será criptografada ao gravar no arquivo dbaccess.ini.

-d - SGBD

Neste parâmetro deve ser informado qual é o SGBD da conexão que está sendo configurada. Os valores válidos para esse parâmetros são:

• MSSQL (Microsoft SQL Server)
• ORACLE
• POSTGRES (PostgreSQL)
• INFORMIX
• DB2
• OPENEDGE (Apenas Windows)
• ODBC (Conexão ODBC Genérica)

-a - Alias

Neste parâmetro deve ser informado o nome da conexão que será criada no TOTVS | DBAccess.

Esse nome deve ser o mesmo nome configurado na janela de ODBC (Windows), ou no arquivo odbc.ini (Linux), ou no arquivo tnsnames.ora (Oracle OCI).

Parâmetros opcionais

-o - Opções do SGBD

Neste parâmetro são informadas as chaves e valores extras que vão na seção da conexão criada.

O padrão do valor passado nesse parâmetro é "Chave=Valor".

Caso queira passar mais de uma chave, deve-se colocar ponto e vírgula ( ; ) antes do nome da próxima chave.

-c - Client Library

Neste parâmetro é informado o nome da biblioteca que será carregada para realizar as operações com um SGBD.

Esse parâmetro é utilizado em Windows para SGBD Oracle com conexão por OCI e em Linux, para passar o caminho da unixODBC (conexões ODBC) ou da OCI (conexão Oracle por OCI).

Deve ser informado o caminho completo do arquivo na máquina do TOTVS | DBAccess.

-g - Opções gerais

Neste parâmetro são informadas as chaves e valores que vão na seção General do arquivo dbaccess.ini.

O padrão do valor passado nesse parâmetro é "Chave=Valor".

Caso queira passar mais de uma chave, deve-se colocar ponto e vírgula ( ; ) antes do nome da próxima chave.

Exemplo de utilização

1. Criação de uma conexão com o MS SQL Server Windows chamada P12PRODUCAO, usuário protheus, senha protheuspwd.

   Comando

   dbaccesscfg -u protheus -p protheuspwd -d MSSQL -a P12PRODUCAO

   Arquivo

   [MSSQL/P12PRODUCAO]
   user=protheus
   password=Žïô¸½½°Ÿì
   Tablespace=
   IndexSpace=
   
   [MSSQL]
   environments=P12PRODUCAO
   
   

2. Criação de uma conexão com o MS SQL Server Linux chamada P12PRODUCAO, usuário protheus, senha protheuspwd, usando unixODBC em /usr/lib64/libodbc.so.

   Comando

   dbaccesscfg -u protheus -p protheuspwd -d MSSQL -a P12PRODUCAO -c "/usr/lib64/libodbc.so"

   Arquivo

   [MSSQL/P12PRODUCAO]
   user=protheus
   password=Žïô¸½½°Ÿì
   Tablespace=
   IndexSpace=
   
   [MSSQL]
   environments=P12PRODUCAO
   ClientLibrary=/usr/lib64/libodbc.so
   
   

3. Criação de uma conexão Oracle OCI Windows chamada P12PRODUCAO, usuário protheus, senha protheuspwd, OCI em c:\oracle\x64\instantclient_12_2\oci.dll, TableSpace com valor HOMOLOG_DATA e IndexSpace com valor HOMOLOG_IDX.

   Comando

   dbaccesscfg -u protheus -p protheuspwd -d ORACLE -a P12PRODUCAO -c "c:\oracle\x64\instantclient_12_2\oci.dll" -o "TableSpace=HOMOLOG_DATA;IndexSpace=HOMOLOG_IDX"

   Arquivo

   [ORACLE/P12PRODUCAO]
   user=protheus
   password=Žïô¸½½°Ÿì
   Tablespace=HOMOLOG_DATA
   IndexSpace=HOMOLOG_IDX
   
   [ORACLE]
   environments=P12PRODUCAO
   ClientLibrary=c:\oracle\x64\instantclient_12_2\oci.dll
   
   

4. Criação de uma conexão Oracle ODBC Windows chamada P12PRODUCAO, usuário protheus, senha protheuspwd.

   Comando

   dbaccesscfg -u protheus -p protheuspwd -d ORACLE -a P12PRODUCAO -o "OracleODBC=1"

   Arquivo

   [ORACLE/P12PRODUCAO]
   user=protheus
   password=Žïô¸½½°Ÿì
   Tablespace=
   IndexSpace=
   OracleODBC=1
   
   [ORACLE]
   environments=P12PRODUCAO
   
   

5. Criação de uma conexão PostgreSQL Windows chamada P12PRODUCAO, usuário protheus, senha protheuspwd, e configurando IP e porta do License Server que será utilizado pelo TOTVS | DBAccess.

   Comando

   dbaccesscfg -u protheus -p protheuspwd -d POSTGRES -a P12PRODUCAO -g "LicenseServer=192.168.0.100;LicensePort=5555"

   Arquivo

   [GENERAL]
   LicenseServer=192.168.0.100
   LicensePort=5555
   
   [POSTGRES/P12PRODUCAO]
   user=protheus
   password=Žïô¸½½°Ÿì
   Tablespace=
   IndexSpace=
   
   [POSTGRES]
   environments=P12PRODUCAO
   
   

Veja também

• DBAccess - Arquivo de configuração
• DBAccess - Como fazer
• Descontinuação Bancos de Dados DB2 e Informix para Protheus