Documentation
(C) IBM Corp. 1996, 2000

DB2 Text Extender Administración y programación


Obtención de información útil

Esta sección describe los mandatos para visualizar información sobre:

Visualización de información del estado habilitado

Resumen

Cuándo
Cuando necesite información sobre el estado habilitado de las bases de datos, las tablas, las columnas de texto o los archivos externos.

Mandato
GET STATUS

Autorización
Ninguna

Entre:

     db2tx GET STATUS

Este es un ejemplo de la salida visualizada por GET STATUS. Muestra el estado habilitado de la base de datos y de cualquier tabla, columna de texto o archivo de texto habilitados que contiene.

     La base de datos está habilitada para Text Extender
 
       La tabla DB2TX.MYTABLE está habilitada como tabla de índice común
 
       La tabla DB2TX.MYTABLE está habilitada como tabla de índice común
          NombreColTexto     NombreColDesCont
          --------------     ----------------
          COMMENT            COMMENTHANDLE
 
 
 
 
 
 
       La tabla DB2TX.TEST está habilitada como una tabla de múltiples índices
          NombreColTexto     NombreColDesCont
          --------------     ----------------
          ABSTRACT1          ABSTRACT1HANDLE
          ABSTRACT2          ABSTRACT2HANDLE

Visualización de los valores de las variables de entorno

Resumen

Cuándo
Cuando necesite información acerca de los valores de las variables de entorno.

Mandato
GET ENVIRONMENT

Autorización
Ninguna

Entre:

     db2tx GET ENVIRONMENT

Este es un ejemplo de la salida visualizada por GET ENVIRONMENT. Muestra los valores actuales de las variables de entorno de DB2 Text Extender.

 Instancia gestor base datos actual (DB2INSTANCE) = db2
 Nombre de base de datos por omisión   (DB2DBDFT) = my_database
 Nombre de instancia            (DB2TX_INSTOWNER) = user1
 Directorio instancias   (DB2TX_INSTOWNERHOMEDIR) = /usr/instance1

Visualización de los valores de configuración del texto

Resumen

Cuándo
Cuando necesite información de los valores por omisión para el texto, el índice y el proceso.

Mandato
GET TEXT CONFIGURATION

Autorización
Ninguna

Estos valores se describen en el apartado Valores de la configuración del texto. Para cambiarlos, consulte el apartado Cambio de configuración del texto.

Para visualizar la configuración del texto, entre:

     db2tx GET TEXT CFG

Este es un ejemplo de la salida visualizada por GET TEXT CONFIGURATION. Muestra los valores actuales de la configuración del texto.

  ID juego caract. codificad.(CCSID) = 850
  Idioma                  (LANGUAGE) = US_ENGLISH
  Formato                   (FORMAT) = TDS
 
  Tipo de índice         (INDEXTYPE) = LINGUISTIC
  Frecuencia actualiz.  (UPDATEFREQ) = NONE
  Directorio índices     (DIRECTORY) = user1/db2tx/indexes
 
  Opción actual. índic.(UPDATEINDEX) = UPDATE
  Cuenta compromiso    (COMMITCOUNT) = 10 000
  Nombre espacio tabla (TABLESPACE) = TXLOG
 

Visualización del estado de un índice

Resumen

Cuándo
Cuando necesite determinar si se puede buscar en un índice o si se puede actualizar el mismo.

Mandato
GET INDEX STATUS

Autorización
Ninguna

Pueden darse algunas situaciones que le impidan buscar en un índice o actualizarlo. En estas situaciones, se almacenan mensajes en la tabla de registro cronológico del índice que pueden ayudarle a determinar la causa. Por lo tanto, puede ser útil comprobar el estado de un índice y si hay algún mensaje disponible.

Este ejemplo visualiza el estado del índice de una tabla de índice común:

     db2tx GET INDEX STATUS db2tx.mytable

La sintaxis le permite visualizar el estado del índice para una columna de texto en particular. Este ejemplo obtiene el estado del índice de una columna de tabla de múltiples índices:

     db2tx GET INDEX STATUS db2tx.mytable HANDLE commenthandle

Este es un ejemplo de la salida visualizada por GET INDEX STATUS.

 Nodo 1
 Estado de búsqueda          = Búsqueda disponible
 Estado de actualización     = Actualización disponible
 Estado de reorganización    = iniciada 13.55
 Documentos planificados     = 0
 Documentos indexados        = 187000
 Documentos índice primario  = 130000
 Documentos índice secund.   =  57000
 Sucesos de error            = Ningún suceso de error

Si el índice se divide entre varios nodos, la información se visualiza por nodo.

Estado de búsqueda
Indica si puede utilizar la columna de descriptores de contexto especificada para buscar en el índice. Si la búsqueda no está disponible, compruebe el código de razón indicado para obtener más información acerca de porqué se ha producido la situación y después utilice RESET INDEX STATUS para poder volver a trabajar con el índice. Consulte el apartado Capítulo 20, Códigos de razón de sucesos de error.

Estado de actualización
Indica si puede actualizar el índice para la tabla o la columna especificada. Si la función de actualización del índice no está disponible, compruebe el código de razón indicado para obtener más información sobre porqué se ha producido la situación y, después, utilice RESET INDEX STATUS para poder volver a trabajar con el índice.

