O ambiente de execução DB2 Call Level Interface (CLI) e o controlador ODBC estão inclusos no DB2 Client Application Enabler. Isto consta no Package Client do DB2 ou pode ser carregado a partir da página Web em http://www.software.ibm.com/data/db2.
Este suporte permite que aplicações desenvolvidas utilizando ODBC e APIs da DB2 CLI trabalhem com qualquer servidor DB2 . O suporte de desenvolvimento de aplicação da DB2 CLI é fornecido pelo DB2 Software Developer's Kit (DB2 SDK) que é a parte do produto Software Developer's Kit do DB2, separadamente classificável.
Antes das aplicações DB2 CLI ou ODBC poderem acessar o DB2, os pacotes DB2 CLI têm de ser limitados em servidor.. Embora isso vá ocorrer automaticamente na primeira conexão, se o usuário tiver solicitado autoridade para fazer bind dos pacotes, é recomendável que o administrador faça isso primeiro com cada versão do cliente de cada plataforma que acessará o servidor. Consulte "Ligação de Utilitários do Banco de Dados" para obter detalhes específicos.
As etapas gerais a seguir são solicitadas no sistema do cliente para propiciar às aplicações DB2 CLI e ODBC acesso aos bancos de dados do DB2. Estas instruções supõem que a conexão ao DB2 foi bem-sucedida utilizando ID de usuário e senha válidas. Dependendo da plataforma, muitas destas etapas são automáticas. Para obter detalhes completos, consulte a seção que trata especificamente de plataforma.
Após as instruções específicas de plataforma, há outros detalhes sobre os seguintes tópicos:
![]() | Os detalhes específicos de plataforma sobre como fornecer acesso do DB2 CLI e das aplicações ODBC ao DB2 estão divididos nas seguintes categorias: |
Antes que o DB2 CLI e as aplicações ODBC possam acessar com sucesso um banco de dados DB2 a partir de um cliente Windows 3.1, Windows 95 ou Windows NT, execute os seguintes passos no sistema cliente :
Para obter mais informações consulte o auxílio online no CCA (ou no comando catalog no Command Reference).
Para verificar que ambos existem na máquina:
Se o Microsoft ODBC Driver Manager ou o controlador DB2 CLI/ODBC da IBM não estiverem instalados, então execute outra vez a instalação DB2 e selecione o componente ODBC no Windows 95 ou Windows NT, ou dê duplo clique no ícone Instalar Controlador ODBC no grupo de programa do DB2 no Windows 3.1.
Consulte o comando
CATALOG [ user | system ] ODBC DATA SOURCEno Command Reference para obter maiores informações.
Para obter informações sobre como editar manualmente este arquivo (db2cli.ini), veja "Configuração do db2cli.ini".
Embora não esteja diretamente relacionado ao DB2, alguns usuários têm tido problemas quando executam aplicações ODBC de 16-bit no Windows 95 ou no Windows NT.
Ambas as aplicações, de 16- e 32-bits, utilizam o mesmo Controlador DB2 CLI/ODBC da IBM. O Microsoft ODBC Driver Manager cuida da conversão entre a aplicação de 16 bits e o controlador ODBC de 32 bits.
Algumas aplicações de 16 bits foram lançadas com um conjunto antigo de DLLs de Gerenciador de Controle de 16 bits (isto antes de 1995). Estas DLLs não funcionam bem no ambiente de 32 bits. Os seguintes sintomas podem ocorrer quando executamos as DLLs antigas:
Se (e só neste caso) você estiver enfrentado estes problemas, pode atualizar as DLLs de Gerenciador de Controle ODBC de 16 bits da Microsoft. Estes arquivos acompanham o DB2 no subdiretório SQLLIB\MSODBC16. Use estas novas DLLs para substituir as versões mais antigas que estão localizadas no subdiretório sistema do diretório do sistema operacional Windows.
![]() | Se você solicitou informações adicionais neste ponto pode dirigir-se para os seguintes tópicos no "Informações Detalhadas sobre Configuração": |
Antes que o DB2 CLI e as aplicações ODBC possam acessar com sucesso um banco de dados DB2 a partir de um cliente OS/2, execute os seguintes passos no sistema cliente:
Para obter mais informações, consulte o auxílio online no CCA ou "Configuração de Conexões do Banco de Dados".
Para obter informações sobre como editar manualmente este arquivo (db2cli.ini), veja "Configuração do db2cli.ini".
![]() | Se você solicitou informações adicionais neste ponto pode dirigir-se para os seguintes tópicos no "Informações Detalhadas sobre Configuração": |
Antes que o DB2 CLI e as aplicações ODBC possam acessar com sucesso um banco de dados DB2 a partir de um cliente UNIX, execute as seguintes etapas no sistema do cliente:
Para obter mais informações consulte Capítulo 10. "Configuração de Comunicações Cliente-Servidor Utilizando o Processador de Linha de Comando" ou o comando catalog no Command Reference.
Definindo um odbcinst.ini
As definições deste arquivo têm impacto sobre todos os controladores ODBC da máquina.
Use um editor ASCII para atualizar este arquivo. Ele deve ter um bloco (seção) chamado [IBM DB2 ODBC DRIVER], com uma linha de inicialização "Controlador" indicando o caminho completo do controlador ODBC DB2 (db2.o). Por exemplo, se o diretório raiz de seu usuário final é /u/thisuser/ e o diretório sqllib é instalado lá, então a entrada correta seria:
[IBM DB2 ODBC DRIVER] Driver=/u/thisuser/sqllib/lib/db2.oVeja o arquivo modelo no subdiretório sqllib/odbclib para obter um exemplo.
Definindo odbc.ini
As definições deste arquivo estão associadas a um usuário específico da máquina; diferentes usuários podem ter diferentes arquivos odbc.ini.
O arquivo odbc.ini tem de ser copiado no diretório de origem do usuário final e deve chamar-se .odbc.ini. Atualize este arquivo, usando o editor ASCII, para refletir as informações apropriadas da configuração da fonte dos dados. Para registrar um banco de dados DB2 como fonte de dados ODBC tem de haver um bloco (seção) para cada banco de dados DB2.
O gabarito modelo odbc.ini mostra:
SAMPLE=IBM DB2 ODBC DRIVERIndica que existe uma fonte de dados chamada SAMPLE que utiliza o IBM DB2 ODBC DRIVER
[SAMPLE] Driver=/u/thisuser/sqllib/lib/db2.o Description=Sample DB2 ODBC DatabaseIndica que o banco de dados SAMPLE é parte da instância DB2 localizada no diretório /u/thisuser.
InstallDir=/u/thisuser/sqllib/odbclibIndica que o /u/thisuser/sqllib/odbclib deve ser considerado como a localização onde o ODBC está instalado.
Nota: | Se sua aplicação instalou especificamente os componentes ODBC (tais como o
Gerenciador de Controle) em alguma parte, você tem de atualizar a linha que
começa por InstallDir abaixo do bloco [ODBC] para refletir esta nova
localização.
Por exemplo, se o ODBC tiver sido instalado no /opt/odbc, o bloco [ODBC] parecerá com: [ODBC] Trace=0 TraceFile=odbctrace.out InstallDir=/opt/odbc |
Veja o arquivo modelo no subdiretório sqllib/odbclib para obter um exemplo. Você também pode ver o "Como Configurar o ODBC.INI" para obter mais informações.
Uma vez que os arquivos .ini estiverem definidos, você pode executar sua aplicação ODBC e acessar os bancos de dados DB2. Dirija-se à documentação que acompanha sua aplicação ODBC para obter auxílio e informações adicionais.
Há várias palavras-chave e valores que podem ser utilizados para modificar o comportamento do DB2 CLI/ODBC e das aplicações que a utilizam. As palavras-chave são associadas ao banco de dados alias e afetam todas as aplicações DB2 CLI/ODBC que acessam o banco de dados.
Para obter informações sobre como editar manualmente este arquivo (db2cli.ini), veja "Configuração do db2cli.ini". Para obter mais informações sobre as palavras-chave específicas veja o CLI Guide and Reference.
![]() | Se você solicitou informações adicionais neste ponto pode dirigir-se para os seguintes tópicos no "Informações Detalhadas sobre Configuração": |
Antes que o DB2 CLI e as aplicações ODBC possam acessar com sucesso um banco de dados DB2 a partir de um cliente Macintosh, execute as seguintes etapas no sistema do cliente:
Para obter mais informações consulte "Configuração de Conexões do Banco de Dados".
O gerenciador de controle MacODBC utiliza o arquivo de Preferências ODBC ou o arquivo PCC de Preferências ODBC para registrar as informações sobre os controladores disponíveis e as fontes de dados.
É possível também modificar estes arquivos manualmente. Não altere nenhuma das entradas existentes nos arquivos.
[ODBC Data Sources] GLOBALDB=IBM ODBC DB2 para Macintosh SAMPLE=IBM ODBC DB2 para Macintosh [GLOBALDB] Driver=appl:ODBC$DB2DriverFunctionSet Description=My GLOBAL database [SAMPLE] Driver=appl:ODBC$DB2DriverFunctionSet Description=My SAMPLE database
[ODBC Data Sources] SAMPLE=IBM ODBC DB2 para PPC [SAMPLE] Driver=DB2ODBCDriverPPC Description=My SAMPLE database
Para cada fonte de dados listada na seção [ODBC Data Source], há uma seção que lista as informações adicionais sobre aquela fonte de dados. Elas são chamadas seções Especificação de Fonte de Dados.
Abaixo da entrada [ODBC DATA SOURCE], acrescente a seguinte linha:
Onde database_alias é o alias do banco de dados catalogado no diretório de banco de dados (o nome do banco utilizado pela instrução Processador de Linha de Comando CONNECT TO).
[database_alias] Driver=appl:ODBC$DB2DriverFunctionSet
[database_alias] Driver=DB2ODBCDriverPPC
A seção "Detalhes Específicos de Plataforma para Acesso CLI/ODBC" deve fornecer todas as informações que você solicitar. As seguintes informações são úteis quando o suporte de ferramenta do DB2 não está disponível, e para administradores que necessitam de informações mais detalhadas.
![]() | Os seguintes tópicos constam nesta seção: |
O controlador CLI/ODBC fará autobind à primeira conexão ao banco de dados, dado que o usuário possui o privilégio ou a autorização apropriada. O administrador pode querer executar a primeira conexão ou fazer bind explicitamente dos arquivos solicitados.
Veja o "Ligação de Utilitários do Banco de Dados" para obter mais informações.
O DB2 CLI pode ser configurado depois usando-se o CCA ou o Configuração de Cliente DB2, aplicável à sua plataforma, ou manualmente editando o arquivo db2cli.ini.
Este arquivo possui várias palavras-chave e valores que podem ser utilizados para modificar o comportamento do DB2 CLI e as aplicações que o utilizam. As palavras-chave são associadas ao banco de dados alias e afetam todas as aplicações DB2 CLI DB2 que acessam o banco de dados.
Por padrão, a localização do arquivo configuração de palavra-chave CLI/ODBC, é a seguinte:
A variável de ambiente DB2CLIINIPATH pode também ser usada para substituir o padrão e especificar uma localização diferente para o arquivo.
As palavras-chave de configuração habilitam você a:
Para obter uma descrição completa de todas as palavras-chave e o uso delas, dirija-se ao "Descrições das Palavras-Chave de Configuração".
O arquivo de inicialização db2cli.ini é um arquivo ASCII que armazena valores para as opções de configuração DB2 CLI. Um arquivo modelo é lançado para ajudá-lo a inicializar. Dirija-se ao o CLI Guide and Reference para obter mais informações em cada palavra-chave.
Veja o "Detalhes Específicos de Plataforma para Acesso CLI/ODBC" para obter mais informações sobre como modificar este arquivo de sua plataforma.
O Gerenciador de Controle ODBC de 16 bits da Microsoft e o da Visigenic utilizam o arquivo odbc.ini para registrar informações sobre os controladores disponíveis e as origens de dados. O Gerenciador de Controle ODBC da Visigenic também utiliza o arquivo odbcinst.ini nas plataformas UNIX. Embora os arquivos necessários sejam automaticamente atualizados pelas ferramentas na maioria das plataformas, os usuários das ODBC das plataformas UNIX terão de editá-los manualmente. O arquivo odbc.ini (e o odbcinst.ini onde for exigido) estão localizados:
É possível também modificar este arquivo manualmente. Não altere nenhuma das entradas existentes no arquivo.
Temos a seguir um arquivo de exemplo odbc.ini:
[ODBC Data Sources] MS Access Databases=Access Data (*.mdb) [MS Access Databases] Driver=D:\WINDOWS\SYSTEM\simba.dll FileType=RedISAM SingleUser=False UseSystemDB=False
A seção [ODBC Data Sources] lista o nome de cada fonte de dados disponível e a descrição do controlador associado.
Para cada fonte de dados listada na seção [ODBC Data Sources], há uma seção que lista as informações adicionais sobre aquela fonte de dados. Elas são chamadas seções Especificação de Fonte de Dados.
database_alias=IBM DB2 ODBC DRIVEROnde database_alias é o alias do banco de dados catalogado no diretório de banco de dados (o nome do banco utilizado pela instrução Processador de Linha de Comando CONNECT TO).
[database_alias] Driver=drive:\windows\system\db2cliw.dllEm que:
A seguir temos um arquivo modelo da fonte das entradas de fonte de dados da IBM acrescentadas:
[ODBC Data Sources] MS Access Databases=Access Data (*.mdb) SAMPLE=IBM DB2 ODBC DRIVER [MS Access Databases] Driver=D:\WINDOWS\SYSTEM\simba.dll FileType=RedISAM SingleUser=False UseSystemDB=False [SAMPLE] Driver=D:\WINDOWS\SYSTEM\db2cliw.dll Description=Sample DB2 Client/Server database
Nota: | Se você estiver executando uma aplicação ODBC no WIN-OS/2, especifique o caminho equivalente \OS2\MDOS\WINOS2\SYSTEM no lugar do caminho \WINDOWS\SYSTEM. |
Configuração UNIX de arquivos .ini
A seção "Acesso de Cliente UNIX ao DB2 usando o CLI/ODBC" possui as etapas detalhadas sobre como atualizar os arquivos odbc.ini e odbcinst.ini.