Ejecutar el script Ant

Para facilitar la ejecución del programa de personalización de perfiles SQLJ de DB2, db2sqljcustomize, puede utilizar un script Ant. Este script Ant en particular es el que se crea cuando se ejecuta el mandato ejbdeploy SQLJ de proceso por lotes con un archivo EAR.

El script Ant se ejecuta con todos los perfiles de personalización de todos los JAR de EJB del EAR asociado. El script actualizará todos los archivos JAR de EJB con el perfil de personalización modificado y sustituirá los archivos JAR del EAR con la versión modificada. Este script Ant es específico del archivo EAR correspondiente y modifica el archivo EAR existente. Este script Ant ejecuta el programa de personalización de perfiles SQLJ de DB2 con todos los perfiles de personalización de todos los JAR de EJB del archivo EAR asociado.

Nota: Si tiene que ejecutar de nuevo el mandato ejbdeploy, también deberá ejecutar de nuevo el script Ant. No tendrá que generar un archivo de propiedades nuevo, a no ser que haya cambiado el número o los nombres de los archivos JAR del EAR o hayan cambiado los ID de programa de fondo de la base de datos que se utilizan en cualquiera de los archivos JAR.

Ejecutar el script

  1. Ejecute el script Ant, especificando el destino properties.
    ant -buildfile out.ear.xml properties

    Se creará un archivo de propiedades llamado out.ear.properties. Este archivo contiene propiedades que especifican los nombres por omisión de los paquetes correspondientes a cada perfil de personalización del archivo EAR, por ejemplo:

    pkg.One.jar.DB2UDBNT_V8_1=PKG2_
    
    pkg.Two.jar.DB2UDBNT_V8_1=PKG1_

    En este ejemplo, el archivo EAR contiene dos archivos JAR de EJB, One.jar y Two.jar.

  2. Edite el archivo de propiedades generado para cambiar los nombres de los paquetes. También puede especificar otras propiedades de este archivo, como el URL de base de datos, el usuario o la contraseña:
    url.One.jar.DB2UDBNT_V8_1=jdbc:db2://localhost:50000/dbx
    user.One.jar.DB2UDBNT_V8_1=dbuser
    password.One.jar.DB2UDBNT_V8_1=dbpassword
    pkg.One.jar.DB2UDBNT_V8_1=TEST
    url.Two.jar.DB2UDBNT_V8_1=jdbc:db2://localhost:50000/dby
    pkg.Two.jar.DB2UDBNT_V8_1=WORK
    Nota: DB2 utiliza sólo el primero de los siete (7) caracteres del nombre que especifica. El programa de personalización de perfiles SQLJ de DB2 utilizará el nombre para crear cuatro paquetes en la base de datos. Si especifica un nombre de PKG, el programa de personalización creará los paquetes llamados PKG1, PKG2, PKG3 y PKG4.
  3. Asegúrese de que las tablas de base de datos para los beans de empresa existen en la base de datos; de lo contrario, el paso de personalización dará un error.
  4. Asegúrese de que el archivo db2jcc.jar de DB2 se encuentra en la classpath. Debería haberse añadido a la classpath cuando se instaló DB2 V8.
    Nota: A partir de DB2 Versión 8 fixpack 2, debe añadir también el archivo JAR de licencia a la classpath. El archivo de licencia contenido en el archivo JAR permite la conectividad con el servidor. Hay archivos JAR de licencia distintos en función del tipo de servidor de base de datos que utilice:
    • db2jcc_license_cu.jar - para servidores Windows, UNIX y Cloudscape
    • db2jcc_license_cisuz.jar - para todos los servidores
    • db2jcc_license_c.jar - para servidores Cloudscape únicamente
En resumen, los sucesos siguientes son el resultado del paso de personalización:
  1. Se crean cuatro paquetes de base de datos que contienen el SQL estático, uno para cada nivel de aislamiento

    El script utiliza un conjunto de nombres por omisión para los paquetes creados en la base de datos.

  2. Se actualizan los perfiles de personalización generados

    El script actualizará todos los archivos
    JAR de EJB con el perfil de personalización modificado y sustituirá los archivos
    JAR del EAR con la versión modificada. Este script Ant es específico del
    archivo EAR correspondiente y modifica el archivo EAR existente. Para cada perfil de personalización, hay también propiedades para especificar el URL, el usuario y la contraseña. Por omisión, las propiedades del perfil de personalización se establecen a partir de las propiedades globales.

    Este script para un archivo EAR en particular lee propiedades de dos archivos, ejbdeploy.sqlj.properties y nombre_ear.properties (valor por omisión), donde nombre_ear es el nombre del archivo EAR. El archivo ejbdeploy.sqlj.properties es común a todos los scripts Ant generados por el mandato ejbdeploy, mientras que nombre_ear.properties es específico del script Ant del EAR. Si lo desea puede hacer que el script Ant utilice un archivo que no sea nombre_ear.properties especificando la propiedad script.property.file cuando ejecuta el script.

    Consejo: El archivo ejbdeploy.sqlj.properties es un buen lugar para especificar propiedades globales, como el ID de usuario de base de datos y la contraseña.
    Nota: Notas sobre los perfiles actualizados:
    • Deben estar disponibles para el código generado durante la ejecución.
    • Deben estar incluidos en el archivo JAR de EJB real, que se instala en WebSphere Application Server.

Si desea más información sobre cómo ejecutar Ant, consulte el manual de Apache Ant en la dirección ant.apache.org/manual/index.html

El archivo EAR actualizado ahora se puede instalar en WebSphere Application Server.

Conceptos relacionados
Programa de personalización de perfiles SQLJ de DB2
Condiciones de uso | Comentarios
(C) Copyright IBM Corporation 2000, 2005. Reservados todos los derechos.