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

Simplifique el proceso de personalizar y enlazar los perfiles SQLJ 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 de empresa puede utilizar el SQL incorporado de la aplicación.

Antes de empezar

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. De manera predeterminada, se crean cuatro paquetes de DB2 en la base de datos: uno para cada nivel de aislamiento. El proceso de personalización aumenta los perfiles con información que es específica de la base de datos DB2. La base de datos utiliza esta información en tiempo de ejecución.

Además de la personalización de perfiles, tiene que enlazar los perfiles personalizados con la base de datos DB2. 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. Pulse Aplicaciones > Aplicaciones de empresa WebSphere > nombre_aplicación.
    Avoid trouble Avoid trouble: No ejecute varias sesiones de la consola administrativa para personalizar y enlazar perfiles que estén en el mismo archivo EAR.gotcha
  3. Vaya a la sección de perfiles SQLJ. Pulse 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. Seleccione Personalizar y enlazar perfiles SQLJ 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 de empresa.
        Best practice Best practice:
        • 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.
        bprac
      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. Pulse Examinar... 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 datos
    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> o 
    o bien
    nombre_host_plenamente_cualificado:puerto
    Usuario
    Especifica el ID de usuario para el administrador de base de datos en el servidor donde se encuentra la base de datos.
    Password
    Especifica la contraseña para el administrador de base de datos en el 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. Consulte la documentación de DB2 para obtener una lista completa de las opciones de personalización.
    Classpath
    Especifica la variable classpath donde se encuentran sqlj.zip y db2jcc.jar o db2jcc4.jar.
  7. Pulse Aceptar.
    Avoid trouble Avoid trouble: Si va a procesar aplicaciones de empresa de gran tamaño o va a procesar muchos perfiles SQLJ, puede que el proceso supere el tiempo de espera predeterminado de la consola administrativa. El tiempo de espera de conexión por omisión 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.

    gotcha

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: La operación de SQLJ sobre la aplicación {0} se ha completado satisfactoriamente.  Código de salida: {1}
ADMA0507I.explanation=Este es un mensaje informativo que indica el estado del programa.
ADMA0507I.useraction=No se requiere ninguna acción del usuario.
Si la operación no ha finalizado satisfactoriamente, el mensaje siguiente se imprimirá en los registros cronológicos de salida del sistema:
ADMA0506I=ADMA0506I: La operación de SQLJ sobre la aplicación {0} no se ha completado satisfactoriamente.  Código de salida: {1}
ADMA0506I.explanation=La operación SQLJ ha detectado un problema.  Este es un mensaje informativo que indica el estado del programa. Los mensajes anteriores en la salida de mandatos proporcionan detalles del problema.
ADMA0506I.useraction=Compruebe la salida del mandato en busca del motivo del problema.

Icon that indicates the type of topic Task topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tdat_sqljcustomize
File name: tdat_sqljcustomize.html