Utilizando o DB2 Universal JDBC Driver Para Acessar o DB2 Para z/OS

O sistema operacional z/OS requer a configuração do DB2 Universal JDBC Driver e de seu banco de dados para garantir interoperabilidade. No WebSphere Application Server, configure um objeto de provedor Java™ Database Connectivity (JDBC) e um objeto de origem de dados para implementar os recursos de driver para seus aplicativos.

Antes de Iniciar

As versões disponíveis do DB2 Universal JDBC Driver para se conectar ao DB2 no z/OS são as seguintes:
  • O DB2 Universal JDBC Driver no DB2 UDB para z/OS Versão 8. Esta versão suporta o driver Tipo 2 e 4.
  • O DB2 Universal JDBC Driver para DB2 UDB para OS/390 e z/OS Versão 7, como documentado no APAR PQ80841. Esta versão suporta ambos os Tipos de driver 2 e 4.
  • O DB2 Universal JDBC Driver com o recurso z/OS Application Connectivity para DB2 para z/OS, que fornece apenas conectividade para o Tipo 4. Se você instala essa versão do driver, deve configurar um provedor DB2 Universal JDBC Driver (XA) para acessar bancos de dados DB2 remotos.
Consulte as atualizações de serviço do DB2 para obter os aprimoramentos disponíveis na versão usada.
Dica de Migração: Se estiver substituindo o DB2 para 390 e o driver JDBC herdado do z/OS pelo DB2 Universal JDBC Driver, poderá migrar suas configurações de provedor JDBC existentes. Consulte o tópico Migrando do Driver JDBC/SQLJ no OS/390 e z/OS para o DB2 Universal JDBC Driver no Centro de Informações do Information Management Software para z/OS Solutions, para obter informações adicionais.