Estado de reorganización
Indica si puede reorganizar el índice para la tabla o la columna especificada. Si la función de reorganización no está disponible, compruebe el código de razón indicado para obtener más información acerca de porqué se ha producido la situación. Una razón normal para no poder utilizar la reorganización es porque se está actualizando el índice en este momento.

Documentos planificados
Muestra el número de documentos que se listan en la cola para indexación (o para suprimirlos del índice).

Documentos indexados
Muestra el número de documentos de la cola de documentos planificados que ya se han indexado.

Documentos índice primario
Muestra el número de documentos del índice primario.

Documentos índice secund.
Muestra el número de documentos del índice secundario.

Sucesos de error
Muestra el número de sucesos que están disponibles en la tabla de registro cronológico del índice. Puede visualizar esta información tal como se describe en el apartado Visualización de sucesos de error. Cuando ya no necesite esta información, puede suprimirla tal como se describe en el apartado Supresión de sucesos de índice.

Visualización de sucesos de error

Cuando se producen problemas durante la indexación como, por ejemplo, no se ha podido encontrar un documento planificado para la indexación, se graban los llamados sucesos de error en la tabla de registro cronológico del índice.

Los códigos de retorno de sucesos se describen en el Capítulo 20, Códigos de razón de sucesos de error.

Puede acceder a los sucesos de error en una vista de la tabla de registro cronológico llamada db2tx.LOGIXnnnnnn, donde IXnnnnnn es el nombre del índice, que se puede obtener en la vista del catálogo.

Para obtener el nombre del índice:

     DB2 SELECT TABLENAME,
                HANDLENAME,
                INDEXNAME
         FROM   DB2TX.TEXTCOLUMNS

La vista de sucesos de error tiene el diseño siguiente:

          UPDATESTATUS   SMALLINT
          EVENTREASON    INTEGER
          EVENTMESSAGE   VARCHAR(1024)
          UPDATETIME     TIMESTAMP
          HANDLE         DB2TEXTH o DB2TEXTFH
          NODENUMBER     INTEGER

Este es un ejemplo para mostrar cóomo puede acceder a la información del registro cronológico del índice:

     DB2 SELECT EVENTREASON,
                EVENTMESSAGE,
                UPDATETIME,
                HANDLE
         FROM   DB2TX.LOGIXNNNNNN

Visualización de los valores de índice

Resumen

Cuándo
Cuando necesite información acerca de los valores de un índice.

Mandato
GET INDEX SETTINGS

Autorización
Ninguna

Este ejemplo obtiene los valores del índice de una tabla de índice común:

     db2tx GET INDEX SETTINGS db2tx.mytable

Este ejemplo obtiene los valores del índice de una columna de tabla de múltiples índices:

     db2tx GET INDEX SETTINGS db2tx.mytable
                      HANDLE   commenthandle

Si la tabla se ha habilitado como tabla de múltiples índices, este mandato visualiza los valores de índice de todas las columnas de texto habilitadas en la tabla.

Este es un ejemplo de la salida visualizada por GET INDEX SETTINGS para una tabla de índice común. La salida para una tabla de múltiples índices muestra información similar para cada índice. La sintaxis le permite pedir los valores de índice para una columna de texto en particular.

       Valores de índice actuales:
 
            Tipo de índice        (INDEXTYPE)   = LINGUISTIC
            Opción actual. índic. (UPDATEINDEX) = UPDATE
            Frecuencia actualiz.  (UPDATEFREQ)  = NONE
            Nodo 1
            Directorio de índices (DIRECTORY)   = /home/user1/db2tx/indices
 

Si el índice se divide entre varios nodos, se visualiza la información de nodo para el directorio de índices.

Visualización de los valores de texto para una columna

Resumen

Cuándo
Cuando necesite información acerca de los valores de texto para una columna.

Mandato
GET TEXT INFO

Autorización
Ninguna

Este ejemplo obtiene la información de texto para el índice de una tabla de índice común:

     db2tx GET TEXT INFO db2tx.mytable

Este ejemplo obtiene la información de texto para el índice de una columna de tabla de múltiples índices:

     db2tx GET TEXT INFO db2tx.mytable HANDLE commenthandle

La sintaxis le permite especificar un nombre de tabla y el nombre de una columna de descriptores de contexto.

Si sólo especifica un nombre de tabla en el mandato, se visualiza la información de texto para cada columna habilitada en esta tabla. Si también especifica un nombre de columna de descriptores de contexto, sólo se visualiza la información de texto para esa columna.

Este es un ejemplo de lo que visualiza este mandato para una tabla de múltiples índices:

              Información de texto para la columna ABSTRACT1
                     con la columna de descriptores de contexto ABSTRACT1HANDLE:
              ID juego caract. codificad.(CCSID) = 850
              Idioma                  (LANGUAGE) = US_ENGLISH
              Formato                   (FORMAT) = TDS
 
            Información de texto para la columna ABSTRACT2
                     con la columna de descriptores de contexto ABSTRACT2HANDLE:
              ID juego caract. codificad.(CCSID) = 850
              Idioma                  (LANGUAGE) = US_ENGLISH
              Formato                   (FORMAT) = TDS


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