Configurando um Provedor JDBC para Conexões Tipo 4

Utilize o comando mqsicreateconfigurableservice ou mqsichangeproperties para configurar um serviço de provedor JDBC.

Antes de começar:
Ao incluir um nó DatabaseRetrieve, DatabaseRoute, JavaCompute, ou Java definido pelo usuário em um fluxo de mensagens e interagir com um banco de dados nesse nó, o broker deve estabelecer uma conexão com o banco de dados para completar as operações executadas pelo nó. Você deve definir um serviço configurável JDBCProvider para fornecer ao broker as informações que precisa para concluir a conexão.

Um serviço configurável JDBCProvider suporta conexões apenas para um banco de dados; você deve criar um serviço para cada banco de dados conectado por seus aplicativos Java.

  1. Identifique o tipo de banco de dados para o qual é necessário um serviço JDBCProvider.

    Os drivers JDBC e bancos de dados suportados são mostrados em Bancos de Dados Suportados; o suporte para transações coordenadas globalmente (XA) é restrito em algumas plataformas e para alguns bancos de dados.

  2. Execute o comando mqsireportproperties para visualizar a lista de serviços JDBCProvider disponíveis. Substitua o nome de seu broker no lugar de broker_name.
    mqsireportproperties broker_name -c JDBCProviders -a -o AllReportableEntityNames

    A resposta do comando lista todos os serviços configuráveis JDBCProvider que estão definidos. Se você não tiver criado suas próprias definições, a seguinte lista de serviços padrão fornecidos será mostrada:

    • DB2
    • Informix
    • Informix_With_Date_Format
    • Microsoft_SQL_Server
    • Oracle
    • Sybase_JConnect6_05

    Se estiver conectado a um banco de dados Informix:

    • Use Informix_With_Date_Format para compatibilidade com aplicativos clientes dependentes do atributo de conexão de formato de data que foi utilizado por versões anteriores dos servidores Informix.
    • Utilize Informix para aplicativos clientes que não dependem do atributo de formato de data.
  3. Visualize o conteúdo da definição de serviço JDBCProvider relevante. Por exemplo, execute o seguinte comando para exibir a definição Oracle fornecida:
    mqsireportproperties broker_name -c JDBCProviders -o Oracle -r

    A resposta do comando lista todas as propriedades para a definição do Oracle. Se não tiver alterado essa definição, as propriedades são configuradas para valores iniciais, alguns dos quais você deve alterar para criar uma definição viável. Por exemplo, a propriedade databaseName está configurada como default_Database_Name e você deve alterá-la para identificar o banco de dados específico ao qual deseja se conectar.

    Um serviço JDBCProvider possui as seguintes propriedades:

    • connectionUrlFormat. Um padrão que representa a definição da conexão URL, que é específica para um tipo de banco de dados particular. Por exemplo, o padrão para DB2 é definido com o seguinte conteúdo:
      jdbc:db2://[serverName]:[portNumber]/[databaseName]:user=[user];password=[password];

      O padrão é utilizado e concluído pelo broker no tempo de execução quando ele se conecta ao banco de dados. Os valores entre colchetes, por exemplo [serverName], são substituídos pelo broker para o padrão usando os valores especificados nos comandos mqsicreateconfigurableservice, mqsichangeproperties ou mqsisetdbparms.

      Os valores e a ordem de preferência a seguir são usados pelo broker para substituir o ID do usuário e a senha no padrão:

      1. Primeiro, em todas as plataformas: O ID do usuário e a senha que você configurou para o banco de dados específico, usando o mqsisetdbparms e especificando o banco de dados no parâmetro -n.
      2. Segundo, em todas as plataformas: O ID do usuário e a senha que você configurou para todos os outros bancos de dados, usando o mqsisetdbparms e especificando jdbc::JDBC no parâmetro -n.
      3. Terceiro, os valores são específicos da plataforma:
        1. Windows platform No Windows: O ID de serviço e a senha do broker especificados no comando mqsicreatebroker.
        2. Linux platformUNIX platform No Linux e UNIX: O ID do usuário mqsiUser e senha ******** (estes valores são fixos).
        3. z/OS platform No z/OS: O ID do usuário "" e a senha "".

      Se estiver usando um dos serviços JDBCProvider fornecidos, não use o comando mqsichangeproperties para alterar o próprio padrão; as mudanças feitas no padrão podem causar resultados imprevisíveis.

      Se você usar o comando mqsicreateconfigurableservice para definir seu próprio serviço JDBCProvider, use o comando mqsireportproperties para verificar se o conteúdo da cadeia connectionUrlFormat corresponde exatamente ao provedor padrão fornecido para o tipo de banco de dados que está sendo usado.

      Além disso, se você estiver trabalhando no z/OS e estiver usando os arquivos da JCL BIPCRCS e BIPCHPR para definir seu serviço JDBCProvider, certifique-se de que seu emulador 3270 esteja configurado para usar a mesma página de códigos na qual o broker está em execução. Se as páginas de códigos não corresponderem, o padrão de cadeia connectionUrlFormat definido pode não ser reconhecido corretamente pelo broker.

    • connectionUrlFormat Attr1-5. Se o padrão de URL definido para um banco de dados contiver propriedades da origem de dados JDBC não-padrão, como um identificador de serviço, especifique estas propriedades, além dos atributos padrão, usando um de cinco atributos de URL de conexão de propósito geral. Exemplo:
      • Se connectionURLFormat = jdbc:oracle:thin:[user]/[password]@[serverName]:[portNumber]:[connectionUrlFormatAttr1], connectionUrlFormatAttr1 deverá conter um identificador de servidor Oracle, que você deve fornecer definindo o valor para a propriedade connectionUrlFormatAttr1 no comando mqsicreateconfigurableservice ou mqsichangeproperties. O broker, então, pode substituir todos os valores necessários no padrão exigido.
      • Se connectionURLFormat = jdbc:informix-sqli://[serverName]:[portNumber]/[databaseName]:informixserver=[connectionUrlFormatAttr1]; user=[user];password=[password], connectionUrlFormatAttr1 deverá conter o nome da instância do Informix no servidor (geralmente especificado pela variável de ambiente INFORMIXSERVER). Este valor faz distinção entre maiúsculas e minúsculas.
    • databaseName. O nome do banco de dados para o qual a entrada da origem de dados ativa conexões; por exemplo, employees.
    • databaseType. O tipo de banco de dados; por exemplo, DB2.
    • databaseVersion. A versão do banco de dados; por exemplo, 9.1.
    • description. Uma propriedade opcional para descrever a definição da origem de dados.
    • environmentParms. Apenas para DB2. Uma propriedade opcional que especifica uma lista de propriedades da origem de dados no formato name=value, cada um separado por um ponto-e-vírgula.
    • jarsURL. O caminho do diretório local no sistema em que o broker está em execução, no qual o arquivo JAR que contém a classe do driver tipo 4 está localizado.

      Além disso, um disco de Rede de Área de Armazenamento pode ser usado para o caminho do diretório, mas uma unidade de rede mapeada para um computador remoto não pode ser usada.

    • portNumber. O número da porta na qual o servidor de servidor de banco de dados está atendendo; por exemplo, 50000.
    • securityIdentity. Uma chave de segurança exclusiva para executar uma segunda consulta de registro do broker para localizar uma entrada nas identidades de segurança do broker, que armazenam a senha criptografada para o usuário no sistema host associado; por exemplo, mysecurityIdentity.

      Crie uma identidade de segurança usando o comando mqsisetdbparms, conforme descrito em Protegendo uma Conexão JDBC Tipo 4. O valor de securityIdentity (por exemplo, mysecurityIdentity) deve corresponder ao valor que você especifica após o prefixo jdbc:: para o parâmetro -n nesse comando.

      A identidade de segurança fornece um par de valores de ID do usuário e senha, que são usados para acessar a origem de dados especificada, definida para uma determinada entrada de serviço JDBCProvider. Esta propriedade será ignorada se a URL de conexão não contiver um par de ID do usuário e senha que requerem valores da propriedade para substituição para essas inserções.

      Os valores-padrão, que você pode configurar especificando um ResourceName igual a jdbc::JDBC no comando mqsisetdbparms, são usados sob as seguintes condições:

      • Se o securityIdentity estiver em branco ou se você não o tiver alterado a partir do valor padrão default_User@default_Server, mas a identidade for necessária para o padrão da URL da conexão.
      • Se você tiver inserido uma chave de identidade de segurança exclusiva válida, mas ela não puder ser encontrada sob a chave DSN.
    • serverName. O nome do servidor; por exemplo, host1.
    • type4DatasourceClassName. O nome da classe de origem de dados JDBC utilizado para estabelecer uma conexão tipo 4 com um banco de dados remoto e para suporte a transações coordenadas. Por exemplo, especifique com.ibm.db2.jcc.DB2XADataSource para DB2 ou especifique oracle.jdbc.xa.client.OracleXADataSource para Oracle. É necessário especificar sempre o nome da classe XA, mesmo se não utilizar transações coordenadas.
    • type4DriverClassName. O nome da classe do driver JDBC tipo 4 usado para estabelecer uma conexão. Por exemplo, especifique com.ibm.db2.jcc.DB2Driver para DB2 ou especifique oracle.jdbc.OracleDriver para Oracle.
  4. Se desejar usar a definição fornecida, execute o comando mqsichangeproperties para substituir valores-padrão por valores específicos de seu banco de dados e ambiente. Se tiver qualquer dúvida sobre os valores necessários, consulte o administrador do seu banco de dados ou verifique a documentação fornecida com o banco de dados que você escolheu. Alguns valores dependem de como e onde você instalou o produto do banco de dados; por exemplo, a propriedade jarsURL identifica o local dos arquivos JAR fornecidos e instalados pelo provedor de banco de dados.
  5. Se desejar criar um novo serviço configurável, talvez porque você deseja manter o serviço fornecido como um modelo para definições futuras, execute o comando mqsicreateconfigurableservice para criar a definição.
    mqsicreateconfigurableservice broker_name -c JDBCProviders -o provider_name 
    -n list of properties -v list of values

    Insira o comando em uma única linha; o exemplo foi dividido para melhorar a capacidade de leitura.

    Especifique todas as propriedades que são necessárias para o provedor de banco de dados escolhido. Para especificar uma lista de propriedades e valores, separe os itens após cada sinalizador com uma vírgula. Por exemplo, -n databaseName,databaseType -v EmployeeDB,DB2. Se você não especificar todas as propriedades no comando mqsicreateconfigurableservice, é possível atualizá-las posteriormente com o comando mqsichangeproperties.

  6. Quando tiver configurado seu serviço JDBCProvider, você deve parar e reiniciar o broker.
A seguir: se necessário, configure a segurança para a conexão JDBC, configure o ambiente para incluir o serviço JDBCProvider em transações coordenadas globalmente, ou ambos.
Avisos | Marcas | Este link é aberto em uma nova janela Downloads | Este link é aberto em uma nova janela Biblioteca | Este link é aberto em uma nova janela Suporte | Feedback

Copyright IBM Corporation 1999, 2011Copyright IBM Corporation 1999, 2011.

        
        Última atualização
        
        Última atualização : 2011-11-09 14:39:20


Tópico de TarefaTópico de Tarefa | Versão 8.0.0.0 | ah61310_