Procedimento

  1. Instale os arquivos de classe do driver e quaisquer arquivos nativos necessários em um diretório HFS disponível.

    Arquivos nativos são arquivos de classe que algumas versões do DB2 Universal JDBC Driver requerem para execução no sistema operacional z/OS.

  2. Configure o driver e o banco de dados para interoperabilidade
    1. Ligue os pacotes DB2 requeridos

      Para qualquer aplicativo que executar instruções SQL no DB2 para z/OS, o Driver Universal JDBC deverá primeiro ser ligado aos pacotes do DB2 que representam as instruções SQL a serem executadas.

      Os detalhes específicos do utilitário de ligação e do processo de ligação são descritos no arquivo leia-me fornecido com o DB2 Universal JDBC Driver instalado. Consulte esse arquivo leia-me para obter detalhes sobre como configurar e executar a ligação necessária.

      O utilitário requer o nome do servidor ou o endereço IP, o número da porta e o nome do banco de dados (o local do banco de dados no z/OS) do DB2 de destino. Para obter estas informações, emita um comando DB2 -DISPLAY DDF no sistema DB2 de destino. O comando exibe o IPADDR (endereço IP), o SQL DOMAIN (nome do servidor), o número TCPPORT e o LOCATION (nome/local do banco de dados) para serem usados como entrada para o utilitário.

      Você deve executar o processo de ligação para cada DB2 de destino que for acessado usando o DB2 Universal JDBC Driver.

    2. Configure para manipular transações duvidosas

      Execute essa configuração uma vez para cada local de destino do DB2 para z/OS Versão 7 que for acessado usando o suporte ao DB2 Universal JDBC Driver Tipo 4 XA.

      O DB2 para z/OS Versão 7 não implementa o suporte Java Platform, Enterprise Edition (Java EE) XA, portanto, o processamento XA do driver Tipo 4 usa o protocolo two-phase commit DB2 V7 e uma tabela em cada local (banco de dados) para armazenar uma lista de transações globais que estão em dúvida ou finalizados, mas não confirmados.

      Essa tabela deve ser configurada em cada local do DB2 V7 que é acessado. Para executar a configuração, use o utilitário In-Doubt, incluído como parte do DB2 Universal JDBC Driver instalado. O utilitário cria a Tabela SYSIBM.INDOUBT que armazena as informações sobre as Transações Globais Duvidosas. Esse utilitário também liga o pacote T4XAIndbtPkg, que contém as instruções SQL para inserir e excluir a partir d a Tabela SYSIBM.INDOUBT. O pacote T4XAIndbtPkg é gravado com SQLJ.

      Esse processo de instalação requer que o subsistema DB2 de destino seja configurado com o DDF ativado para conexões TCP/IP recebidas.
      1. Para ativar o DDF no DB2 de destino, emita o comando DB2 -START DDF nesse sistema.
      2. Esse utilitário requer o nome do servidor ou o endereço IP e o número da porta para o DB2 V7 de destino. Para obter essas informações, emita um comando DB2 -DISPLAY DDF no sistema DB2 V7 de destino. O IPADDR (endereço IP), o SQL DOMAIN (nome do servidor) e o número TCPPORT que podem ser usados como entrada para o utilitário são exibidos.

      Para localizar informações mais detalhadas sobre o utilitário In-Doubt, consulte a publicação DB2 Universal Database for z/OS Version 7 Application Programming Guide and Reference for JavaTM. É possível fazer download dele na seção de Biblioteca das páginas da Web de informações do produto DB2 Universal Database for z/OS Versão 7. Nessa publicação, procure a discussão sobre o utilitário sob DB2T4XAIndoubtUtil, que é o nome oficial do utilitário In-Doubt.

      Nota: A configuração descrita anteriormente nas transações do utilitário in-doubt não são requisito para os servidores DB2 para z/OS Versão 8 porque o DB2 para z/OS Versão 8 suporta, nativamente, comandos XA em DRDA e gerencia transações globais In-Doubt internamente.
    3. Defina um db2.jcc.propertiesFile

      Um db2.jcc.propertiesFile para uso pelo processamento do DB2 Universal JDBC Driver Tipo 2 no WebSphere Application Server para z/OS pode ser criado e especificado como entrada para o driver. Esse arquivo de propriedades de tempo de execução deve ser usado ao especificar várias opções de tempo de execução que o DB2 Universal JDBC Driver usa para a conectividade do Tipo 2. Essas opções são especificadas como propriedades no formato parâmetro=valor. Consulte o arquivo LEIA-ME enviado com o DB2 Universal JDBC Driver instalado para obter uma descrição detalhada de cada uma das propriedades.

      Esse arquivo não é requerido; no entanto, se não for fornecido, o processamento padrão do driver universal é executado.

      De interesse específico é a propriedade db2.jcc.ssid. Essa propriedade especifica o identificador do subsistema DB2 (não o nome do local), a ser usado pelo processamento do DB2 Universal JDBC Driver Tipo 2 como o nome do subsistema local ao qual ele se conectará. Se essa propriedade não for fornecida, o driver utiliza o identificador do subsistema localizado no módulo de carregamento DSNHDECP. Se a instalação quiser usar o módulo de carregamento DSNHDECP para especificar o identificador do subsistema, esse módulo de carregamento deverá ser incluído em um conjunto de dados steplib nos PROCs da região servidora associados a cada servidor que usar o DB2 identificado pelo ID do subsistema. Consulte o arquivo leia-me fornecido com o driver universal para obter informações adicionais sobre como usar esse módulo de carregamento. Se esse módulo de carregamento DSNHDECP não refletir com exatidão o subsistema desejado, ou se múltiplos subsistemas puderem usar um DSNHDECP genérico, a propriedade db2.jcc.ssid deverá ser especificada.

      Embora o db2.jcc.propertiesFile não seja necessário, se você optar por definir o arquivo, deverá especificar o nome de arquivo HFS completo como uma propriedade de Sistema JVM, da seguinte forma:
      • db2.jcc.propertiesFile = <fully-qualified-hfs-filename>
      As propriedades gerais do driver são normalmente específicas de um carregamento de driver, por exemplo, servidor, em vez de todos os servidores que usam o provedor JDBC, portanto, é melhor configurar essa propriedade JVM no nível do servidor. Para definir a propriedade db2.jcc.propertiesFile= no nível do servidor usando o console administrativo do WebSphere Application Server para z/OS:
      1. No console administrativo do WebSphere Application Server para z/OS, acesse Servidores > Servidores de Aplicativos e, em seguida, clique no servidor no qual você deseja incluir a propriedade JVM.
      2. Na página do servidor selecionada, expanda Java e Gerenciamento de Processo e clique em Definição do Processo > Servidor.
      3. Na página Servant, clique em Propriedades Adicionais, depois clique em Java Virtual Machine.
      4. Na página Java Virtual Machine, clique em Propriedades Adicionais e clique em Propriedades Customizadas.
      5. Na página Propriedades Customizadas, role para baixo e clique em Novo para configurar uma nova propriedade da JVM para o servidor selecionado. O nome da propriedade é db2.jcc.propertiesFile. O valor da propriedade é o nome do arquivo HFS completo criado e inicializado com as propriedades do DB2 Universal JDBC Driver. O driver Tipo 2 usa essas propriedades para o servidor selecionado
      6. Clique em OK.
      7. Clique em Salvar para salvar a nova propriedade da JVM.
  3. Defina um provedor JDBC para o DB2 Universal JDBC Driver. O objeto do provedor JDBC encapsula as classes do driver para implementação no WebSphere Application Server.
    1. No WebSphere Application Server para console administrativo doz/OS, clique em Recursos > JDBC > Provedores JDBC.
    2. Selecione o escopo no qual aplicativos podem usar o provedor JDBC. Esse escopo torna-se o escopo de qualquer origem de dados que você associar a esse provedor. Você pode escolher uma célula, nó, cluster ou servidor. Para obter informações adicionais, consulte o tópico Configurações do Escopo do Console Administrativo.
    3. Clique em Novo. Essa ação faz com que o assistente Criar um Novo Provedor JDBC seja ativado.
    4. Use a primeira lista drop-down para selecionar o DB2 para z/OS como seu tipo de banco de dados.
    5. Selecione o provedor DB2 Universal JDBC Driver como seu tipo de provedor JDBC na segunda lista drop-down.
    6. A partir da terceira lista suspensa, selecione o tipo de implementação necessário para seu aplicativo.
      Se seu aplicativo não precisar que as conexões suportem transações two-phase commit e você planejar usar a conectividade do tipo 4, escolha Origem de Dados do Conjunto de Conexões. Se você usar a origem de dados do conjunto de conexões com a conectividade do tipo 2, no entanto, o servidor de aplicativos em z/OS usará RRS para processar as transações one-phase e two-phase.
      Restrição: Não selecione Origem de Dados do Conjunto de Conexões se sua instalação tiver o recurso z/OS Application Connectivity do DB2 para z/OS definido para o WebSphere Application Server para z/OS. Somente a implementação XA do DB2 Universal JDBC Driver suporta esse recurso.

      Escolha Origem de Dados XA, se você planejar utilizar o driver do tipo 4 e seu aplicativo precisar de conexões que suportem transações two-phase commit. Utilize apenas a conectividade driverType 4 para a origem de dados XA.

      Após selecionar um tipo de implementação, o assistente preenche o nome e os campos de descrição para seu provedor JDBC. Você pode digitar valores diferentes para esses campos; eles existem somente para propósitos administrativos.

    7. Clique em Avançar após ter definido seu tipo de banco de dados, tipo de provedor e tipo de implementação. Agora, você vê a página do assistente Digitar Informações do Caminho de Classe do Banco de Dados.

      Geralmente, você não precisa alterar o caminho de classe que já preenche o campo. (Esse caminho de classe é o valor da variável de ambiente WebSphere exibida nesta página, no formato ${DATABASE_JDBC_DRIVER_PATH}.) É muito provável que você não precise alterar o caminho da biblioteca nativa ou o nome da classe de implementação da origem de dados.

    8. Clique em Avançar para ver um resumo de suas configurações do provedor JDBC.
    9. Clique em Concluir se estiver satisfeito com toda a configuração do provedor JDBC. A página Coleta de Provedores JDBC é exibida, mostrando seu novo provedor JDBC em uma tabela, juntamente com outros provedores configurados para o mesmo escopo.
  4. Defina uma origem de dados. O WebSphere Application Server usa o objeto de origem de dados para obter conexões do banco de dados e gerenciar essas conexões.
    1. No console administrativo do WebSphere Application Server para z/OS, acesse a página da versão de origem de dados que seus aplicativos requerem. Se você precisar de suporte para as transações de duas fases, utilize apenas a origem de dados da última versão padrão. A origem de dados da Versão 4 não suporta conexões que participem das transações de duas fases.
      Navegue até a página apropriada em uma de duas maneiras:
      • Clique em Recursos > JDBC > Origens de Dados, ou Origens de Dados (WebSphere Application Server Versão 4).
      • Clique em Recursos > JDBC > Provedores JDBC > JDBC_provider > Origens de Dados ou Origens de Dados (WebSphere Application Server Versão 4).
    2. Selecione o escopo no qual aplicativos podem usar a origem de dados. É possível escolher uma célula, nó, cluster ou servidor. Para obter informações adicionais, consulte o tópico Configurações do Escopo do Console Administrativo.
      Apenas Versão 4: Deste ponto em diante, as etapas para criar origens de dados (WebSphere Application Server Versão 4) diferem das etapas para criar origens de dados da versão padrão mais recente. Para configurar uma origem de dados da Versão 4, conclua as seguintes etapas:
      • Clique em Novo para continuar na página de console para definir as propriedades necessárias.
      • Nesta página de propriedades, especifique os valores para os campos que estão agrupados sob o título Configuração. O Application Server requer estas propriedades para implementar suas classes de driver JDBC; consulte o tópico, Configurações Necessárias Mínimas de Origem de Dados, pelo fornecedor para aprender sobre os valores aceitos.
      • Salve a sua configuração, clicando em OK. Agora, você concluiu as principais tarefas de configuração de origem de dados.
      • Opcional: Defina propriedades adicionais suportadas pelo provedor DB2 Universal JDBC. O Application Server as denomina propriedades customizadas e requer que também as configure na origem de dados. Comece clicando no link Propriedades Customizadas que agora é exibido na página do console administrativo. É possível aprender sobre propriedades opcionais da origem de dados no Guia de Programação de Aplicativo e Referência para Java da sua versão do DB2 para z/OS.
    3. Clique em Novo. Esta ação faz com que o assistente Criar uma Origem de Dados ative e exiba a página Digitar Informações Básicas da Origem de Dados. O primeiro campo é o campo do escopo, que é de leitura. Esse campo exibe a seleção de escopo anterior.
    4. Digite um nome de origem de dados no campo Nome da Origem de Dados. Esse nome identifica a origem de dados somente para propósitos administrativos.
    5. Digite um nome JNDI (Java Naming and Directory Interface) no campo de nome JNDI. O WebSphere Application Server usa o nome de JNDI para ligar referências de recursos de aplicativos a esta origem de dados. Para obter informações adicionais sobre JNDI, consulte o tópico Nomenclatura.
    6. Configure um alias gerenciado por componente para proteger sua origem de dados, se planeja implementar a conectividade do driver Tipo 4 com o DB2 Universal JDBC Driver. Se planeja usar a conectividade driverType 2, você não deve configurar um alias. Neste caso, o gerenciador de conexão utiliza um alias de autenticação padrão, que é a identidade do usuário de um encadeamento quando este encadeamento entregar um pedido getConnection.

      Um alias gerenciado por componente consiste em um ID e uma senha que são especificados em um aplicativo para autenticação da origem de dados. Portanto, o alias configurado na origem de dados deve ser idêntico ao alias do código do aplicativo. Para obter informações adicionais sobre a segurança Java 2 Connector (J2C), consulte o tópico Gerenciando Entradas de Dados de Autenticação do Java 2 Connector Architecture.

      Para configurar um alias gerenciado por componente, selecione um alias existente ou crie um novo.

      • Utilize a lista drop-down para selecionar um alias de autenticação gerenciado por componente existente.
      • Para criar um alias, clique no link criar um novo. Esta ação fecha o assistente de origem de dados e aciona o console administrativo para exibir a página Coleta de Dados de Autenticação J2C. Clique em Novo para definir um novo alias. Clique em OK para salvar suas configurações e visualizar o novo alias na página Coleta de Dados de Autenticação J2C. Reinicie o assistente de origem de dados navegando de volta à pagina de coleta de origem de dados, selecionando o escopo apropriado e clicando em Novo.
    7. Clique em Avançar para ver a página do assistente Selecionar Provedor JDBC.
    8. Selecione um provedor JDBC existente ou crie um provedor.
      Para selecionar um provedor JDBC existente:
      1. Clique em Selecionar um provedor JDBC existente.
      2. Selecione um driver JDBC na lista drop-down.
      3. Clique em Next. Agora, você vê a página com o título Inserir Propriedades Específicas do Banco de Dados para a Origem de Dados.
      Para criar um provedor JDBC:
      1. Clique em Criar Novo Provedor JDBC.
      2. Clique em Avançar para ver a página Criar Provedor JDBC.
      3. Use a primeira lista drop-down para selecionar o DB2 para z/OS como seu tipo de banco de dados.
      4. Selecione o provedor DB2 Universal JDBC Driver como seu tipo de provedor JDBC na segunda lista drop-down.
      5. A partir da terceira lista drop-down, selecione o tipo de implementação necessário para seu aplicativo.
        Se seu aplicativo não precisar que as conexões suportem transações de consolidação em duas fases, escolha Origem de Dados do Pool de Conexão. As implementações da conectividade do driver Tipo 2 e Tipo 4 do DB2 Universal JDBC Driver suportam origens de dados do conjunto de conexões.
        Restrição: Não selecione este provedor se sua instalação tiver o recurso z/OS Application Connectivity do DB2 para z/OS definido para o WebSphere Application Server para z/OS. Somente a implementação XA do DB2 Universal JDBC Driver suporta esse recurso.

        Escolha Origem de Dados XA, se seu aplicativo precisar de conexões que suportem transações two-phase commit. Os aplicativos que utilizam esta configuração de origem de dados têm o benefício de recuperação de transação gerenciada por contêiner. Utilize apenas a conectividade driverType 4 para a implementação XA.

        Após selecionar um tipo de implementação, o assistente preenche o nome e os campos de descrição para seu provedor JDBC. É possível digitar valores diferentes para esses campos; eles existem somente para propósitos administrativos.

      6. Clique em Avançar após ter definido seu tipo de banco de dados, tipo de provedor e tipo de implementação. Agora, você vê a página do assistente Digitar Informações do Caminho de Classe do Banco de Dados.

        Geralmente, você não precisa alterar o caminho de classe que já preenche o campo. (Este caminho de classe é o valor da variável de ambiente WebSphere exibida nesta página, no formato ${DATABASE_JDBC_DRIVER_PATH}.) É muito provável que você não precise alterar o caminho da biblioteca nativa ou o nome da classe de implementação da origem de dados.

      7. Clique em Next. Agora, você vê a página com o título Inserir Propriedades Específicas do Banco de Dados para a Origem de Dados.
    9. Clique em Utilizar esta Origem de Dados em CMP (Container Managed Persistence) se os beans corporativos CMP (Container Managed Persistence) precisarem acessar esta origem de dados.
    10. Especifique todas as propriedades restantes, já que elas são necessárias para implementação do DB2 Universal JDBC Driver. Estas propriedades incluem:
      • Nome do banco de dados, que é o nome do local do banco de dados de destino utilizado ao estabelecer conexões com esta origem de dados
      • driverType, qual é o tipo de conectividade JDBC utilizado pela origem de dados
      • Nome do servidor, que é o endereço TCP/IP ou o nome do host do servidor Distributed Relational Database Architecture (DRDA).

        Essa propriedade é necessária somente se o driverType estiver configurado para 4. Essa propriedade não é usada se driverType estiver configurado para 2.

      • Número da porta, que é o número da porta TCP/IP na qual o servidor DRDA reside.

        Forneça um valor para esta propriedade apenas se driverType estiver definido como 4. Não configure esta propriedade, se driverType estiver configurado como 2.

    11. Clique em Concluir para salvar a configuração e sair do assistente. A página Coleta de Origem de Dados é exibida, mostrando sua nova configuração em uma tabela, juntamente com outras origens de dados configuradas para o mesmo escopo.

O que Fazer Depois

É possível substituir os valores padrão para algumas propriedades da origem de dados. Clique no novo link da origem de dados na tabela para visualizar a página de configuração geral para obter as propriedades da origem de dados necessária. Você também pode definir propriedades adicionais suportadas pelo DB2 Universal JDBC Driver. O Application Server requer que você as configure como propriedades customizadas na origem de dados. Aprenda sobre propriedades opcionais da origem de dados no Guia de Programação de Aplicativo e Referência para Java da sua versão do DB2 for z/OS.

Ícone que indica o tipo de tópico Tópico de Tarefa



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tdat_jdbcdb2cfg
Nome do arquivo: tdat_jdbcdb2cfg.html