Habilitación de un controlador DB2 JDBC de Tipo 2 en z/OS

El servidor Liberty se puede habilitar para interactuar con DB2 utilizando la implementación del controlador JDBC de tipo 2 en z/OS.

Antes de empezar

Se debe iniciar el proceso ángel antes de habilitar este soporte. Para obtener más información, consulte Administración de Liberty en z/OS. Puede configurar un servidor Liberty para ejecutarse como una tarea iniciada de z/OS. Si desea más información, consulte Configuración de un servidor Liberty como una tarea iniciada de z/OS.

Acerca de esta tarea

Cuando se utiliza un recurso con capacidad para RRS como, por ejemplo, DB2, tiene las configuraciones opcionales siguientes:
  • Puede habilitar el servidor para suprimir automáticamente los nombres de gestor de recursos del recurso de la corriente de registro RM.DATA de RRS (Resource and Recovery Services) cuando se detiene el servidor. Esta configuración es opcional, pero si está habilitada se impide que los nombres de gestores de recurso se acumulen en la corriente de registro. Para habilitar la supresión automática de nombres de gestor de recurso, configure RACF (Resource Access Control Facility) de modo que permita que el servidor llame a la macro ATRSRV. Para habilitar la supresión de nombre RM automática, el ID de usuario bajo el cual se ejecuta el servidor Liberty debe tener el acceso ALTER en la clase FACILITY para:
    • El recurso MVSADMIN.RRS.COMMANDS.gname.sysname para acceder a un nombre de grupo de registro específico (gname) y un sistema (sysname)
    • El recurso MVSADMIN.RRS.COMMANDS.* para permitir el acceso a todos los nombres de sistemas y grupos de registro
  • Puede definir la corriente de registro RM.METADATA para registrar los datos que le ayudarán durante la depuración. El ID de usuario bajo el cual se ejecuta el servidor Liberty debe tener el acceso ALTER en la clase FACILITY, tal como se describe.
Nota: Para obtener más información sobre la macro ATRSRV, establezca el permiso RACF correspondiente, y cómo se ha de definir la corriente de registro RM.METADATA, consulte la publicación MVS Programming: Resource Recovery asociada al nivel de z/OS de su sistema.
  • Puede controlar el tiempo de espera de las transacciones de forma activa utilizando contextos nativos para completarse cuando el servidor se detiene o cuando la característica zosTransaction-1.0 deja de ser necesaria. Esto puede hacerse mediante el elemento de configuración nativeTransactionManager y el atributo shutdownTimeout.
  • Puede restringir la autorización del usuario para realizar cualquier trabajo transaccional que incluya los recursos con posibilidad RRS, por ejemplo DB2 T2, en un servidor concreto. Esto puede hacerse utilizando el elemento de configuración nativeTransactionManager y el atributo resourceManagerNamePrefix.
    Nota: El atributo resourceManagerNamePrefix especifica un solo prefijo de 1 a 8 caracteres alfanuméricos (A-Z, a-z, 0-9) y nacionales (@,#,$) que se utilizará como parte del nombre del gestor de recursos generador por el servidor que se registra con RRS. El prefijo "DEFAULT" es un prefijo reservado que identifica una configuración de servidor predeterminada y no se debe utilizar para proteger el acceso al servidor. Si el prefijo configurado no sigue los requisitos de nombre, longitud y caracteres, se utiliza el nombre de prefijo DEFAULT. El prefijo está pensado para que los administradores del sistema permitan que únicamente los usuarios autorizados puedan realizar el trabajo transaccional (normal y de recuperación) en el que participen recursos con posibilidad RRS. Por ejemplo, DB2 T2 en el servidor donde se ha configurado el prefijo. Los administradores del sistema deben definir un recurso BBG.RMNAME.<PREFIX>.RRS bajo la clase SERVER y proporcionar la autoridad READ de usuarios necesaria.

    Estos ejemplos describen la configuración opcional:

    Definición de elemento y atributo de Server.xml:
    <nativeTransactionManager shutdownTimeout="20s" resourceManagerNamePrefix="PROD1"/>
    Definición de recursos RACF y autorización de usuarios
    RDEF SERVER BBG.RMNAME.PROD1.RRS UACC(NONE)
    PERMIT BBG.RMNAME.PROD1.RRS CLASS(SERVER) ACCESS(READ) ID(PROD1USR)
    SETR RACLIST(SERVER) GENERIC(SERVER) REFR

    Si desea más información sobre el elemento nativeTransactionManager, consulte z/OS Transaction Management.

Procedimiento

  1. Actualice el archivo de configuración server.xml del servidor Liberty. Añada el subelemento de característica zosTransaction-1.0 al elemento featureManager:
    <featureManager>
      <feature>zosTransaction-1.0</feature>
    </featureManager>
    Al especificar esta característica se permite que el servidor de aplicaciones sincronice y gestione de forma adecuada la actividad transaccional entre los servicios de recuperación de recursos (RRS), el gestor de transacción del servidor de aplicaciones y el gestor de recursos. Así pues, no está permitido trabajar sin configurar la característica zosTransaction-1.0.
  2. Añada las bibliotecas nativas (DB2) del recurso al elemento de configuración <library> del recurso: El elemento <library> en el ejemplo muestra:
    <library id ="DB2T2LibRef">
      	<fileset dir="<YOUR DB2 T2 LIBRARY PATHS>" />
    	  <fileset dir="<YOUR DB2 T2 NATIVE LIBRARY PATHS>" />
    </library>	
  3. Configure los elementos jdbcDriver y datasource.

    Al definir el elemento del origen de datos, puede omitir la configuración del atributo type porque, de forma predeterminada, se utiliza el valor javax.sql.ConnectionPoolDataSource. Si opta por configurar explícitamente el atributo type, debe utilizar el valor: javax.sql.ConnectionPoolDataSource.

    El elemento de origen de datos puede incluir un elemento hijo llamado properties.db2.jcc. Los atributos proporcionados en el elemento properties.db2.jcc se pasan directamente al controlador DB2 JCC. El atributo driverType es necesario y se debe establecer en 2. También es necesario el atributo databaseName. El atributo ssid no es necesario, pero se puede utilizar para controlar a qué subsistema de DB2 para z/OS se conecta este origen de datos, si hay varios subsistemas DB2 en la LPAR.

Ejemplo

Este ejemplo describe cómo configurar la aplicación, el controlador jdbc, la biblioteca, el conjunto de datos y los elementos de origen de datos en el archivo de configuración server.xml.
<application type="war" id="db2T2TxWar" name="db2T2TxWar"
             location="/u/user1/wlp/usr/servers/defaultServer/dropins/db2T2Tx.war" />
<jdbcDriver id="DB2T2" libraryRef="DB2T2LibRef"/>

<library id="DB2T2LibRef">
  <fileset dir="/db2v10/jcc/classes" />
  <fileset dir="/db2v10/jcc/lib" />
</library>

<dataSource id="jdbc/DB2T2" jndiName="jdbc/DB2T2" jdbcDriverRef="DB2T2" type="javax.sql.ConnectionPoolDataSource">
  <properties.db2.jcc driverType="2" databaseName="LOC1" />
</dataSource>

Icono que indica el tipo de tema Tema de tarea

Nombre de archivo: twlp_using_DB2JDBCtype2drv_zos.html