(C) IBM Corp. 1996, 2000
DB2 Text Extender Administración y programación
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 ]