[z/OS]

Configurações mínimas necessárias de fonte de dados para DB2 no z/OS e um servidor de aplicativos no z/OS

Essas propriedades variam de acordo com os requisitos do fornecedor do banco de dados para implementações do driver JDBC. É necessário configurar as propriedades apropriadas em cada origem de dados configurada. Essas configurações são para uma fonte de dados do DB2® que está em execução no z/OS® e serão acessadas por aplicativos em um servidor de aplicativos que também está em execução no z/OS.

É possível configurar os seguintes tipos de provedores:
  • DB2 Usando IBM Driver JCC

    Este provedor é um provedor de JCC de one-phase commit para DB2 que usa o IBM Data Server Driver for JDBC and SQLJ. O driver IBM Data Server Driver for JDBC and SQLJ é a próxima geração do driver DB2 Universal JDBC . As fontes de dados que você cria sob esse provedor suportam apenas o processamento de commit de 1 fases, a menos que você use o driver tipo 2 JDBC com o servidor de aplicativos para z/OS. Se você executar o servidor de aplicativos no z/OS com o driver tipo 2, o driver usa RRS e suporta processamento de confirmação de 2 fases.

    Esse provedor:
    • É configurável em nós da versão 7.0 e posterior
    • Suporta a seguinte origem de dados de uma fase:
      com.ibm.db2.jcc.DB2ConnectionPoolDataSource
    • Requer os seguintes arquivos do driver JDBC:
      • db2jcc4.jar -Este é o arquivo .jar do IBM Data Server Driver for JDBC and SQLJ . Configurar a variável de caminho DB2_JCC_DRIVER_PATH para apontar para o arquivo db2jcc4.jar. Depois de instalar o DB2, você pode encontrar este arquivo .jar no diretório DB2 java . Para o suporte ao driver tipo 4 JDBC a partir de uma máquina cliente onde o DB2 não está instalado, copie este arquivo para a máquina local. Se você instalar alguma correção ou upgrades para DB2, você deve atualizar este arquivo também.
      • db2jcc_license_cu.jar -Este é o arquivo de licença IBM Data Server Driver for JDBC and SQLJ que permite o acesso ao banco de dados DB2 . Utilize esse arquivo .jar ou o próximo para obter acesso ao banco de dados. Esse arquivo .jar é fornecido com o servidor de aplicativos em um diretório definido pela variável de ambiente UNIVERSAL_JDBC_DRIVER_PATH.
      • db2jcc_license_cisuz.jar -Este é o arquivo de licença IBM Data Server for JDBC e SQLJ que permite o acesso aos seguintes bancos de dados:
        • DB2 Banco de Dados para Linux®, UNIX e Windows
        • DB2 para iSeries
        • DB2 for z/OS
        • DB2 para VM e VSE

        db2jcc_license_cisuz.jar não é fornecido com o servidor de aplicativos. Coloque esse arquivo no mesmo diretório do arquivo db2jcc4.jar, para que DB2_JCC_DRIVER_PATH aponte para ambos os arquivos.

      • Os arquivos nativos que são requeridos pelo IBM Data Server Driver for JDBC and SQLJ no servidor de aplicativos. Eles são necessários apenas quando o driverType é configurado para 2.
    • Utiliza os seguintes caminhos de classe:
      ${DB2_JCC_DRIVER_PATH}/db2jcc4.jar
