[z/OS]

Utilización del rastreo en los adaptadores locales optimizados

WebSphere Application Server para z/OS proporciona soporte para establecer niveles de rastreo de adaptador local optimizado para ayudarle en la diagnosis de aplicaciones, conexiones o servidores. Puede establecer el nivel de rastreo en tres niveles, para capturar datos de rastreo detallados, generales, o no capturarlos. Se ha designado como los niveles de rastreo 2, 1 y 0.

Antes de empezar

El soporte de rastreo dinámico en los adaptadores locales optimizados proporciona varios métodos para establecer o cambiar los niveles de rastreo existentes, sin reiniciar el servidor, que incluyen los niveles siguientes:
  • Predefinir el rastreo a nivel de servidor en los archivos de propiedades. Esto le permite tener un conjunto de rastreo definido cuando se inicia el servidor, de modo que el proceso de adaptador local optimizado está preparado, inmediatamente, con el rastreo habilitado. Puede utilizar la consola administrativa de WebSphere Application Server para z/OS y el mandato system modify SETOLATRACEPROPS para designar el archivo de propiedades y activarlo.
  • Defina el nivel de rastreo. Puede utilizar el archivo de propiedades de rastreo para especificar ambos niveles de rastreo por omisión a nivel de servidor y los niveles de rastreo individuales para las conexiones que todavía no se han registrado en el adaptador local optimizado. El nivel de rastreo puede ser establecido en 0, 1 o 2 para cada entrada en el archivo de propiedades.
  • Utilice el mandato operator modify SETOLATRACE de z/OS para establecer un nivel de rastreo específico para los registros existentes. El mandato también puede establecer el nivel de rastreo de un nombre de registro, nombre de trabajo o bloque de control de entrada de registro (RGE) específico, en el almacenamiento controlado de servidor.
  • Utilice un símbolo de asterisco (*) como carácter comodín, tanto en el archivo de propiedades de rastreo como en el mandato modify SETOLATRACE, para indicar un valor para varios grupos de conexiones. La característica de comodín puede especificar varios nombres de registro en el archivo de propiedades o el valor predeterminado del sistema, y puede establecer varios nombres de registro y nombres de trabajo, en el mandato modify SETOLATRCE.
  • El desarrollador de una aplicación que utilice los adaptadores locales optimizados también puede establecer el rastreo durante la vida de la conexión del programa cuando el registro se realice estableciendo los distintivos de rastreo en la llamada a BBOA1REG.

Acerca de esta tarea

