![[z/OS]](../images/ngzos.gif)
Valores mínimos necesarios de origen de datos para DB2 en z/OS y un servidor de aplicaciones en z/OS
Estas propiedades varían según los requisitos del proveedor de la base de datos para las implementaciones del controlador JDBC. Debe establecer las propiedades adecuadas cada origen de datos que configure. Estos valores son para un origen de datos DB2 que se está ejecutando en z/OS y accederán a los mismos las aplicaciones del servidor de una aplicación que también se ejecuta en z/OS.
- DB2
utilizando el controlador IBM
JCC
Este proveedor es un proveedor JCC de compromiso de una fase de DB2 que utiliza el controlador de servidor de datos de IBM para JDBC y SQLJ. El controlador del servidor de datos de IBM para JDBC y SQLJ es la siguiente generación del controlador JDBC universal de DB2. Los orígenes de datos que se crean con este proveedor dan soporte sólo al procesamiento de confirmación de una fase, a menos que se utilice el controlador JDBC de tipo 2 con el servidor de aplicaciones para z/OS. Si ejecuta el servidor de aplicaciones en z/OS con el controlador de tipo 2, el controlador utilizará RRS y dará soporte al procesamiento de confirmación de dos fases.
Este proveedor:- Se puede configurar en nodos de la versión 7.0 y posteriores.
- Da soporte al origen de datos de una fase siguiente:
com.ibm.db2.jcc.DB2ConnectionPoolDataSource
- Necesita los archivos siguientes del controlador JDBC:
- db2jcc4.jar: es el archivo .jar del controlador de IBM Data Server para JDBC y SQLJ. Establezca la variable de vía de acceso DB2_JCC_DRIVER_PATH para que apunte al archivo db2jcc4.jar. Después de instalar DB2, puede buscar este archivo .jar en el directorio DB2 java. Para el soporte del controlador JDBC de tipo 4 desde una máquina cliente donde no esté instalado DB2, copie este archivo en la máquina local. Si instala fixpacks o actualizaciones en DB2, deberá actualizar también este archivo.
- db2jcc_license_cu.jar: es el archivo de licencia del controlador de IBM Data Server para JDBC y SQLJ que permite el acceso a la base de datos DB2. Utilice este archivo .jar o el siguiente para obtener acceso a la base de datos. Este archivo .jar se suministra con el servidor de aplicaciones en un directorio definido por la variable de entorno UNIVERSAL_JDBC_DRIVER_PATH.
- db2jcc_license_cisuz.jar: es el archivo de licencia de IBM Data Server para JDBC y SQLJ
que permite el acceso a las bases de datos siguienes:
- DB2 Database para Linux, UNIX y Windows
- DB2 para iSeries
- DB2 para z/OS
- DB2 para VM y VSE
El archivo db2jcc_license_cisuz.jar no se suministra con el servidor de aplicaciones. Coloque este archivo en el mismo directorio que el archivo db2jcc4.jar, de modo que DB2_JCC_DRIVER_PATH apunte a ambos archivos.
- Los archivos nativos que necesita el controlador JDBC de IBM Data Server para JDBC y SQLJ en el servidor de aplicaciones. Estos sólo son necesarios cuando el tipo de controlador (driverType) se establece en 2.
- Utiliza las siguientes vías de acceso de clases:
${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
Avoid trouble: Al especificar la vía de acceso de directorio para ${DB2_JCC_DRIVER_PATH}, ${UNIVERSAL_JDBC_DRIVER_PATH} y ${DB2_JCC_DRIVER_PATH} no especifique una vía de acceso que contenga cualquier carácter especial de los que se indican en la sección 2.4.3 de RFC 2396: URI (Uniform Resource Identifiers): Generic Syntaxgotcha
Atención: ${PUREQUERY_PATH}/pdq.jar y ${PUREQUERY_PATH}/pdqmgmt.jar se añaden a la vía de acceso de clases como comodidad y sólo son necesarios si las aplicaciones pureQuery utilizan el proveedor JDBC. Si utiliza este proveedor JDBC con aplicaciones pureQuery, establezca la variable PUREQUERY_PATH en el directorio donde se almacenan los archivos JAR de IBM Optim pureQuery Runtime. - Utiliza la siguiente vía de acceso de biblioteca nativa:
Si driverType se establece en 2, la variable DB2_JCC_DRIVER_NATIVEPATH se debe establecer en el directorio de la instalación del cliente DB2 que contiene las bibliotecas de controlador nativo. Si driverType se establece en 4, no se utiliza la vía de acceso nativa.${DB2_JCC_DRIVER_NATIVEPATH}
- Requiere la clase DataStoreHelper siguiente:
com.ibm.websphere.rsadapter.DB2UniversalDataStoreHelper
- Necesita un alias de autenticación válido.
- Necesita las propiedades:
- databaseName: es un nombre de base de datos real si driverType se establece en 4 o un nombre de base de datos catalogado localmente si driverType se establece en 2.
- driverType: el tipo de conectividad JDBC de un origen de datos. Hay dos valores permitidos: 2 y 4. Si desea utilizar el controlador de tipo 2, establezca este valor en 2. Si desea utilizar el tipo 4, establezca este valor en 4.
- serverName: la dirección TCP/IP o nombre del host del servidor DRDA (Distributed Relational Database Architecture). Proporcione un valor para esta propiedad sólo si driverType se establece en 4. Esta propiedad no es necesaria si driverType se establece en 2.
- portNumber: el número de puerto TCP/IP donde reside el servidor DRDA. Proporcione un valor para esta propiedad sólo si driverType se establece en 4. Esta propiedad no es necesaria si driverType se establece en 2.
- useTransactionRedirect Configure esta propiedad como una propiedad personalizada de origen
de datos si el programa de fondo utiliza DPF (Database Partitioning
Feature) y la clave de partición parmanece constante durante toda la transacción. La activación de la propiedad afecta a cómo
el controlador de IBM Data Server para JDBC y SQLJ direccciona cada solicitud de conexión
que inicia una transacción con DB2. El controlador JDBC se desencadena para enviar esas solicitudes de conexión al nodo DPF que contiene los datos
de destino de la primera sentencia direccionable en la transacción, si existe una sentencia de ese tipo. A continuación, DB2 direcciona la sentencia SQL a
distintas particiones, según sea necesario; la transacción continúa con normalidad desde
el punto de vista del servidor de aplicaciones.
Puede utilizar useTransactionRedirect para los orígenes de datos driverType 2 y driverType 4. Para configurar la propiedad, utilice la herramienta de scripts wsadmin o la página de la consola administrativa, el proveedor de recursos Java™ o la colección de propiedades personalizadas de la fábrica de conexiones. Asigne a la propiedad el valor true.
- DB2 con controlador JCC de IBM (XA)DB2 con controlador JCC de IBM (XA) es un proveedor JCC de confirmación de dos fases para DB2 que utiliza el controlador del servidor de datos de IBM para JDBC y SQLJ. El controlador de IBM Data Server es la siguiente generación del controlador JDBC de DB2 Universal. Los orígenes de datos creados bajo este proveedor permiten utilizar XA para el proceso de compromiso en dos fases.
Avoid trouble: No utilice el controlador JDBC de tipo 2 en el servidor de aplicaciones para z/OS.gotcha
Este proveedor:- Se puede configurar en nodos de la versión 7.0 y posteriores.
- Da soporte al origen de datos de dos fases siguiente:
com.ibm.db2.jcc.DB2XADataSource
- Necesita los archivos siguientes del controlador JDBC:
- db2jcc4.jar: es el archivo .jar del controlador de IBM Data Server para JDBC y SQLJ. Establezca la variable de vía de acceso DB2_JCC_DRIVER_PATH para que apunte al archivo db2jcc4.jar. Después de instalar DB2, puede encontrar este archivo .jar en el directorio DB2 Java. Para el soporte del controlador JDBC de tipo 4 desde una máquina cliente donde DB2 no esté instalado, copie este archivo en la máquina local. Si instala fixpacks o actualizaciones en DB2, deberá actualizar también este archivo. También debe especificar la vía de acceso plenamente cualificada de db2jcc4.jar como el valor de la variable de entorno DB2_JCC_DRIVER_PATH.
- db2jcc_license_cu.jar: es el archivo de licencia que permite el acceso a la base de datos DB2. Utilice este archivo .jar o el siguiente para obtener acceso a la base de datos. Este archivo .jar se proporciona con el servidor de aplicaciones en un directorio definido por la variable de entorno UNIVERSAL_JDBC_DRIVER_PATH.
- db2jcc_license_cisuz.jar: este es el archivo de licencia que permite acceder a las siguientes bases de datos:
- DB2 Database para Linux, UNIX y Windows
- DB2 para iSeries
- DB2 para z/OS
- DB2 para VM y VSE
El archivo db2jcc_license_cisuz.jar no se suministra con el servidor de aplicaciones. Coloque este archivo en el mismo directorio que el archivo db2jcc4.jar, de modo que DB2_JCC_DRIVER_PATH apunte a ambos archivos.
- Los archivos nativos que necesita el controlador JDBC de IBM Data Server para JDBC y SQLJ en el servidor de aplicaciones. Estos sólo son necesarios cuando el tipo de controlador (driverType) se establece en 2.
- Utiliza las siguientes vías de acceso de clases:
${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
Avoid trouble: Al especificar la vía de acceso de directorio para ${DB2_JCC_DRIVER_PATH}, ${UNIVERSAL_JDBC_DRIVER_PATH} y ${DB2_JCC_DRIVER_PATH} no especifique una vía de acceso que contenga cualquier carácter especial de los que se indican en la sección 2.4.3 de RFC 2396: URI (Uniform Resource Identifiers): Generic Syntaxgotcha
Atención: ${PUREQUERY_PATH}/pdq.jar y ${PUREQUERY_PATH}/pdqmgmt.jar se añaden a la vía de acceso de clases como comodidad y sólo son necesarios si las aplicaciones pureQuery utilizan el proveedor JDBC. Si utiliza este proveedor JDBC con aplicaciones pureQuery, establezca la variable PUREQUERY_PATH en el directorio donde se almacenan los archivos JAR de IBM Optim pureQuery Runtime. - Utiliza la siguiente vía de acceso de biblioteca nativa:
Si driverType se establece en 2, la variable DB2_JCC_DRIVER_NATIVEPATH se debe establecer en el directorio en la instalación de cliente de DB2 que contiene las bibliotecas de controladores nativos. Si driverType se establece en 4, no se utiliza la vía de acceso nativa.${DB2_JCC_DRIVER_NATIVEPATH}
- Requiere la clase DataStoreHelper siguiente:
com.ibm.websphere.rsadapter.DB2UniversalDataStoreHelper
- Necesita un alias de autenticación válido.
- Requiere las propiedades siguientes:
- databaseName: es un nombre de base de datos real si driverType se establece en 4 o un nombre de base de datos catalogado localmente si driverType se establece en 2.
- driverType: el tipo de conectividad JDBC de un origen de datos. Hay dos valores permitidos: 2 y 4. Si desea utilizar el controlador de tipo 2, establezca este valor en 2. Si desea utilizar el tipo 4, establezca este valor en 4.
- serverName: la dirección TCP/IP o nombre del host del servidor DRDA (Distributed Relational Database Architecture). Proporcione un valor para esta propiedad sólo si driverType se establece en 4. Esta propiedad no es necesaria si driverType se establece en 2.
- portNumber: el número de puerto TCP/IP donde reside el servidor DRDA. Proporcione un valor para esta propiedad sólo si driverType se establece en 4. Esta propiedad no es necesaria si driverType se establece en 2.
- useTransactionRedirect Configure esta propiedad como una propiedad personalizada de origen
de datos si el programa de fondo utiliza DPF (Database Partitioning
Feature) y la clave de partición parmanece constante durante toda la transacción. La activación de la propiedad afecta a cómo
el controlador de IBM Data Server para JDBC y SQLJ direccciona cada solicitud de conexión
que inicia una transacción con DB2. El controlador JDBC se desencadena para enviar esas solicitudes de conexión al nodo DPF que contiene los datos
de destino de la primera sentencia direccionable en la transacción, si existe una sentencia de ese tipo. A continuación, DB2 direcciona la sentencia SQL a
distintas particiones, según sea necesario; la transacción continúa con normalidad desde
el punto de vista del servidor de aplicaciones.
Puede utilizar useTransactionRedirect para los orígenes de datos driverType 2 y driverType 4. Para configurar la propiedad, utilice la herramienta de scripts wsadmin o la página de la consola administrativa, el proveedor de recursos Java o la colección de propiedades personalizadas de la fábrica de conexiones. Asigne a la propiedad el valor true.
- Proveedor del controlador JDBC de DB2
Universal El controlador JDBC de DB2 Universal es un controlador JDBC de arquitectura neutra para el acceso a DB2 local y distribuido. Dado que la arquitectura de DB2 Universal Driver es independiente de cualquier conexión de controlador JDBC concreta o de la plataforma de destino, permite la conectividad Java (Tipo 4) o la conectividad basada en JNI (Java Native Interface) (Tipo 2) en una sola instancia de controlador con DB2. El proveedor de JDBC de DB2 Universal permite el acceso JDBC y SQLJ (Structured Query Language in Java) a bases de datos DB2 y también el uso de SQLJ con CMP.
Avoid trouble: Para utilizar este proveedor, debe tener instalado el controlador JDBC de DB2 Universal para el DB2 instalado y configurado para el servidor de aplicaciones para z/OS. Consulte el tema utilización del controlador JDBC de DB2 Universal para acceder a DB2 para z/OS.gotcha
Este proveedor:- Da soporte al origen de datos siguiente:
Este origen de datos puede dar soporte a transacciones de dos fases (sólo para el servidor de aplicaciones en la plataforma z/OS). Si establece el controlador JDBC de DB2 Universal para la conectividad de tipo 2, el servidor de aplicaciones en z/OS utiliza RRS para procesar transacciones, incluidas las transacciones de compromiso en dos fases. Cuando se utiliza con la conectividad del controlador de tipo 4, esta implementación del origen de datos da soporte únicamente a transacciones de una fase.com.ibm.db2.jcc.DB2ConnectionPoolDataSource
- Necesita los archivos del controlador JDBC:
- db2jcc.jar: éste es el archivo del controlador JDBC de DB2 Universal, que se encuentra en el directorio de instalación DB2. Especifique la vía de acceso totalmente cualificada de este archivo .jar para el valor de la variable DB2UNIVERSAL_JDBC_DRIVER_PATH.
- db2jcc_license_cisuz.jar: ése archivo de licencia del controlador JDBC de DB2 Universal se suministra con DB2. El programa de instalación para DB2 coloca el archivo de licencias en el mismo directorio de DB2 que db2jcc.jar. Por lo tanto, la variable DB2UNIVERSAL_JDBC_DRIVER_PATH apunta finalmente a ambos archivos.Nota: El archivo de controlador db2jcc_license_cu.jar se suministra con el servidor de aplicaciones en el directorio raíz_servidor_aplicaciones/universalDriver/lib. Se establece automáticamente en la variable UNIVERSAL_JDBC_DRIVER_PATH. Aunque este archivo de controlador no proporciona acceso a DB2 para z/OS, puede dejarlo como parte de la definición de variables.
- El controlador JDBC de DB2 Universal requiere los archivos nativos del tipo .so en el servidor de aplicaciones para z/OS. Establezca la variable de vía de acceso de biblioteca DB2UNIVERSAL_JDBC_DRIVER_NATIVEPATH en el directorio que contiene los archivos nativos. En casos en los que no se requieran archivos nativos, establezca DB2UNIVERSAL_JDBC_DRIVER_NATIVEPATH en null.
- Utilice la vía de acceso de clases siguiente:
${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}
Avoid trouble: Al especificar la vía de acceso de directorio para ${DB2_JCC_DRIVER_PATH}, ${UNIVERSAL_JDBC_DRIVER_PATH} y ${DB2_JCC_DRIVER_PATH} no especifique una vía de acceso que contenga cualquier carácter especial de los que se indican en la sección 2.4.3 de RFC 2396: URI (Uniform Resource Identifiers): Generic Syntaxgotcha
- Requiere la clase DataStoreHelper siguiente:
com.ibm.websphere.rsadapter.DB2UniversalDataStoreHelper
- Requiere un alias de autenticación válido si la propiedad
driverType está establecida en 4. Si la propiedad driverType está
establecida en 2, debe especificar un alias de autenticación
gestionado por componente para utilizar el origen de datos con res-auth APPLICATION.
Si se especifica el tipo de controlador 2 y se utiliza el origen de datos con res-auth CONTAINER, puede especificar un alias de autenticación gestionado por contenedor; no obstante, no es necesario. Si no especifica un alias gestionado por contenedor, la identidad del usuario asociada a una conexión creada mediante el origen de datos será la identidad del usuario asociada a la hebra actual en el momento en que se obtuvo la conexión.
- Requiere las propiedades siguientes:
- databaseName: es un nombre real de base de datos si driverType se establece como 4, o un nombre de base de datos catalogada localmente si driverType se establece como 2.
- driverType: el tipo de conectividad JDBC de un origen de datos. Los valores permitidos son dos: 2 y 4. Si desea utilizar el controlador JDBC de DB2 Universal de tipo 2, establezca este valor como 2. Si desea utilizar el controlador JDB2 de DB2 Universal de tipo 4, establezca este valor en 4.
- serverName: la dirección TCP/IP o nombre del host del servidor DRDA (Distributed Relational Database Architecture). Proporcione un valor para esta propiedad sólo si driverType está establecido en 4. Esta propiedad no es necesaria si driverType está establecido en 2.
- portNumber: el número de puerto TCP/IP donde reside el servidor DRDA. Proporcione un valor para esta propiedad sólo si driverType se ha establecido como 4.
Esta propiedad no es necesaria si driverType se ha establecido como 2. Nota: DB2 da soporte a propiedades de conexión adicionales para el controlador JDBC/SQLJ de DB2 Universal. Establézcalas como propiedades personalizadas en el origen de datos. Para obtener información sobre estas propiedades de origen de datos opcionales, consulte la publicación Application Programming Guide and Reference for Java para su versión de DB2 para z/OS.
- Da soporte al origen de datos siguiente:
- DB2 Universal
JDBC Provider (XA) El proveedor de JDBC (XA) de DB2 Universal utiliza el controlador JDBC de DB2 Universal para proporcionar acceso a las bases de datos DB2. El controlador JDBC de DB2 Universal JDBC permite la conectividad basada en comunicaciones Java (controlador de tipo 4). Para transacciones XA, la conectividad de tipo 2 de controlador no está soportada por el controlador JDBC de DB2 Universal en el servidor de aplicaciones para z/OS.
Avoid trouble: Para utilizar este proveedor, debe tener instalado el controlador JDBC de DB2 Universal para DB2 y debe estar configurado para el servidor de aplicaciones para z/OS, o debe tener instalada y configurada la característica de conectividad de aplicación z/OS con DB2 for z/OS para el servidor de aplicaciones para z/OS. Consulte el tema utilización del controlador JDBC de DB2 Universal para acceder a DB2 para z/OS.gotcha
Este proveedor:- Permite que a las aplicaciones utilizar JDBC y SQLJ (Lenguaje de consulta estructurada en Java) para acceder a bases de datos DB2. También se admite el uso de SQLJ con CMP.
- No admite la creación de orígenes de datos de la versión 4.0.
- Da soporte al origen de datos de dos fases:
com.ibm.db2.jcc.DB2XADataSource
- Necesita los archivos siguientes del controlador JDBC:
- db2jcc.jar: éste es el archivo del controlador JDBC de DB2 Universal, que se encuentra en el directorio de instalación DB2. Especifique la vía de acceso completa de este archivo .jar para el valor de la variable de WebSphere DB2UNIVERSAL_JDBC_DRIVER_PATH. El servidor de aplicaciones utiliza este valor para definir el proveedor de JDBC.
- db2jcc_license_cisuz.jar: ése archivo de licencia del controlador JDBC de DB2 Universal se suministra con DB2. El programa de instalación para DB2 coloca el archivo de licencias en el mismo directorio de DB2 que db2jcc.jar. Por lo tanto, la variable DB2UNIVERSAL_JDBC_DRIVER_PATH apunta finalmente a ambos archivos.Nota: El archivo de controlador db2jcc_license_cu.jar se suministra con el servidor de aplicaciones en el directorio raíz_servidor_aplicaciones/universalDriver/lib. La variable UNIVERSAL_JDBC_DRIVER_PATH se establece en este directorio como ubicación predeterminada. Aunque este archivo de controlador no proporciona acceso a DB2 para z/OS, puede dejarlo como parte de la definición de variables.
- Los archivos nativos del tipo .so no los necesita el controlador JDBC de DB2 Universal en el servidor de aplicaciones para z/OS si el servidor solamente utiliza controladores del tipo 4.
En este caso, puede establecer el valor de DB2UNIVERSAL_JDBC_DRIVER_NATIVEPATH en null.
Best practice: Si tiene servidores que ejecutan tanto controladores de tipo 2 como de tipo 4, o puede que tenga ambos tipos en el futuro, puede establecer este valor en una vía de acceso de archivos válida para archivos nativos. La variable se utilizará para controladores de tipo 2, pero el valor de DB2UNIVERSAL_JDBC_DRIVER_NATIVEPATH no debería provocar ningún efecto adverso en aquellos casos en que los archivos nativos no fueran necesarios.bprac
- Utilice la vía de acceso de clases siguiente:
${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}
Avoid trouble: Al especificar la vía de acceso de directorio para ${DB2_JCC_DRIVER_PATH}, ${UNIVERSAL_JDBC_DRIVER_PATH} y ${DB2_JCC_DRIVER_PATH} no especifique una vía de acceso que contenga cualquier carácter especial de los que se indican en la sección 2.4.3 de RFC 2396: URI (Uniform Resource Identifiers): Generic Syntaxgotcha
- Requiere la clase DataStoreHelper siguiente:
com.ibm.websphere.rsadapter.DB2UniversalDataStoreHelper
- Necesita un alias de autenticación válido.
- Requiere las propiedades siguientes:
- databaseName: es el nombre de una base de datos catalogada localmente.
- driverType: es el tipo de conectividad JDBC de un origen de datos. Si ejecuta una versión de DB2 anterior a DB2 V8.1 FP6, está limitado a utilizar sólo el controlador de tipo 2.
- serverName: la dirección TCP/IP o nombre del host del servidor DRDA (Distributed Relational Database Architecture). Proporcione un valor para esta propiedad sólo si driverType está establecido en 4. Esta propiedad no es necesaria si driverType está establecido en 2.
- portNumber: el número de puerto TCP/IP donde reside el servidor DRDA. Proporcione un valor para esta propiedad sólo si driverType se ha establecido como 4.
Esta propiedad no es necesaria si driverType se ha establecido como 2. Nota: DB2 da soporte a propiedades de conexión adicionales para el controlador JDBC/SQLJ de DB2 Universal. Establézcalas como propiedades personalizadas en el origen de datos. Para obtener información sobre estas propiedades de origen de datos opcionales, consulte la publicación Application Programming Guide and Reference for Java para su versión de DB2 para z/OS.