Documentation
(C) IBM Corp. 1996, 2000

DB2 Text Extender Administración y programación

TXTRACE

Este mandato graba la información del proceso en un almacenamiento intermedio de rastreo en la memoria compartida. Esta información se puede utilizar para rastrear anomalías. Puede grabarse en binario desde el almacenamiento intermedio de rastreo en un archivo para formatearlo más tarde cuando se haya desactivado el rastreo o puede formatearse y grabarse en un archivo mientras el rastreo esté activo todavía.

Authorization

(Sólo para UNIX) SYSADM, DBADM

Command syntax

>>-txtrace--| parámetros |-------------------------------------><
 
parámetros
 
|---+-on--+---------------+-----------------------------------------------------+->
    |     '-| opciones |--'                                                     |
    +-dump--| archivo-vuelco |--------------------------------------------------+
    +-off-----------------------------------------------------------------------+
    +-format--+---------------+---+->------------------+---| archivo-formato |--+
    |         '-| opciones |--'   '-| archivo-vuelco |-'                        |
    +-change--------------------------------------------------------------------+
    +-clear---------------------------------------------------------------------+
    +-flow----------------------------------------------------------------------+
    '-information---------------------------------------------------------------'
 
>---------------------------------------------------------------|
 
opciones
 
    .-------------------------------------------------------------------------.
    V                                                                         |
|-----+- -m--productos--.--sucesos--.--componentes--.--funciones-----------+--+->
      +- -rc--código-retorno-----------------------------------------------+
      +- -e--errores-máx-sistema-------------------------------------------+
      +- -r--tamaño-máx-registro-------------------------------------------+
      '- -i--tamaño-almac-interm-inicial--|-- -l--tamaño-últ-almac-interm--'
 
>---------------------------------------------------------------|
 
archivo-vuelco
 
|---+-------------+---nombre-archivo-vuelco---------------------|
    '-vía-acceso--'
 
archivo-formato
 
|---+-------------+---nombre-archivo-formato--------------------|
    '-vía-acceso--'
 

Command parameters
Nota:

También está disponible la opción -u con todos los parámetros de TXTRACE para visualizar la información acerca del parámetro.

on
Para iniciar el recurso de rastreo.

dump | dmp
Para grabar la información de rastreo en binario en un archivo.

off
Para detener el recurso de rastreo.

format | fmt
Para formatear la información de rastreo en binario. Puede formatear el archivo de vuelco, cuando el rastreo esté desactivado, especificando el nombre del archivo de vuelco y el nombre del archivo que ha de contener la información de rastreo formateada. Para formatear la información de rastreo directamente desde el almacenamiento intermedio de rastreo mientras el rastreo todavía está activado, entre: destrc format > nombarch.tmp.

change | chg
Para cambiar la máscara de rastreo, maxSysErrors o maxRecordSize.

clear | clr
Para borrar el rastreo.

flow | flw
Para mostrar el flujo de control del rastreo.

information | info | inf
Para obtener información acerca del rastreo.

opciones
Para filtrar la información de rastreo cuando el rastreo está activado (esto reduce la utilización de memoria compartida) o cuando se formatea la información de rastreo. A menos que el rastreo sea muy grande, normalmente resulta más fácil grabar toda la información de rastreo y después filtrarla durante el formateo.

-m
Para añadir una "máscara" para especificar los sucesos, los componentes y las funciones que se han de incluir en el rastreo. El valor por omisión es rastrearlo todo. La máscara consta de cuatro partes, separadas por puntos; por ejemplo: 2.2-6.1,3.* Puede especificar un rango utilizando "-" como carácter separador o una lista utilizando "," como carácter separador. Por ejemplo: 2-6 sólo incluye los sucesos cuyos ID están en el rango de 2 a 6. Para incluir solamente los componentes 2 y 6, especifique 2,6

productos
El ID de producto. El ID de producto para DB2 Text Extender es "2". El ID de producto para TextMiner es "3".

sucesos
El conjunto de tipos de sucesos que se ha de incluir en el rastreo:
0
error_sistema
1
error_sistema
2
error_sistema
3
error_no-grave
4
error_no-grave
5
códerror_api
7
códerror_fnc
8
error de ruptura
10
entrada_api
11
salida_api
13
códret_api
15
datos_api
30
entrada_fnc
31
salida_fnc
33
códret_fnc
35
datos_fnc

componentes
Los componentes que se han de rastrear.

Los ID de componente para DB2 Text Extender son:

1
COMMAND_LINE_INTERFACE
2
UDF
3
STORED_PROCEDURES
4
ADMINISTRATION
5
INDEX_CONTROL
6
LIBRARY_SERVICES
7
DES_PARSER
8
DES_DEMON
9
DES_API
10
SERVICES

Los ID de componente para TextMiner son:

1
automachine
2
bgproc (proceso de fondo)
3
cluster
4
common
5
commsrvc (servicios comunes)
6
communic (comunicación)
7
daemon
8
dsclient
9
environ (entorno)
10
glue
11
idxcomm (creación índice, parte común)
12
libsrv (servicios de biblioteca)
13
search
14
trace
15
guru
16
indexbld (creación de índice, sólo tm)
17
indexeng (aplicación de índice, sólo tm)
18
smsearch
19
(aplicación de índice, sólo tm)
20
tmsearch
21
gtrcm (gtr, parte común)
22
gtrsrch (búsqueda, sólo gtr)
23
gtridx (creación de índice, sólo gtr)

funciones
Asterisco (*). El conjunto de funciones que se ha de rastrear. Utilice un asterisco (*) para rastrear todas las funciones a menos que el Centro de soporte de IBM le indique lo contrario.

-rc código-retorno
Trata el código-retorno como un error del sistema.

-e errores-máx-sistema
Entero. Para detener el rastreo después de este número de errores. El valor por omisión es 1 que especifica que cuando se produce el primer error del sistema, se suprime el rastreo de todos los sucesos de gravedad inferior. Esto es aceptable si sólo está interesado en el primer error principal, pero debe especificar un número superior (por ejemplo, -e 50) si desea ver todo el rastreo después del error del sistema inicial. El destino del rastreo es la memoria compartida.

-r tamaño-máx-registro
Entero. Para detener el rastreo después de que se haya grabado este número de registros en el archivo de rastreo. El valor por omisión es 16 KB.

-i tamaño-alm-interm-inicial
Entero. Para mantener este número de registros desde el principio del rastreo. Si se especifica -i, el valor por omisión es 16 KB. En un sistema UNIX, el tamaño de almacenamiento intermedio recomendado es de 2 MB.

Si no se especifican -i ni -l, -l es el valor por omisión.

Si especifica -i, no se produce el reinicio; no se graban más entradas de rastreo si el volumen de registros sobrepasa el tamaño-máx-registro, incluso si borra todas las entradas de rastreo. Para grabar las nuevas entradas de rastreo, aumente el tamaño de almacenamiento intermedio, desactive el rastreo y, después, vuelva a activarlo.

-l tamaño-últ-almac-interm
Entero. Para mantener este número de registros del final del rastreo. El valor por omisión es 16 KB. En un sistema UNIX, el tamaño de almacenamiento intermedio recomendado es de 2 MB.

vía-acceso
El directorio en el que se almacena el archivo correspondiente.

nombre-archivo-vuelco
El nombre del archivo que contiene la información de rastreo en binario.

nombre-archivo-formateado
El nombre del archivo que contiene la información de rastreo formateada.

Examples

Consulte el apartado Rastreo de anomalías.


[ Principio de página | Página anterior | Página siguiente | Contenido | Índice ]