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 usuariosRDEF 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
Ejemplo
<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>