Información del cliente establecida implícitamente

Si localiza la información del cliente en la base de datos, puede elegir uno de los dos métodos para pasar los datos del cliente de WebSphere Application Server en las conexiones de base de datos.

Puede optar por pasar explícitamente la información de las conexiones llamando a una API propiedad de IBM® , setClientInformation(Properties), en el objeto com.ibm.websphere.rsadapter.WSConnection del código de la aplicación. El objeto com.ibm.websphere.rsadapter.WSConnection se encuentra en el archivo raíz_plugins/com.ibm.ws.runtime.jar. En algunos casos, no obstante, quizá desee que WebSphere Application Server maneje la transferencia de información del cliente a conexiones de base de datos. Se alude a este método de establecer la información del cliente como implícito. Podría seleccionar el método implícito porque:
  • Desea mantener la aplicación libre de las API propietarias, o bien,
  • La aplicación utiliza persistencia gestionada por contenedor (CMP), en cuyo caso no puede utilizar la API propietaria para establecer la información de cliente en conexiones de base de datos.

El recurso de rastreo de WebSphere Application Server proporciona la posibilidad de establecer implícitamente la información de cliente. Puede designar uno entre dos grupos especiales de rastreo para habilitar o inhabilitar la información del cliente pasando: Rastreo WAS.clientinfo o Rastreo WAS.clientinfopluslogging.

Escenarios posibles de ejecución

  • Compartimiento de conexiones

    En el caso del compartimiento de conexiones, WebSphere Application Server establece la información de cliente sólo en el primer manejador de conexión adquirido. Si está habilitada la compartición de conexiones y se llama a dos o más los métodos getConnection (que provocan dos manejadores en la misma conexión), sólo la primera llamada getConnection provoca que la información de cliente se pase a la base de datos de programa de fondo. Este caso no se aplica al proceso explícito de pasar información de cliente; en dichos casos cada método setClientInformation confía en la base de datos independientemente del compartimiento de conexiones.

  • Coexistencia implícita/explícita
    Cuando se utilizan los dos procedimientos, explícito e implícito, para confiar en la información de cliente, se combina alguna combinación de los datos establecidos de forma explícita e implícita, pero el valor explícito lleva la prioridad. Por ejemplo, si la aplicación establece la información contable del cliente en "myAccountingInfo" (Mi información contable), la serie accountingInfo (información contable) final que se pasa a la base de datos de programa de fondo se parece al siguiente código de ejemplo:
    000325_WSRdbManagedConnectionImpl@1234_myAccountingInfo: 
    Donde 000325 es el ID de hebra y WSRdbManagedConnectionImpl@1234 es la instancia de conexión de WebSphere.
  • Restablecimiento de la información del cliente

    Cuando configura el servidor de aplicaciones para que pase información de cliente, se restablece la información del cliente cuando la conexión se devuelve a la agrupación, pero sólo si se han inhabilitado los mecanismos de rastreo WAS.clientinfo y WAS.clientinfopluslogging (es decir, WAS.clientinfo=all=disabled:WAS.clientinfopluslogging=all=disabled).

    En el caso explícito no obstante, la operación de restablecimiento se realiza únicamente cuando la aplicación emite setClientInformation(null) en la conexión WSConnection.

Rastreo WAS.clientinfo

De forma predeterminada, el mecanismo implícito está inhabilitado. Puede activar este mecanismo de forma dinámica, sin detener e iniciar el servidor de aplicaciones, o bien estática configurando el grupo de rastreo WAS.clientinfo=all=enabled de WebSphere Application Server.

[AIX Solaris HP-UX Linux Windows][IBM i]La información recopilada de forma implícita y establecida en la conexión de base de datos consiste en nombre de usuario, ubicación de usuario y nombre de aplicación.

[z/OS]La información recopilada de forma implícita y establecida en la conexión de base de datos consta del ID de hebra, el nombre de usuario, la ubicación de usuario y el nombre de aplicación.

Importante: El nombre de usuario y la ubicación de usuario se pueden recopilar de forma implícita y se pueden establecer en la conexión de base de datos únicamente si habilita seguridad de Java™ 2.
[z/OS]ID de hebra
[z/OS]Un valor hexadecimal de ocho caracteres que identifica la hebra Java que controla el proceso de la solicitud de aplicación en WebSphere Application Server. Este ID se muestra en la cabecera de rastreo.
nombre de usuario
El nombre del usuario que inicia la solicitud de aplicación. Esta opción se recopila y se pasa a la base de datos de fondo (si está soportada). Esta información se recopila llamando al método WSSecurityHelper.getFirstCaller.
ubicación de usuario
El nombre de la ubicación del usuario, con el formato célula:nodo:servidor. Esta opción se recopila y se pasa a la base de datos de fondo (si procede). Esta información se recopila llamando al método WSSecurityHelper.getFirstServer.
nombre de aplicación
Nombre de la aplicación en ejecución. Este valor es la salida del método getApplication desde el objeto Nombre deJava EE. Este valor se recopila con independencia del valor de Seguridad global.

Rastreo WAS.clientinfopluslogging

Al depurar los problemas de base de datos, como los puntos muertos, hay cierta información que puede ayudarle de en la depuración. Esta información se obtiene normalmente habilitando un rastreo RRA (Relational Resource Adapter) de WebSphere y un rastreo de contenedor de Enterprise JavaBeans (EJB). Sin embargo, hay casos en los que el momento en el tiempo es clave a la hora de reproducir un problema. Disponer de demasiada información de rastreo puede alterar el comportamiento de la aplicación, como un cambio de tiempos, y no volver a darse el problema.

Debido a esta situación, se proporciona un nuevo grupo de rastreo en el que sólo se recopila un conjunto mínimo de datos. Este grupo de rastreo es WAS.clientinfopluslogging. Esta función establece la información de cliente de forma implícita en la conexión, igual que el rastreo de WAS.clientinfo, y registra y rastrea actividades importantes de aplicaciones. Esas actividades son:
  • Series SQL que se ejecutan (como, select userId from tabl1 where id =? para su actualización).
  • Inicio, compromiso y retrotracción de transacciones.
  • Llamadas de EJB (por ejemplo, Create, Remove, findByPrimaryKey).

Icon that indicates the type of topic Reference topic



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