Procedimiento

  1. Predefina los niveles de rastreo. Al predefinir los niveles de rastreo, estará preparado para capturar los datos de rastreo de la conexión y del registro en cuanto se inicialice el adaptador local optimizado. También estará preparado para seguir la actividad de las conexiones que aún no se hayan registrado; cuando se efectúen los registros indicados, el rastreo se producirá automáticamente. Predefina los niveles de rastreo de la forma siguiente:
    1. Cree un archivo de propiedades de rastreo en HFS. Este archivo debe estar en formato EBCDIC y se debe poder acceder al mismo con el daemon de WebSphere Application Server para z/OS.
      La sintaxis del archivo de propiedades de rastreo sigue la sintaxis <palabra clave>=<parámetro> del archivo de propiedades de WebSphere Application Server. En este caso, la propiedad tiene la sintaxis siguiente:
      <registration_name>=<trace_level>
      donde:

      <registration_name> es una cadena alfanumérica

      <trace_level> es 0, 1 o 2

      Por motivos de claridad, puede utilizar un estilo de sintaxis de comillas simples o dobles cuando indique el nombre de registro, por ejemplo:
      MYREGNAME=1 "CICSREG"=2 'SHORTREG'=0 
      También puede agrupar registros de nombre parecido en una línea, utilizando asteriscos como caracteres comodín, por ejemplo:
      REGNAME*=1 *NAME=2 "REG*NAME"=0
      Un carácter # inicial indica el principio de un comentario, a menos que se encuentre dentro de una serie entrecomillada.
      Importante:
      • Los niveles de rastreo que no sean válidos se tratarán como un 0. Por ejemplo, REGNAME=ALL se tratará como el nivel de rastreo 0.
      • Un nombre de registro "*" se trata como el nivel de rastreo predeterminado, por ejemplo, si se especifica *=1, el valor predeterminado para cualquier registro nuevo en un nivel general de rastreo.
      • El archivo de propiedades pueden tener un máximo de 1.024 especificaciones de rastreo.
      El mandato SETOLATRACEPROPS emite un mensaje de respuesta que muestra cuántas definiciones de rastreo se han procesado para los registros distintos del valor predeterminado del sistema.
    2. Cree una variable de entorno WAS_DAEMON_ONLY_ola_trace_settings_file en la consola administrativa.
    3. Establezca la variable como una serie en la vía de acceso totalmente calificada y el nombre de archivo del archivo de propiedades de rastreo en HFS, y active la variable.
      Si esta variable de entorno está establecida y se guarda en la configuración de WebSphere Application Server, el archivo de propiedades se procesa durante la inicialización del servidor. Puede actualizar el archivo de propiedades de rastreo, y activar las definiciones nuevas, emitiendo el mandato modify SETOLATRACEPROPS, y las propiedades de rastreo nuevas afectarán a los registros nuevos. La sintaxis es:
      F nombre_daemon,SETOLATRACEPROPS 
      Atención: Activar un archivo de propiedades de valores de rastreo desactiva las propiedades de rastreo que estén activas actualmente.
  2. Modifique los valores de rastreo para las conexiones existentes. Para las conexiones actuales que utilicen los adaptadores locales optimizados, puede activar o desactivar el rastreo mediante el mandato modify SETOLATRACE. El mandato tiene estos formatos:
    F servername,SETOLATRACE=tracelevel,REGNAME=namestring
    F servername,SETOLATRACE=tracelevel,JOBNAME=namestring
    F servername,SETOLATRACE=tracelevel,RGE=hexaddress
    El nivel de rastreo puede ser 0, 1 o 2 para, por orden: sin rastreo, nivel general de rastreo, y rastreo detallado.
    El valor namestring especifica el nombre de registro, o el nombre de trabajo, del registro existente que debe modificarse. Puede delimitar el valor namestring con comillas simples o dobles que coincidan. Asimismo, puede utilizar un asterisco como carácter comodín para modificar más de un trabajo o registro que tengan un nombre parecido. Si utiliza un asterisco solamente, dicha opción afectará a cada uno de los registros existentes. Puede desactivar todos los registros de rastreo actuales mediante cualquiera de estos mandatos:
    F servername,SETOLATRACE=0,REGNAME=*
    F servername,SETOLATRACE=0,JOBNAME=*

    En los casos en los que desee indicar como destino un registro específico mediante dirección de la RGE del servidor de almacenamiento controlado, puede utilizar el formato RGE=hexaddress del mandato. La dirección hexadecimal es una serie no entrecomillada de números hexadecimales. Este enfoque es probablemente uno que el equipo de soporte de IBM® le instará a utilizar.

    El mandato SETOLATRACE muestra un mensaje de respuesta que indica cuántos registros se han visto afectados.

  3. Especifique los valores de rastreo en el registro. Puede solicitar el rastreo en el código que llama a la API BBOA1REG para crear el registro para el adaptador local optimizado. La interfaz a BBOA1REG contiene un parámetro llamado registerflags. Los valores de nivel de rastreo para un registro se pueden modificar estableciendo uno o más de los valores siguientes en el parámetro registerflags :
    reg_flag_trcmod    EQU X'80000000' modify trace level 
    reg_flag_trcmore   EQU X'40000000' trace level=2        
    reg_flag_trcsome   EQU X'20000000' trace level=1 

    Establezca reg_flag_trcmod si desea modificar los valores de rastreo para el registro. Si no establece este distintivo, no se efectúa cambio alguno en el valor de rastreo, y se utilizan los valores predeterminados del sistema, o los valores de rastreo predefinidos, que se aplican al nombre de registro o nombre de trabajo.

    Establezca reg_flag_trcmore o reg_flag_trcsome si desea obtener un rastreo detallado o un nivel de rastreo general. Si deja ambos establecidos en "off", se fuerza que no se efectúe ningún rastreo, independientemente de qué valores predefinidos o predeterminados se hayan establecido.


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_usetraceinfoola
File name: tdat_usetraceinfoola.html