![[z/OS]](../images/ngzos.gif)
Configurações Necessárias Mínimas de Origem 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. Estas configurações são para uma origem de dados DB2 que está em execução no z/OS e serão acessadas pelos aplicativos em um servidor de aplicativos que também está em execução no z/OS.
- DB2 Utilizando o IBM JCC Driver
Esse é um provedor JCC one-phase commit para DB2 que utiliza o IBM Data Server Driver para JDBC e SQLJ. O IBM Data Server Driver para JDBC e SQLJ é a próxima geração do Driver Universal JDBC DB2. Origens de dados criadas nesse provedor suportam apenas o processamento 1-phase commit, a menos que você utilize o driver JDBC tipo 2 com o servidor de aplicativos para z/OS. Se você executar o servidor de aplicativos no z/OS com o driver do tipo 2, o driver utilizará RRS e suportará processamento 2-phase commit.
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 - Esse é o arquivo .jar do IBM Data Server Driver para JDBC e SQLJ. Configurar a variável de caminho DB2_JCC_DRIVER_PATH para apontar para o arquivo db2jcc4.jar. Depois de instalar o DB2, poderá localizar esse arquivo .jar no diretório DB2 java. Para obter suporte ao driver JDBC Tipo 4 em uma máquina cliente na qual o DB2 não está instalado, copie esse arquivo na máquina local. Se você instalar alguma correção ou upgrade no DB2, atualize esse arquivo também.
- db2jcc_license_cu.jar - Esse é o arquivo de licença do IBM Data Server Driver para JDBC e SQLJ que permite acessar o banco de dados DB2. Utilize esse arquivo .jar ou o próximo para obter acesso ao banco de dados. Este 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 do IBM Data Server para JDBC e SQLJ que permite acesso aos seguintes bancos de dados:
- DB2 Database para Linux, UNIX e Windows
- DB2 para iSeries
- DB2 para z/OS
- DB2 for VM and 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 andSQLJ 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} e ${DB2_JCC_DRIVER_PATH}, não especifique um caminho que contenha quaisquer dos caracteres especiais identificados na seção 2.4.3 de RFC 2396: Identificadores uniformes de recursos (URI): sintaxe genéricagotcha
Atenção: Os arquivos ${PUREQUERY_PATH}/pdq.jar e ${PUREQUERY_PATH}/pdqmgmt.jar são incluídos no caminho de classe por conveniência e são necessários apenas se o provedor JDBC for usado pelos aplicativos pureQuery. Se estiver usando esse provedor JDBC com os aplicativos pureQuery, configure a variável para PUREQUERY_PATH para o diretório onde os arquivos JAR do IBM Optim pureQuery Runtime estão armazenados. - Use o seguinte caminho de biblioteca nativa:
Se o driverType for configurado para 2, a variável DB2_JCC_DRIVER_NATIVEPATH deverá ser configurada para o diretório na sua instalação do cliente DB2 que contém as bibliotecas do driver nativo. Se driverType estiver configurado para 4, o caminho nativo não será usado.${DB2_JCC_DRIVER_NATIVEPATH}
- Requer a seguinte classe DataStoreHelper:
com.ibm.websphere.rsadapter.DB2UniversalDataStoreHelper
- Exige um alias de autenticação válido.
- Requer as propriedades:
- databaseName - Este é 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. Dois valores são permitidos: 2 e 4. Se desejar usar o driver tipo 2, configure este valor para 2. Se desejar usar o tipo 4, configure este valor para 4.
- serverName - O endereço TCP/IP ou o nome do host para o servidor DRDA (Distributed Relational Database Architecture). Fornece um valor para essa propriedade apenas se o seu driverType estiver configurado para 4. Essa propriedade não é necessária se o seu driverType estiver configurado para 2.
- portNumber - O número da porta TCP/IP na qual o servidor DRDA reside. Forneça um valor para essa propriedade apenas se o driverType estiver configurado para 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. Ativar a propriedade afeta como o IBM Data Server Driver para JDBC e SQLJ direciona cada
solicitação de conexão que inicia uma transação com o 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. O
DB2 então
direciona a instrução SQL para partições diferentes, conforme necessário; a transação
prossegue normalmente do ponto de vista do servidor de aplicativos.
É possível usar useTransactionRedirect para as origens de dados driverType 2 e driverType 4. Para configurar a propriedade, utilize a ferramenta de script wsadmin ou a página do console administrativo e as propriedades customizadas do provedor de recursos ou do connection factory do Java™ EE Designe à propriedade o valor de true.
- DB2 Utilizando o IBM JCC Driver (XA)O DB2 Utilizando o IBM JCC Driver (XA) é um provedor JCC two-phase commit para o DB2 que utiliza o IBM Data Server Driver para JDBC e SQLJ. O IBM Data Server Driver é a próxima geração do DB2 Universal JDBC Driver. 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 utilize o driver JDBC tipo 2 no servidor de aplicativos para z/OS.gotcha
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 - Esse é o arquivo .jar do IBM Data Server Driver para JDBC e SQLJ. Configurar a variável de caminho DB2_JCC_DRIVER_PATH para apontar para o arquivo db2jcc4.jar. Depois de instalar o DB2, poderá localizar esse arquivo .jar no diretório DB2 Java. Para obter suporte ao driver JDBC tipo 4 em uma máquina cliente na qual o DB2 não está instalado, copie esse arquivo para a máquina local. Se você instalar alguma correção ou upgrade no DB2, atualize esse 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 - Esse é o arquivo de licença que permite 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 Database para Linux, UNIX e Windows
- DB2 para iSeries
- DB2 para z/OS
- DB2 for VM and 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 andSQLJ 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} e ${DB2_JCC_DRIVER_PATH}, não especifique um caminho que contenha quaisquer caracteres especiais, conforme identificados na seção 2.4.3 de RFC 2396: Identificadores Uniformes de Recursos (URI): Sintaxe Genéricagotcha
Atenção: Os arquivos ${PUREQUERY_PATH}/pdq.jar e ${PUREQUERY_PATH}/pdqmgmt.jar são incluídos no caminho de classe por conveniência e são necessários apenas se o provedor JDBC for usado pelos aplicativos pureQuery. Se estiver usando esse provedor JDBC com os aplicativos pureQuery, configure a variável para PUREQUERY_PATH para o diretório onde os arquivos JAR do IBM Optim pureQuery Runtime estão armazenados. - Use o seguinte caminho de biblioteca nativa:
Se o driverType for configurado para 2, a variável DB2_JCC_DRIVER_NATIVEPATH deverá ser configurada para o diretório na sua instalação do cliente DB2 que contém as bibliotecas do driver nativo. Se driverType estiver configurado para 4, o caminho nativo não será usado.${DB2_JCC_DRIVER_NATIVEPATH}
- 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. Dois valores são permitidos: 2 e 4. Se desejar usar o driver tipo 2, configure este valor para 2. Se desejar usar o tipo 4, configure este valor para 4.
- serverName - O endereço TCP/IP ou o nome do host para o servidor DRDA (Distributed Relational Database Architecture). Fornece um valor para essa propriedade apenas se o seu driverType estiver configurado para 4. Essa propriedade não é necessária se o seu driverType estiver configurado para 2.
- portNumber - O número da porta TCP/IP na qual o servidor DRDA reside. Forneça um valor para essa propriedade apenas se o driverType estiver configurado para 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. Ativar a propriedade afeta como o IBM Data Server Driver para JDBC e SQLJ direciona cada
solicitação de conexão que inicia uma transação com o 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. O
DB2 então
direciona a instrução SQL para partições diferentes, conforme necessário; a transação
prossegue normalmente 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, utilize a ferramenta de script wsadmin ou a página do console administrativo e as propriedades customizadas do provedor de recursos ou do connection factory do Java EE Designe à propriedade o valor de true.
- Provedor DB2 Universal JDBC Driver O DB2 Universal JDBC Driver é um driver JDBC de arquitetura neutra para acesso distribuído e local ao DB2. Como a arquitetura do DB2 Universal Driver não depende de nenhuma conectividade ou plataforma de destino específica do driver JDBC, ela permite a conectividade Java (Tipo 4) ou a conectividade (Tipo 2) baseada na JNI (Java Native Interface) em uma instância de driver único com o DB2. O provedor do Driver JDBC do DB2 Universal suporta o acesso JDBC e SQLJ (Linguagem de Consulta Estruturada em Java) aos bancos de dados DB2, bem como o uso de SQLJ com CMP.
Evitar Problemas: Para usar este provedor, você deve ter o DB2 Universal JDBC Driver para DB2 instalado e configurado para o servidor de aplicativos para z/OS. Consulte o tópico Usando o Driver JDBC do DB2 Universal para Acessar o DB2 para z/OSgotcha
Esse provedor:- Suporta a seguinte origem de dados:
Esta origem de dados pode suportar transações em duas fases (para o servidor de aplicativos na plataforma z/OS apenas). Se você definir o DB2 Universal JDBC Driver para conectividade do tipo 2, o servidor de aplicativos em execução no z/OS utilizará RRS para processar as transações, incluindo aquelas de two-phase commit. Quando utilizado com a conectividade de driver tipo 4, esta implementação de origem de dados suporta apenas transações de uma fase.com.ibm.db2.jcc.DB2ConnectionPoolDataSource
- 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
DB2
Universal JDBC Driver está incluído no
DB2. O programa de instalação do
DB2 coloca
o arquivo de licença no mesmo diretório do
DB2 do
arquivo db2jcc.jar. Portanto, a variável DB2UNIVERSAL_JDBC_DRIVER_PATH
aponta basicamente para ambos os arquivos.Nota: O arquivo do driver db2jcc_license_cu.jar é fornecido 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 do driver não forneça acesso ao DB2 para z/OS, é possível deixá-lo como parte da definição da variável.
- Os arquivos nativos do tipo .so são requeridos pelo DB2 Universal JDBC Driver 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} e ${DB2_JCC_DRIVER_PATH}, não especifique um caminho que contenha quaisquer caracteres especiais, conforme identificados na seção 2.4.3 de RFC 2396: Identificadores Uniformes de Recursos (URI): Sintaxe Genéricagotcha
- Requer a seguinte classe DataStoreHelper:
com.ibm.websphere.rsadapter.DB2UniversalDataStoreHelper
- Requererá um alias de autenticação válido, se a propriedade driverType estiver configurada como 4. Se a propriedade driverType estiver configurada como 2, você deverá especificar um alias de autenticação gerenciado por componente para utilizar a origem de dados com res-auth APPLICATION.
No caso em que driverType 2 está especificada e a origem de dados é utilizada com res-auth CONTAINER, é possível especificar um alias de autenticação gerenciado por contêiner; no entanto, não você deve. 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. Dois valores são permitidos: 2 e 4. Se desejar usar o Driver JDBC Universal tipo 2, configure este valor como 2. Se desejar usar o Driver JDBC Universal tipo 4, configure este valor como 4.
- serverName - O endereço TCP/IP ou o nome do host para o servidor DRDA (Distributed Relational Database Architecture). Forneça um valor para essa propriedade apenas se o driverType estiver configurado como 4. Essa propriedade não será necessária se o driverType estiver configurado como 2.
- portNumber - O número da porta TCP/IP na qual o servidor
DRDA
reside. Forneça um valor para essa propriedade apenas se
o driverType estiver definido como 4.
Esta propriedade não é exigida se
o driverType estiver definido como 2. Nota: O DB2 suporta propriedades adicionais de conexão para o DB2 Universal JDBC Driver; defina-as como propriedades customizadas na origem de dados. Para obter informações sobre estas propriedades opcionais de origem de dados, consulte o Application Programming Guide and Reference for Java para a sua versão do DB2 para z/OS.
- Suporta a seguinte origem de dados:
- DB2 Universal
JDBC Provider (XA) O provedor XA DB2 Universal JDBC utiliza o DB2 Universal JDBC Driver para fornecer acesso aos bancos de dados DB2. O Universal JDBC Driver suporta conectividade baseada em comunicação Java (driver Tipo 4). Em transações XA, a conectividade do driver tipo 2 não é suportada pelo DB2 Universal JDBC Driver no servidor de aplicativos para z/OS.
Evitar Problemas: Para usar este provedor, você deve ter o DB2 Universal JDBC Driver para DB2 instalado e configurado para o servidor de aplicativos para z/OS ou você deve ter o recurso z/OS Application Connectivity para DB2 para z/OS instalado e configurado para o servidor de aplicativos para z/OS. Consulte o tópico Usando o Driver JDBC do DB2 Universal para Acessar o DB2 para z/OSgotcha
Este provedor:- Permite que os aplicativos utilizem o acesso JDBC e SQLJ (Linguagem de Consulta Estruturada em Java) aos 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 - Esse é 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 do WebSphere, DB2UNIVERSAL_JDBC_DRIVER_PATH. O servidor de aplicativos utiliza este valor para definir o provedor JDBC.
- db2jcc_license_cisuz.jar - Esse arquivo de licença do
DB2
Universal JDBC Driver está incluído no
DB2. O programa de instalação do
DB2 coloca
o arquivo de licença no mesmo diretório do
DB2 do
arquivo db2jcc.jar. Portanto, a variável DB2UNIVERSAL_JDBC_DRIVER_PATH
aponta basicamente para ambos os arquivos.Nota: O arquivo do driver db2jcc_license_cu.jar é fornecido com o servidor de aplicativos no diretório app_server_root/universalDriver/lib. A variável UNIVERSAL_JDBC_DRIVER_PATH é configurada com este local de diretório por padrão. Embora esse arquivo do driver não forneça acesso ao DB2 para z/OS, você pode deixá-lo como parte da definição da variável.
- Os arquivos nativos do tipo .so não são requeridos pelo Driver Universal JDBC do DB2 no servidor de aplicativos para z/OS se seu servidor
usar apenas drivers tipo 4. Nesse caso, é possível configurar o valor de DB2UNIVERSAL_JDBC_DRIVER_NATIVEPATH
para nulo.
Boas Práticas: Se você tiver servidores que executam os drivers de tipo 2 e do tipo 4, ou poderá ter os dois tipos no futuro, este valor poderá ser configurado para um caminho de arquivo válido para os arquivos nativos. A variável será usada para os drivers do tipo 2, porém o valor de DB2UNIVERSAL_JDBC_DRIVER_NATIVEPATH não deverá causar nenhum efeito contrário para os casos em que os arquivos nativos não forem necessários.bprac
- 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} e ${DB2_JCC_DRIVER_PATH}, não especifique um caminho que contenha quaisquer caracteres especiais, conforme identificados na seção 2.4.3 de RFC 2396: Identificadores Uniformes de Recursos (URI): Sintaxe Genéricagotcha
- 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 do DB2 anterior ao DB2 V8.1 FP6, estará restrito ao uso apenas do driver do tipo 2.
- serverName - O endereço TCP/IP ou o nome do host para o servidor DRDA (Distributed Relational Database Architecture). Forneça um valor para essa propriedade apenas se o driverType estiver configurado como 4. Essa propriedade não será necessária se o driverType estiver configurado como 2.
- portNumber - O número da porta TCP/IP na qual o servidor
DRDA
reside. Forneça um valor para essa propriedade apenas se
o driverType estiver definido como 4.
Esta propriedade não é exigida se
o driverType estiver definido como 2. Nota: O DB2 suporta propriedades adicionais de conexão para o DB2 Universal JDBC Driver; defina-as como propriedades customizadas na origem de dados. Para obter informações sobre essas propriedades opcionais de origem de dados, consulte o Application Programming Guide and Reference for Java para a sua versão do DB2 para z/OS.