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.