Linx DMS Integrador
Manual de Configuração Client SDK IBM® Informix

Assunto

Esta seção descreve como configurar o utilitário Setnet32 para configurar os produtos Client SDK IBM® Informix. 

Abrangência

Esta configuração destina-se a todos os clientes do segmento DMS do produto Sisdia, uma vez esse utilizando o IBM® Informix como banco de dados.

Configurando os Produtos Clientes IBM Informix nos Sistemas Windows

O utilitário Setnet32 configura ou modifica as variáveis de ambiente e os parâmetros de rede usados pelos produtos IBM® Informix no tempo de execução. As variáveis de ambiente e os parâmetros de rede são armazenados no registro do sistema Windows e são válidos para todos os produtos clientes IBM Informix instalados. 
Esta seção é dividida nas seguintes etapas:

  • Configurando as Variáveis de Ambiente
  • Configurando Informações do Servidor de Banco de Dados
  • Configurando Informações do Host


O utilitário Setnet32 possui as quatro páginas a seguir:

  • Ambiente permite configurar as variáveis de ambiente.
  • Informações do Servidor permite configurar informações de rede do servidor de banco de dados.
  • Informações do Host permite configurar as informações do computador host e de login.
  • Sobre o Setnet32 fornece informações sobre o utilitário Setnet32.


Configurando as Variáveis de Ambiente
Para obter informações sobre os produtos IBM® Informix e o ambiente no qual eles são executados, os produtos clientes devem acessar variáveis de ambiente. Algumas variáveis são necessárias e outras são opcionais.
Para configurar variáveis de ambiente: 

  1. Dê um clique duplo em Setnet32 na pasta que contém os produtos Client SDK. A janela IBM Informix Setnet32 é aberta.
  2. Clique na guia Ambiente para exibir a página Ambiente, que tem os seguintes elementos:
    • Ambiente do Cliente/Servidor IBM Informix
      Selecione uma variável de ambiente para editar.
      Após selecionar uma variável de ambiente, o nome da variável de ambiente é exibido acima da caixa de texto Nome da Variável.
    • Editar Variável de Ambiente

Digite um novo valor na caixa de texto, edite o valor existente ou selecione um valor clicando na seta para baixo.
Clique em Limpar para designar um valor nulo para a variável de ambiente. Após fazer sua alteração, clique em Configurar para salvar o valor. 
Obs.: Deixar a variável DBMONEY Com valor: R$, (com virgula).
Deixar a variável DBDATE com valor: DMY4/ 

    • Salvar/Carregar

Clique em Carregar do Arquivo para carregar suas variáveis de ambiente e seus valores de um arquivo específico. Entretanto, não é possível carregar variáveis de ambiente de um arquivo específico a menos que o utilitário Setnet32 já tenha criado esse arquivo. (Use a opção Salvar no Arquivo para criar um arquivo.)
Clique em Salvar no Arquivo para salvar suas variáveis de ambiente e seus valores em um arquivo específico. 

    • Usar Minhas Configurações

As entradas do Setnet32 são armazenadas no HKEY_LOCAL_MACHINE após a instalação. Para salvar as configurações em HKEY_CURRENT_USER e configurá-lo como registro padrão para modificar as configurações, selecione Usar Minhas Configurações e clique em Aplicar. Todas as configurações do ambiente são então copiadas para HKEY_CURRENT_USER.
Para reverter às entradas de HKEY_LOCAL_MACHINE, desmarque Usar Minhas Configurações e clique em Aplicar.
A caixa de opção Usar Minhas Configurações é uma entrada armazenada em HKEY_CURRENT_USER como DEFAULT_USER_SETTING e pode ser LM para máquina local (padrão) ou CU para usuário atual. 


Configurando Informações do Servidor de Banco de Dados