${UNIVERSAL_JDBC_DRIVER_PATH}/db2jcc_license_cu.jar
${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar
${PUREQUERY_PATH}/pdq.jar
${PUREQUERY_PATH}/pdqmgmt.jar
      Evitar problemas: Ao especificar o caminho do diretório para ${DB2_JCC_DRIVER_PATH}, ${UNIVERSAL_JDBC_DRIVER_PATH}, and ${DB2_JCC_DRIVER_PATH} não especifique um caminho que contenha qualquer caractere especial conforme identificado na seção 2.4.3 da RFC 2396: Uniform Resource Identifiers (URI): Sintaxe Genérica
      Atenção: ${PUREQUERY_PATH}/pdq.jar e ${PUREQUERY_PATH}/pdqmgmt.jar são adicionados ao caminho de classe como uma conveniência e são necessários apenas se o provedor JDBC for usado por aplicativos pureQuery . Se você estiver usando este provedor JDBC com aplicativos pureQuery , configure a variável PUÇÃOY_PATH para o diretório onde os arquivos IBM Optim™ pureQuery Runtime JAR são armazenados.
    • Use o seguinte caminho de biblioteca nativa:
      ${DB2_JCC_DRIVER_NATIVEPATH}
      Se driverType for configurado para 2, a variável DB2_JCC_DRIVER_NATIVEPATH deve ser definida para o diretório em sua instalação do cliente DB2 que contém as bibliotecas de driver nativo. Se driverType estiver configurado como 4, o caminho nativo não será usado.
    • Requer a seguinte classe DataStoreHelper:
      com.ibm.websphere.rsadapter.DB2UniversalDataStoreHelper
    • Exige um alias de autenticação válido.
    • Requer as propriedades:
      • databaseName - Esse é um nome de banco de dados real se o driverType estiver configurado como 4, ou um nome de banco de dados catalogado localmente se o driverType estiver configurado como 2.
      • driverType - Tipo de conectividade JDBC de uma origem de dados. Há dois valores permitidos: 2 e 4. Se você quiser usar o driver tipo 2, configure este valor para 2. Se você quiser usar o tipo 4, configure este valor para 4.
      • serverName -O endereço TCP/IP ou nome do host para o servidor Distributed Relational Database Architecture™ (DRDA). Forneça um valor para essa propriedade apenas se o driverType estiver configurado como 4. Essa propriedade não é necessária se o driverType estiver configurado para 2.
      • portNumber -O número da porta TCP/IP onde o servidor DRDA reside. Forneça um valor para essa propriedade apenas se o driverType estiver configurado como 4. Essa propriedade não é necessária se o driverType estiver configurado para 2.
      • useTransactionRedirect Configure esta propriedade como uma propriedade customizada de origem de dados se o backend utilizar o Database Partitioning Feature (DPF) do e a chave de particionamento permanecer constante em toda uma transação. A ativação do imóvel afeta como o IBM Data Server Driver for JDBC and SQLJ direciona cada solicitação de conexão que inicia uma transação com DB2. O driver JDBC é acionado para enviar esses pedidos de conexão ao nó DPF que contém os dados de destino da primeira instrução direcionável na transação, se essa instrução existir. DB2 então direciona a instrução SQL para partições diferentes conforme necessário; a transação procede normalmente a partir do ponto de vista do servidor de aplicativos.

        É possível utilizar useTransactionRedirect para as origens de dados driverType 2 e driverType 4. Para configurar a propriedade, use a ferramenta de script wsadmin ou a página do console administrativo, Java™ EE provedora de recursos ou conexão de propriedades personalizadas de fábrica de conexão. Designe à propriedade o valor de true.

  • DB2 Usando IBM JCC Driver (XA)
    O DB2 Usando IBM JCC Driver (XA) é um provedor JCC de duas fases para o DB2 que usa o IBM Data Server Driver for JDBC and SQLJ. O Driver de Servidor de Dados IBM é a próxima geração do driver DB2 Universal JDBC . As origens de dados criadas nesse provedor suportam o uso de XA para a execução do processamento two-phase commit.
    Evitar problemas: Não use o driver tipo 2 JDBC no servidor de aplicativos para o z/OS.
    Esse provedor:
    • É configurável em nós da versão 7.0 e posterior.
    • Suporta a seguinte origem de dados de duas fases:
      com.ibm.db2.jcc.DB2XADataSource
    • Requer os seguintes arquivos do driver JDBC:
      • db2jcc4.jar -Este é o arquivo .jar do IBM Data Server Driver for JDBC and SQLJ . Configurar a variável de caminho DB2_JCC_DRIVER_PATH para apontar para o arquivo db2jcc4.jar. Depois de instalar o DB2, você pode encontrar este arquivo .jar no diretório Java DB2 . Para o suporte do driver tipo 4 JDBC a partir de uma máquina cliente onde o DB2 não está instalado, copie este arquivo para a máquina local. Se você instalar alguma correção ou upgrades para DB2, você deve atualizar este arquivo também. Você deve também especificar o caminho completo do arquivo db2jcc.jar como o valor da variável de ambiente DB2L_JCC_DRIVER_PATH.
      • db2jcc_license_cu.jar -Este é o arquivo de licença que permite o acesso ao banco de dados DB2 . Utilize esse arquivo .jar ou o próximo para obter acesso ao banco de dados. Esse arquivo .jar é fornecido com o servidor de aplicativos em um diretório definido pela variável de ambiente UNIVERSAL_JDBC_DRIVER_PATH.
      • db2jcc_license_cisuz.jar - Esse é o arquivo de licença que permite acesso aos seguintes bancos de dados:
        • DB2 Banco de Dados para Linux, UNIX e Windows
        • DB2 para iSeries
        • DB2 for z/OS
        • DB2 para VM e VSE

        db2jcc_license_cisuz.jar não é fornecido com o servidor de aplicativos. Coloque esse arquivo no mesmo diretório do arquivo db2jcc4.jar, para que DB2_JCC_DRIVER_PATH aponte para ambos os arquivos.

      • Os arquivos nativos que são requeridos pelo IBM Data Server Driver for JDBC and SQLJ no servidor de aplicativos. Eles são necessários apenas quando o driverType é configurado para 2.
    • Utiliza os seguintes caminhos de classe:
      ${DB2_JCC_DRIVER_PATH}/db2jcc4.jar
${UNIVERSAL_JDBC_DRIVER_PATH}/db2jcc_license_cu.jar
${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar
${PUREQUERY_PATH}/pdq.jar
${PUREQUERY_PATH}/pdqmgmt.jar
      Evitar problemas: Ao especificar o caminho do diretório para ${DB2_JCC_DRIVER_PATH}, ${UNIVERSAL_JDBC_DRIVER_PATH}, and ${DB2_JCC_DRIVER_PATH} não especifique um caminho que contenha qualquer caractere especial conforme identificado na seção 2.4.3 da RFC 2396: Uniform Resource Identifiers (URI): Sintaxe Genérica
      Atenção: ${PUREQUERY_PATH}/pdq.jar e ${PUREQUERY_PATH}/pdqmgmt.jar são adicionados ao caminho de classe como uma conveniência e são necessários apenas se o provedor JDBC for usado por aplicativos pureQuery . Se você estiver usando este provedor JDBC com os aplicativos pureQuery , configure a variável PUTADORA y_path para o diretório onde os arquivos IBM Optim pureQuery Runtime JAR são armazenados.
    • Use o seguinte caminho de biblioteca nativa:
      ${DB2_JCC_DRIVER_NATIVEPATH}
      Se driverType for configurado para 2, a variável DB2_JCC_DRIVER_NATIVEPATH deve ser definida para o diretório em sua instalação do cliente DB2 que contém as bibliotecas de driver nativo. Se driverType estiver configurado como 4, o caminho nativo não será usado.
    • Requer a seguinte classe DataStoreHelper:
      com.ibm.websphere.rsadapter.DB2UniversalDataStoreHelper
    • Exige um alias de autenticação válido.
    • Requer as seguintes propriedades:
      • databaseName - Esse é um nome de banco de dados real se o driverType estiver configurado como 4, ou um nome de banco de dados catalogado localmente se o driverType estiver configurado como 2.
      • driverType - Tipo de conectividade JDBC de uma origem de dados. Há dois valores permitidos: 2 e 4. Se você quiser usar o driver tipo 2, configure este valor para 2. Se você quiser usar o tipo 4, configure este valor para 4.
      • serverName -O endereço TCP/IP ou nome do host para o servidor Distributed Relational Database Architecture (DRDA). Forneça um valor para essa propriedade apenas se o driverType estiver configurado como 4. Essa propriedade não é necessária se o driverType estiver configurado para 2.
      • portNumber -O número da porta TCP/IP onde o servidor DRDA reside. Forneça um valor para essa propriedade apenas se o driverType estiver configurado como 4. Essa propriedade não é necessária se o driverType estiver configurado para 2.
      • useTransactionRedirect Configure esta propriedade como uma propriedade customizada de origem de dados se o backend utilizar o Database Partitioning Feature (DPF) do e a chave de particionamento permanecer constante em toda uma transação. A ativação do imóvel afeta como o IBM Data Server Driver for JDBC and SQLJ direciona cada solicitação de conexão que inicia uma transação com DB2. O driver JDBC é acionado para enviar esses pedidos de conexão ao nó DPF que contém os dados de destino da primeira instrução direcionável na transação, se essa instrução existir. DB2 então direciona a instrução SQL para partições diferentes conforme necessário; a transação procede normalmente a partir do ponto de vista do servidor de aplicativos.

        É possível utilizar useTransactionRedirect para as origens de dados driverType 2 e driverType 4. Para configurar a propriedade, use a ferramenta de script wsadmin ou a página do console administrativo, Java EE provedora de recursos ou conexão de propriedades personalizadas de fábrica de conexão. Designe à propriedade o valor de true.

  • Provedor do Driver DB2 Universal JDBC
    O Driver DB2 Universal JDBC é um driver JDBC neutro em arquitetura para acesso distribuído e local DB2 . Como a arquitetura do Driver DB2 Universal é independente de qualquer conectividade de driver JDBC particular ou plataforma de destino, ele permite que tanto a conectividade Java (Tipo 4) ou a conectividade Java Native Interface (JNI) baseada em uma única instância do driver em uma única instância de driver para DB2. O provedor de Driver DB2 Universal JDBC suporta ambos os bancos de dados JDBC e Structured Query Language em Java (SQLJ) a bancos de dados DB2 , assim como o uso SQLJ com CMP.
    Evitar problemas: Para usar este provedor, você deve ter o Driver DB2 Universal JDBC para DB2 instalado e configurado para o servidor de aplicativos para o z/OS. Consulte o tópico, Usando o Driver DB2 Universal JDBC para acessar o DB2 for z/OS.
    Esse provedor:
    • Suporta a seguinte origem de dados:
      com.ibm.db2.jcc.DB2ConnectionPoolDataSource
      Essa fonte de dados pode suportar transações de duas fases (para o servidor de aplicativos na plataforma z/OS apenas). Se você configurar o Driver DB2 Universal JDBC para conectividade do tipo 2, o servidor de aplicativos em execução no z/OS usa o RRS para processar transações, incluindo transações de confirmação de duas fases. Quando utilizado com a conectividade de driver tipo 4, essa implementação de origem de dados suporta apenas transações de uma fase.
    • Exige os arquivos de driver JDBC:
      • db2jcc.jar -Este é o arquivo .jar do DB2 Universal JDBC Driver, que está localizado no diretório de instalação do DB2 . Especifique o caminho completo desse arquivo .jar para o valor da variável DB2UNIVERSAL_JDBC_DRIVER_PATH.
      • db2jcc_license_cisuz.jar -Este arquivo de licença do Driver DB2 Universal JDBC é incluído com DB2. O programa de instalação para DB2 coloca o arquivo de licença no mesmo diretório DB2 como db2jcc.jar. Portanto, a variável DB2UNIVERSAL_JDBC_DRIVER_PATH aponta basicamente para ambos os arquivos.
        Nota: O driver de driver db2jcc_license_cu.jar navios com o servidor de aplicativos no diretório app_server_root/universalDriver/lib. É definido automaticamente como a variável UNIVERSAL_JDBC_DRIVER_PATH. Embora este arquivo de driver não forneça acesso ao DB2 for z/OS, você pode deixá-lo como parte da definição de variável.
      • Os arquivos nativos de .so tipo são necessários pelo Driver DB2 Universal JDBC no servidor de aplicativos para z/OS. Defina a variável de caminho de biblioteca DB2UNIVERSAL_JDBC_DRIVER_NATIVEPATH como o diretório que contém os arquivos nativos. Nos casos que não exigem arquivos nativos, defina DB2UNIVERSAL_JDBC_DRIVER_NATIVEPATH como nulo.
    • Utiliza o seguinte caminho de classe:
      ${DB2UNIVERSAL_JDBC_DRIVER_PATH}/db2jcc.jar
${UNIVERSAL_JDBC_DRIVER_PATH}/db2jcc_license_cu.jar
${DB2UNIVERSAL_JDBC_DRIVER_PATH}/db2jcc_license_cisuz.jar
${DB2UNIVERSAL_JDBC_DRIVER_NATIVEPATH}
      Evitar problemas: Ao especificar o caminho do diretório para ${DB2_JCC_DRIVER_PATH}, ${UNIVERSAL_JDBC_DRIVER_PATH}, and ${DB2_JCC_DRIVER_PATH} não especifique um caminho que contenha qualquer caractere especial conforme identificado na seção 2.4.3 da RFC 2396: Uniform Resource Identifiers (URI): Sintaxe Genérica
    • Requer a seguinte classe DataStoreHelper:
      com.ibm.websphere.rsadapter.DB2UniversalDataStoreHelper
    • Requer um alias de autenticação válido se a propriedade driverType (ver propriedades que seguem) for definida como 4. Se a propriedade driverType for configurada para 2, você deve especificar um alias de autenticação gerenciado por componente para usar a fonte de dados com res-auth APPLICATION.

      No caso em que driverType 2 está especificada e a origem de dados é utilizada com res-auth CONTAINER, você pode especificar um alias de autenticação gerenciado por contêiner; no entanto, não é necessário. Se você não especificar um alias gerenciado por contêiner, a identidade do usuário associada a uma conexão criada por uma origem de dados será a identidade do usuário associada ao encadeamento atual no momento em que a conexão é obtida.

    • Requer as seguintes propriedades:
      • databaseName - Nome de um banco de dados real se o driverType estiver configurado como 4, ou o nome de um banco de dados catalogado localmente se o driverType estiver configurado como 2.
      • driverType - Tipo de conectividade JDBC de uma origem de dados. Há dois valores permitidos: 2 e 4. Se você quiser usar o Universal JDBC Driver tipo 2, configure este valor para 2. Se você quiser usar o Universal JDBC Driver tipo 4, configure este valor para 4.
      • serverName -O endereço TCP/IP ou nome do host para o servidor Distributed Relational Database Architecture (DRDA). Forneça um valor para essa propriedade somente se o driverType estiver definido como 4. Esta propriedade não é exigida se o driverType estiver definido como 2.
      • portNumber -O número da porta TCP/IP onde o servidor DRDA reside. Forneça um valor para essa propriedade somente se o driverType estiver definido como 4. Esta propriedade não é exigida se o driverType estiver definido como 2.
        Configurações suportadas: DB2 suporta propriedades de conexão adicionais para o Driver DB2 Universal JDBC ; configure-as como propriedades customizadas na origem de dados. Para obter informações sobre essas propriedades de origem de dados opcionais, consulte o Guia de Programação de Aplicativos e Referência para Java para sua versão do DB2 for z/OS.
  • DB2 Universal JDBC Provider (XA)
    O provedor do XA DB2 Universal JDBC usa o Driver DB2 Universal JDBC para fornecer acesso a bancos de dados DB2 . O Driver Universal JDBC suporta conectividade baseada em comunicação Java (driver Tipo 4). Para transações XA, a conectividade do driver tipo 2 não é suportada pelo Driver DB2 Universal JDBC no servidor de aplicativos para o z/OS.
    Evitar problemas: Para usar este provedor, você deve ter o Driver DB2 Universal JDBC para DB2 instalado e configurado para o servidor de aplicativos para o z/OS, ou você deve ter o z/OS Application Connectivity para o recurso DB2 for z/OS instalado e configurado para o servidor de aplicativos para o z/OS. Consulte o tópico, Usando o Driver DB2 Universal JDBC para acessar o DB2 for z/OS.
    Esse provedor:
    • Permite que os aplicativos usem os bancos de dados JDBC e Structured Query Language em Java (SQLJ) a bancos de dados DB2 . O uso do SQLJ com o CMP também é suportado.
    • Não suporta a criação de origens de dados da Versão 4.0.
    • Suporta a origem de dados de duas fases:
      com.ibm.db2.jcc.DB2XADataSource
    • Requer os seguintes arquivos do driver JDBC:
      • db2jcc.jar -Este é o arquivo .jar do DB2 Universal JDBC Driver, que está localizado no diretório de instalação do DB2 . Especifique o caminho totalmente qualificado deste arquivo .jar para o valor de sua variável WebSphere DB2UNIVERSAL_JDBC_DRIVER_PATH. O servidor de aplicativos utiliza esse valor para definir o provedor JDBC.
      • db2jcc_license_cisuz.jar -Este arquivo de licença do Driver DB2 Universal JDBC é incluído com DB2. O programa de instalação para DB2 coloca o arquivo de licença no mesmo diretório DB2 como db2jcc.jar. Portanto, a variável DB2UNIVERSAL_JDBC_DRIVER_PATH aponta basicamente para ambos os arquivos.
        Nota: O driver de driver db2jcc_license_cu.jar navios com o servidor de aplicativos no diretório app_server_root/universalDriver/lib. A variável UNIVERSAL_JDBC_DRIVER_PATH é configurada para esse local de diretório por padrão. Embora este arquivo de driver não forneça acesso ao DB2 for z/OS, você pode deixá-lo como parte da definição de variável.
      • Os arquivos nativos do tipo .so não são necessários pelo Driver DB2 Universal JDBC no servidor de aplicativos para o z/OS se o seu servidor utiliza apenas drivers tipo 4. Neste caso, é possível configurar o valor de DB2UNIVERSAL_JDBC_DRIVER_NATIVEPATH como nulo.
        Melhor prática: Se você tem servidores que executam os drivers do tipo 2 e tipo 4, ou pode ter ambos os tipos no futuro, você pode configurar esse valor para um caminho de arquivo válido para os arquivos nativos. A variável será usada para os drivers do tipo 2, mas o valor para DB2UNIVERSAL_JDBC_DRIVER_NATIVEPATH não deve causar efeitos adversos nos casos em que os arquivos nativos não são necessários.
    • Utiliza o seguinte caminho de classe:
      ${DB2UNIVERSAL_JDBC_DRIVER_PATH}/db2jcc.jar
${UNIVERSAL_JDBC_DRIVER_PATH}/db2jcc_license_cu.jar
${DB2UNIVERSAL_JDBC_DRIVER_PATH}/db2jcc_license_cisuz.jar
${DB2UNIVERSAL_JDBC_DRIVER_NATIVEPATH}
      Evitar problemas: Ao especificar o caminho do diretório para ${DB2_JCC_DRIVER_PATH}, ${UNIVERSAL_JDBC_DRIVER_PATH}, and ${DB2_JCC_DRIVER_PATH} não especifique um caminho que contenha qualquer caractere especial conforme identificado na seção 2.4.3 da RFC 2396: Uniform Resource Identifiers (URI): Sintaxe Genérica
    • Requer a seguinte classe DataStoreHelper:
      com.ibm.websphere.rsadapter.DB2UniversalDataStoreHelper
    • Exige um alias de autenticação válido.
    • Requer as seguintes propriedades:
      • databaseName - Nome de um banco de dados catalogado localmente.
      • driverType - Tipo de conectividade JDBC de uma origem de dados. Se você estiver executando uma versão de DB2 antes do DB2 V8.1 FP6, você está restrito a usar apenas o driver tipo 2.
      • serverName -O endereço TCP/IP ou nome do host para o servidor Distributed Relational Database Architecture (DRDA). Forneça um valor para essa propriedade somente se o driverType estiver definido como 4. Esta propriedade não é exigida se o driverType estiver definido como 2.
      • portNumber -O número da porta TCP/IP onde o servidor DRDA reside. Forneça um valor para essa propriedade somente se o driverType estiver definido como 4. Esta propriedade não é exigida se o driverType estiver definido como 2.
        Configurações suportadas: DB2 suporta propriedades de conexão adicionais para o Driver DB2 Universal JDBC ; configure-as como propriedades customizadas na origem de dados. Para obter informações sobre essas propriedades de origem de dados opcionais, consulte o Guia de Programação de Aplicativos e Referência para Java para sua versão do DB2 for z/OS.