Personalización y enlace de perfiles para aplicaciones SQLJ (Structured Query Language in Java)

Simplifique el proceso de personalizar y enlazar los perfiles SQLJ (Structured Query Language en Java) para las aplicaciones llevando a cabo estas funciones en la consola administrativa o con scripts. Los perfiles SQLJ deben personalizarse y enlazarse para que la aplicación empresarial puede utilizar el SQL incorporado de la aplicación.

Antes de comenzar

Debe disponer de una aplicación SQLJ que ya se haya desplegado e instalado en el servidor de aplicaciones.
En el caso de aplicaciones SQLJ que utilicen persistencia gestionada por contenedor, puede desplegar la aplicación de dos maneras:
  • Desplegar la aplicación SQLJ en el servidor de aplicaciones. Consulte el tema sobre el despliegue de aplicaciones SQLJ que utilizan la persistencia gestionada por contenedor (CMP) para obtener más información.
  • Desplegar aplicaciones SQLJ con la herramienta ejbdeploy. Consulte el tema sobre el despliegue de aplicaciones SQLJ que utilizan persistencia gestionada por contenedor (CMP) con la herramienta ejbdeploy.
Para aplicaciones SQLJ que utilizan persistencia gestionada por bean, consulte el tema sobre el despliegue de aplicaciones SQLJ que utilizan persistencia gestionada por bean, servlets o beans de sesión.

Acerca de esta tarea

Para sacar partido de las aplicaciones SQLJ en el servidor de aplicaciones, tiene que personalizar los perfiles SQLJ que contienen las sentencias SQL incorporadas. Por defecto, cuatro DB2® los paquetes se crean en la base de datos; uno para cada nivel de aislamiento. El proceso de personalización aumenta los perfiles con información específica del DB2 base de datos. La base de datos utiliza esta información en tiempo de ejecución.

Además de la personalización del perfil, debe vincular los perfiles personalizados al DB2 base de datos. El enlace de perfiles sólo debe tener lugar después de que se hayan personalizado los perfiles SQLJ.

También puede personalizar y enlazar perfiles con scripts o con la herramienta db2sqljcustomize:
  • Para obtener soporte de scripts, lea el tema sobre el grupo de mandatos de gestión de aplicaciones para el objeto AdminTask.
  • Para obtener información sobre la herramienta db2sqljcustomize, lea el tema sobre la personalización y enlace de perfiles SQLJ con la herramienta db2sqljcustomize para obtener más información. Si personaliza perfiles con la herramienta db2sqljcustomize, tendrá que volver a instalar la aplicación.