Um aplicativo cliente se conecta a um servidor de banco de dados Informix em execução em um computador que pode ser acessado por meio de uma rede. Para estabelecer a conexão, utilize Setnet32 para especificar o local do servidor de banco de dados Informix na rede e o protocolo de comunicação de rede a ser usado. Essas informações devem ser obtidas com o administrador do servidor de banco de dados que deseja utilizar.
Para configurar as informações do servidor de banco de dados: 

  1. Dê um clique duplo em Setnet32 na pasta que contém os produtos Client SDK.
    A janela Informix Setnet32 é aberta.
  2. Clique na guia Informações do Servidor para exibir a página Informações do Servidor, que tem os seguintes elementos:
    • Servidor Informix

Selecione um servidor de banco de dados Informix existente ou digite o nome de um novo servidor de banco de dados.

    • Nome do Host

Selecione o computador host com o servidor de banco de dados que deseja utilizar ou digite o nome de um novo computador host.

    • Nome do Protocolo

Selecione um protocolo de rede a partir de uma lista de protocolos fornecida pelo procedimento de instalação.

    • Nome do Serviço

Especifique o nome do serviço que está associado a um servidor de banco de dados específico. Digite o nome do serviço ou o número da porta que está associado ao servidor de banco de dados no computador host. Essas informações devem ser obtidas com o administrador do servidor de banco de dados. 

Requisito
Ao inserir um nome de serviço, é necessário que ele esteja definido no computador cliente no arquivo services no diretório de instalação do Windows. Esse arquivo está localizado em system32\drivers\etc\services. A definição de serviço deve corresponder à definição no computador host do servidor de banco de dados. 

    • Opções

Insira opções específicas do servidor de banco de dados. 

    • Escolher como Servidor Padrão

Configura a variável de ambiente INFORMIXSERVER com o nome do servidor de banco de dados atual para torná-lo o servidor de banco de dados padrão.

    • Excluir Servidor

Exclui a definição de um servidor de banco de dados do registro do Windows. Também exclui o nome do host, o nome do protocolo e o nome do serviço associados a esse servidor de banco de dados. 

3. Clique em OK para salvar os valores.


Configurando Informações do Host


Um aplicativo cliente só pode fazer conexões com um computador host que possa ser acessado por meio da rede. Uma conexão com um computador host é descrita especificando parâmetros de host. 
Para configurar as Informações do Host: 


  1. Dê um clique duplo em Setnet32 na pasta que contém os produtos Client SDK.
    A janela IBM® Informix Setnet32 é aberta. 

  2. Clique na guia Informações do Host para exibir a página Informações do Host, que tem os seguintes elementos:

Este campo exibe os computadores host definidos anteriormente no registro do Windows atual. Selecione o nome de um computador host com o qual estabelecer uma conexão de rede ou edite ou redigite um nome na lista para definir um novo nome de host. 

Este campo exibe o nome de usuário de uma conta no computador host atualmente selecionado. Essa caixa de texto aceita um valor, com distinção entre maiúsculas e minúsculas, com comprimento máximo de 18 caracteres. 

Selecione uma das seguintes opções de senha: 

Solicitar Senha no Tempo de Execução
O aplicativo solicita uma senha ao usuário. Para obter informações sobre como usar a função sqlauth()para solicitar uma senha e verificá-la, consulte o IBM Informix ESQL/C Programmer's Manual. 
Nenhuma senha
A conta do usuário não possui senha. Quando o aplicativo abre um novo banco de dados, esse aplicativo não envia uma senha para o servidor de banco de dados. Se o computador host do servidor de banco de dados solicitar uma senha, a conexão falhará e você receberá um erro. 

Senha
A conta do usuário possui uma senha que corresponde ao valor criptografado exibido pela caixa de texto Senha. Quando o aplicativo abre um novo banco de dados, o servidor de banco de dados compara a senha inserida pelo usuário com a senha de login do computador host do servidor de banco de dados. Se as senhas não forem idênticas, o usuário não poderá se conectar ao servidor de banco de dados por meio de uma rede. 


Este campo, ativado pela opção Senha, exibe asteriscos ( * ) que representam a senha da conta. Quando ativado, esse campo aceita um valor de senha com um comprimento máximo de 18 caracteres. O valor faz distinção entre maiúsculas e minúsculas e não pode conter espaços.

Para inserir uma nova senha, posicione o cursor dentro da caixa de texto Senha e digite a nova senha. Os asteriscos ( * ) representam os caracteres digitados. 

Clique em Excluir Host para excluir do registro do Windows o nome do computador host atualmente selecionado e o nome de usuário, a opção de senha e a senha associados a esse computador host. 

Dicas

Através do puty, na linha de comando do Linux ao digitar o seguinte comando: "vim /usr/local/tomcat/conf/context.xml "
Será possível obter os dados necessários ao setnet32. 
Exemplo do "context.xml" 


 
Obs.: no campo password digitar a senha válida. 

Exemplos das Telas

 


 

Para configurar as variáveis de ambiente Windows, parametrizando o caminho onde se encontra instalado o Client SDK IBM® Informix, acessar as Propriedades do Computador, Configurações avançadas do sistema, 

 

E acrescentar nas variáveis de sistema, a nova variável, sendo:
Nome da variável: INFORMIXDIR
Valor da variável: C:\IBM\Informix 
Obs.: valor da variável sendo um dos caminhos abaixo:
C:\IBM\Informix ou
C:\INFORMIX\Client-SDK ou
C:\Arquivos de programas\IBM\Informix\Client-SDK ou
C:\Program Files\IBM\Informix\Client-SDK ou
C:\Program Files (x86) \IBM\Informix\Client-SDK ou
C:\Arquivos de programas (x86) \IBM\Informix\Client-SDK 


 


Tratamento de Possíveis Erros

Primeiramente deve-se garantir que o client do Informix esteja instalado em uma das seguintes pastas: 
"C:\IBM\INFORMIX ou
C:\INFORMIX\Client-SDK ou
C:\Arquivos de programas\IBM\Informix\Client-SDK ou
C:\Program Files\IBM\Informix\Client-SDK ou
C:\Program Files (x86) \IBM\Informix\Client-SDK ou
C:\Arquivos de programas (x86) \IBM\Informix\Client-SDK" 

Configuração abaixo aplica-se somente para Windows 64bits
Conferir se o registro do Informix está correto em "C:\Windows\Microsoft.NET\Framework\v2.0.50727\CONFIG\machine.config":
a) Abrir no Bloco de Notas o arquivo citado.
b) procurar o texto "<DbProviderFactories>".
c) Verificar se entre "<DbProviderFactories>" e "</DbProviderFactories>" existe o bloco de informações abaixo. Se não existir, incluir. 
<add name="IBM Informix .NET Data Provider" invariant="IBM.Data.Informix" description="IBM Informix Data Provider for .NET Framework 2.0" type="IBM.Data.Informix.IfxFactory, IBM.Data.Informix, Version=3.0.0.2, Culture=neutral, PublicKeyToken=7c307b91aa13d208" /> 

d) Verificar se entre "<runtime>" e "</runtime>" existe o bloco de informações abaixo. Se não existir, incluir. RESPEITANDO O CAMINHO CORRETO ONDE SE ENCONTRA INSTALADO O CLIENT DO INFORMIX.

 <runtime>

    <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1" appliesTo="v2.0.50727">

            <dependentAssembly xmlns="urn:schemas-microsoft-com:asm.v1">

                  <assemblyIdentity name="IBM.Data.Informix" publicKeyToken="7c307b91aa13d208" culture="" />

            <bindingRedirect oldVersion="2.81.0.0" newVersion="3.0.0.2" />

            </dependentAssembly>

      <dependentAssembly xmlns="urn:schemas-microsoft-com:asm.v1">

        <assemblyIdentity name="IBM.Data.Informix.3.0.0" publicKeyToken="7c307b91aa13d208" culture="" />

        <bindingRedirect oldVersion="2.81.0.0" newVersion="3.0.0.2" />

        <codeBase version="3.0.0.2" href="C:\IBM\Informix\Client-SDK\bin\netf20\specific\IBM.Data.Informix.3.0.0.dll" />

      </dependentAssembly>

    </assemblyBinding>

</runtime>