Procedimiento

  1. Asegúrese de que las tablas de base de datos necesarias existan, según se describe en el tema sobre despliegue de aplicaciones de acceso a datos.
  2. Vaya a la aplicación SQLJ que esté instalada en el servidor de aplicaciones.
    Hacer clic Aplicaciones >WebSphere Aplicaciones empresariales > nombre de la aplicación .
    Evite problemas: No ejecute varias sesiones de la consola administrativa para personalizar y vincular perfiles que estén en el mismo archivo EAR.
  3. Vaya a la sección de perfiles SQLJ.
    Hacer clic Perfiles SQLj. Al pulsar este enlace, el servidor de aplicaciones expandirá el archivo EAR de la aplicación en un directorio temporal; puede que se produzca un retraso antes de que se visualice el panel de perfiles SQLJ.
  4. Seleccionar Personalizar y vincular perfiles o Enlazar paquetes.
    Elija la opción que desee en función de los perfiles con los que vaya a trabajar:
    • Si los perfiles no se han personalizado o desea volver a personalizar los perfiles, elija Personalizar y enlazar perfiles SQLJ.
    • Si los perfiles ya se han personalizado, elija Enlazar paquetes.
  5. Decida si desea seleccionar perfiles individuales o un grupo de perfiles para personalizarlos y enlazarlos.
    • Seleccione los perfiles de la lista que se proporciona.
      1. Seleccione los perfiles en la lista y pulse Añadir. La lista muestra los perfiles SQLJ que hay presentes en la aplicación empresarial.
        Prácticas recomendadas:
        • Seleccione más de un perfil manteniendo pulsada la tecla CTRL.
        • Selecciona un lista perfiles contiguos seleccionando el nombre del primer perfil, manteniendo pulsada la tecla MAYÚS y seleccionando el último perfil. Seleccionará el primer perfil, el último perfil y los perfiles del medio.
      2. Seleccione Personalizar/enlazar los perfiles SQLJ seleccionados como un grupo. Esta opción especifica que el servidor de aplicaciones creará un archivo .grp que contiene los perfiles SQLj que se procesen. Puede utilizar el archivo .grp para otras operaciones de enlace en el futuro. Tras rellenar este panel y pulsar Aceptar, tendrá la opción de descargar el archivo .grp.
    • Seleccione Utilice un archivo de grupo de perfiles para especificar los perfiles SQLJ para personalizar/enlazar. Selecciónelo para especificar un grupo de perfiles que se deba procesar. Hacer clic Navegar... para localizar el archivo en el sistema.
  6. Rellene la información necesaria para conectar con la base de datos.
    Tiene que rellenar los campos siguientes:
    URL de base de daos
    Especifica el URL de la base de datos con la que se enlazarán los perfiles. La sintaxis habitual es:
    jdbc:db2://<host name="">:<port>/<database name="">.</database></port></host> or 
    o
    fully_qualified_host_name:port
    Usuario
    Especifica el ID de usuario del administrador de la base de datos del servidor donde se encuentra la base de datos.
    Contraseña
    Especifica la contraseña del administrador de la base de datos del servidor donde se encuentra la base de datos.
    Opciones adicionales
    Especifica las opciones adicionales que se deben utilizar durante los procesos de personalización y enlace. Ver el DB2 documentación para obtener una lista completa de opciones de personalización.
    Classpath
    Especifica la variable classpath donde se encuentran sqlj.zip y db2jcc.jar o db2jcc4.jar.
  7. Pulse Aceptar.
    Evite problemas: Si está procesando una aplicación empresarial grande o muchos perfiles SQLJ, el proceso puede tardar más que el tiempo de espera predeterminado para la consola administrativa. El tiempo de espera de conexión predeterminado de la consola administrativa del servidor de aplicaciones se ha establecido en 30 minutos. Si se supera el tiempo de espera predeterminado y se pierde la conexión con el servidor, podrá comprobar en los registros cronológicos de salida del sistema los resultados finales del proceso de personalización y enlace.

    Para evitar esta desconexión, configure el tiempo de espera de sesión de la consola con un valor de tiempo más alto. Trans realizar el proceso de personalización y enlace de forma satisfactoria, compruebe el archivo de registros cronológicos de salida del sistema para conocer el tiempo de proceso total. Utilice este período de tiempo como base para el nuevo valor de tiempo de espera. Para obtener información sobre cómo configurar el tiempo de espera de la consola, consulte el tema sobre cómo cambiar la caducidad de la sesión de la consola.

Resultados

Cuando el servidor de aplicaciones acabe de procesar los perfiles SQLJ, verá los resultados de la personalización y el enlace. El panel de resultados mostrará los mensajes del servidor de base de datos, así como un resumen de resultados del servidor de aplicaciones.
Si la operación ha finalizado satisfactoriamente, se imprimirá el mensaje siguiente en los registros cronológicos del sistema:
ADMA0507I=ADMA0507I: The SQLJ operation on application {0} completed successfully.  Exit code: {1}
ADMA0507I.explanation=This informational message indicates the program status.
ADMA0507I.useraction=No user action is required.
Si la operación no ha finalizado satisfactoriamente, el mensaje siguiente se imprimirá en los registros cronológicos de salida del sistema:
ADMA0506I=ADMA0506I: The SQLJ operation on application {0} did not complete successfully.  Exit code: {1}
ADMA0506I.explanation=The SQLJ operation encountered a problem.  This informational message indicates 
the program status. Prior messages in the command output give details of the problem.
ADMA0506I.useraction=Check the command output for the cause of the problem.