Documentation
(C) IBM Corp. 1996, 2000

DB2 Text Extender Administración y programación


Capítulo 17. Códigos de retorno

Este capítulo lista los códigos que la API de DB2 Text Extender devuelve en respuesta a una llamada de función. Se listan por orden alfabético.

Todas las llamadas a API de DB2 Text Extender devuelven un código de retorno numérico como valor de función C. Los códigos de retorno se definen en el archivo include DES_EXT.H proporcionado con DB2 Text Extender.

La API de DB2 Text Extender intercepta situaciones de error e informa de las condiciones de error utilizando un código de retorno.

Las aplicaciones que llaman a las funciones API de DB2 Text Extender deben comprobar siempre el código de retorno antes de intentar procesar cualquier otro parámetro de salida. Los códigos de retorno posibles para cada llamada se listan, junto con sus parámetros, en el Capítulo 13, Funciones API para la búsqueda y examen.

En algunos casos, una entrada incorrecta como, por ejemplo, un puntero de sesión obsoleta puede provocar una condición de fin anómalo en los servicios API que DB2 Text Extender no puede interceptar.

RC_ALLOCATION_ERROR 

Explicación: No se puede asignar almacenamiento para uso interno.

Lo que se ha de hacer: Asegúrese de que hay suficiente memoria disponible.

RC_FILE_IO_PROBLEM 

Explicación: DB2 Text Extender no ha podido leer o grabar un archivo.

Lo que se ha de hacer: Compruebe que hay suficiente espacio de disco y memoria disponible en el servidor. Compruebe que las variables de entorno y los valores de configuración del texto son correctos.

RC_INVALID_BROWSE_INFO 

Explicación: La información de examen devuelta por DesGetSearchResultTable o por DesGetBrowseInfo y utilizada como entrada para DesStartBrowseSession no es válida.

Lo que se ha de hacer: Compruebe si un error de programación prevalece sobre la información de rastreo.

RC_INVALID_BROWSE_OPTION 

Explicación: La opción de examen de DesGetSearchResultTable no es válida.

Lo que se ha de hacer: Asegúrese de que la opción es BROWSE o NO_BROWSE.

RC_INVALID_MATCH_OPTION 

Explicación: Las opciones de coincidencia utilizadas en DesOpenDocument no son válidas.

Lo que se ha de hacer: Compruebe que la opción es FAST o EXTENDED.

RC_INVALID_PARAMETER 

Explicación: Uno de los parámetros de entrada es incorrecto.

Lo que se ha de hacer: Lea el mensaje de error devuelto por DB2 Text Extender para determinar la causa.

RC_INVALID_SEARCH_OPTION 

Explicación: La opción de búsqueda de DesGetSearchResultTable no es válida.

Lo que se ha de hacer: Asegúrese de que la opción es DES_TEXTHANDLEONLY, DES_RANK, DES_MATCH o DES_RANKANDMATCH.

RC_INVALID_SESSION 

Explicación: El puntero de sesión especificado en la llamada al servicio actual no es correcta o es obsoleta.

Lo que se ha de hacer: Guarde la información que sirva de ayuda para encontrar la causa del error, después finalice la aplicación.

RC_NO_BROWSE_INFO 

Explicación: DB2 Text Extender no ha devuelto ninguna información de examen. Esto es debido a que el argumento de búsqueda ha generado un resultado de búsqueda vacío. No se trata de ningún error.

Lo que se ha de hacer: No es necesaria ninguna acción.

RC_PARSER_INVALID_ESCAPE_CHARACTER 

Explicación: Los criterios de búsqueda contienen un carácter de escape incorrecto. Se informa de este error si se utiliza un blanco como carácter de escape o si se especifica más de un carácter de escape para una palabra o una frase en los criterios de búsqueda. Ejemplo: ESCAPE " " o ESCAPE "#$".

Lo que se ha de hacer: Compruebe la sintaxis del argumento de búsqueda y vuelva a intentarlo.

RC_PARSER_INVALID_USE_OF_ESCAPE_CHAR 

Explicación: La sintaxis del carácter de escape de los criterios de búsqueda no puede interpretarse.

Lo que se ha de hacer: Compruebe la sintaxis del carácter de escape. Por ejemplo, si $ es el carácter de escape especificado, la palabra o la frase sólo puede contener $$, $_ o $%, donde _ y % son los símbolos de máscara.

RC_PARSER_SYNTAX_ERROR 

Explicación: La sintaxis de los criterios de búsqueda no se puede interpretar.

Lo que se ha de hacer: Compruebe la sintaxis del argumento de búsqueda, consultando el Capítulo 12, Sintaxis de los argumentos de búsqueda.

RC_RESULT_TABLE_NOT_EXIST 

Explicación: Está intentando almacenar el resultado de una búsqueda en una tabla que no existe.

Lo que se ha de hacer: Cree una tabla de resultados tal como se muestra en la Figura 15.

RC_SE_BROWSER_TIME_OUT 

Explicación: Se ha iniciado el proceso de búsqueda pero no ha respondido en un tiempo aceptable. DB2 Text Extender ha cancelado el proceso pendiente.

Este error puede producirse cuando el sistema no tiene suficiente espacio de almacenamiento o tiene una carga excesiva.

Lo que se ha de hacer: Termine la sesión de examen llamando a DesEndBrowseSession, libere el almacenamiento asignado llamando a DesFreeBrowseInfo y vuelva a intentarlo.

RC_SE_CAPACITY_LIMIT_EXCEEDED 

Explicación: La función pedida no puede procesarse. No hay suficiente memoria o espacio de disco.

Lo que se ha de hacer: Finalice el programa y compruebe los recursos del sistema.

RC_SE_COMMUNICATION_PROBLEM 

Explicación: Ha fallado la comunicación con el servidor DB2 Text Extender. El error puede haberse producido por una falta de espacio de almacenamiento o por una instalación incorrecta de DB2 Text Extender.

Lo que se ha de hacer: Guarde la información que sirva de ayuda para encontrar el error, después finalice la aplicación.

RC_SE_CONFLICT_WITH_INDEX_TYPE 

Explicación: La especificación del término de búsqueda lingüístico de la consulta con corresponde al tipo de índice. Por ejemplo, PRECISE FORM OF no se puede utilizar con un índice lingüístico. La especificación de lingüístico por omisión se utiliza tal como se muestra en la Tabla 7.

Lo que se ha de hacer: Adapte la aplicación para impedir la especificación de opciones de consulta que entren en conflicto con el tipo de índice.

RC_SE_DICTIONARY_NOT_FOUND 

Explicación: Los servicios lingüísticos de DB2 Text Extender no pueden encontrar los archivos de diccionario. La consulta se procesa sin el soporte lingüístico. Los archivos de diccionarios correspondientes al código o códigos del idioma especificado no están en la vía de acceso esperada.

Lo que se ha de hacer: Puede continuar llamando a API. Para UNIX, compruebe que el diccionario necesario está en la vía de acceso {DB2TX_INSTOWNERHOMEDIR}/db2tx/dicts. Para OS/2, compruebe que el diccionario necesario está en la vía de acceso especificada en el valor de configuración del texto DB2TX_DATA. Si es necesario, instale el diccionario necesario.

RC_SE_DOCMOD_READ_PROBLEM 

Explicación: Cuando se crea la instancia de DB2 Text Extender, se pone un archivo de modelos de documentos denominado desmodel.ini en el directorio de instancia. Cuando se crea un índice, también se pone un archivo desmodel.ini en el directorio de índices IXnnnnnn. Este archivo de modelos de documentos no se ha podido leer.

Lo que se ha de hacer: Compruebe que existe el archivo de modelos de documentos y que está en el directorio correcto.

RC_SE_DOCUMENT_NOT_ACCESSIBLE 

Explicación: Se ha encontrado el documento de texto pedido, pero no se puede acceder en este momento.

Lo que se ha de hacer: Compruebe si otra tarea o usuario está accediendo de forma exclusiva al documento.

RC_SE_DOCUMENT_NOT_FOUND 

Explicación: El documento de texto pedido no se ha encontrado. La causa más probable es que se ha suprimido un documento de texto del almacenamiento, pero todavía no se ha eliminado del índice de DB2 Text Extender. Esto también puede ocurrir si intenta examinar un documento identificado por un descriptor de contexto dañado.

Lo que se ha de hacer: En la mayoría de casos, puede pasar por alto este código de retorno. No se volverá a visualizar después de la próxima actualización del índice.

Si persiste, compruebe que el programa de aplicación está pasando el descriptor de contexto encontrado correctamente para el examen.

RC_SE_EMPTY_INDEX 

Explicación: El índice de DB2 Text Extender correspondiente a la columna de descriptores de contexto direccionada por la petición de búsqueda está vacío. No se han añadido documentos de texto a este índice o se han eliminado del mismo todos los documentos de texto.

Esto puede producirse cuando se ha habilitado una columna de texto, pero los documentos de la columna no se han indexado todavía. Es decir, ha especificado en el mandato ENABLE TEXT COLUMN que el índice se ha de crear más tarde, en el momento determinado por los valores de la indexación periódica.

También puede producirse cuando se ha habilitado una tabla de texto para crear un índice común vacío para todas las columnas de texto, pero no se ha habilitado ninguna de las columnas de texto.

Lo que se ha de hacer: Si se ha utilizado ENABLE TEXT TABLE para crear un índice común vacío para todas las columnas de texto, ejecute ENABLE TEXT COLUMN para una de las columnas de texto como mínimo que contenga el texto que se ha de buscar. En este mandato, puede determinar si el índice se crea inmediatamente o en el momento determinado por los valores de indexación periódica.

Ejecute GET INDEX STATUS para comprobar que el índice se ha creado satisfactoriamente.

RC_SE_EMPTY_QUERY 

Explicación: DB2 Text Extender ha analizado y procesado lingüísticamente los criterios de búsqueda especificados. Un error de programación ha provocado que se efectúe una consulta que no contenía ningún término de búsqueda o todos los términos de búsqueda eran palabras de parada (palabras que DB2 Text Extender no indexa) que se han eliminado de la consulta. El resultado ha sido ningún término de búsqueda.

Lo que se ha de hacer: Vuelva a escribir la consulta. Si el problema persiste, compruebe si existe un error de programación.

RC_SE_END_OF_INFORMATION 

Explicación: No se trata de ningún error. Se ha alcanzado el final del documento. No hay más información disponible para DesGetMatches.

Lo que se ha de hacer: Utilice este código de retorno para finalizar el proceso iterativo del documento con DesGetMatches.

RC_SE_FUNCTION_DISABLED 

Explicación: La función pedida ha llamado a una función de DB2 Text Extender que el administrador ha impedido.

Lo que se ha de hacer: Pida ayuda al administrador. Puede que sea necesario detener y reiniciar DB2 Text Extender (txstop/txstart).

RC_SE_FUNCTION_IN_ERROR 

Explicación: La función pedida se ha bloqueado debido a una situación de error en el servidor DB2 Text Extender. La llamada a la API no puede procesarse.

Lo que se ha de hacer: Compruebe el estado del índice. Compruebe el espacio disponible en el directorio de índices. Restablezca el estado del índice y reintente el mandato.

RC_SE_INCORRECT_HANDLE 

Explicación: Un descriptor de contexto especificado en un parámetro de entrada como, por ejemplo, descriptor de contexto de sesión de examen no es válido. Debe ser un descriptor de contexto que una llamada anterior haya devuelto y que no esté obsoleto.

Lo que se ha de hacer: Guarde la información que pueda servir de ayuda para encontrar la causa del error y, a continuación, termine la sesión llamando a DesEndBrowseSession.

Compruebe si un error de programación ha producido un descriptor de contexto incorrecto.

RC_SE_INDEX_DELETED 

Explicación: El índice de DB2 Text Extender al que se está accediendo se ha suprimido.

Lo que se ha de hacer: Póngase en contacto con el administrador de DB2 Text Extender para volver a crear el índice.

RC_SE_INDEX_NOT_ACCESSIBLE 

Explicación: No se puede acceder al índice de DB2 Text Extender y la llamada actual no puede procesarse.

Lo que se ha de hacer: Pida al administrador de DB2 Text Extender que compruebe la posibilidad de acceso del índice.

RC_SE_INDEX_SUSPENDED 

Explicación: DB2 Text Extender ha recibido una petición relativa a un índice que otra sesión o la sesión actual ha suspendido.

Lo que se ha de hacer: Pida al administrador de DB2 Text Extender que compruebe el estado del índice.

RC_SE_INSTALLATION_PROBLEM 

Explicación: DB2 Text Extender ha encontrado un problema de instalación.

Lo que se ha de hacer: Compruebe el valor actual de las variables de entorno DB2INSTANCE, DB2TX_INSTOWNER, DB2TXINSTOWNERHOMEDIR. Utilice descfgcl -d y descfgsv -d -i txinsnnn para comprobar la configuración del servicio de búsqueda.

RC_SE_IO_PROBLEM 

Explicación: Se ha producido un error cuando el servidor intentaba abrir o leer uno de sus archivos de índice. Esto puede ser debido a una de las siguientes situaciones:

Una acción no intencionada del administrador como, por ejemplo, la supresión de un archivo de índice de DB2 Text Extender

Un valor incorrecto en la configuración del texto.

Lo que se ha de hacer: Termine la aplicación. Compruebe con el administrador que:

RC_SE_LS_FUNCTION_FAILED 

Explicación: Una función que accedía a la base de datos para recuperar documentos de texto para el examen ha fallado. El usuario ya no puede acceder a la base de datos o el usuario no está autorizado para la tabla de texto.

Lo que se ha de hacer: Compruebe que la entrada para la función como, por ejemplo, el ID de usuario es correcta. Compruebe que se puede acceder a la base de datos y que el usuario está autorizado para la tarea.

RC_SE_LS_NOT_EXECUTABLE 

Explicación: Una función que intenta acceder a la base de datos para recuperar documentos de texto para examen no se puede ejecutar.

Lo que se ha de hacer: Compruebe que DB2 Text Extender está instalado correctamente. Si el problema persiste, póngase en contacto con el representante de IBM.

RC_SE_MAX_OUTPUT_SIZE_EXCEEDED 

Explicación: Se ha encontrado un número inusualmente grande de coincidencias. El tamaño de la información de examen ha excedido el máximo que se puede manejar. La petición no puede procesarse.

Lo que se ha de hacer: Especifique más la consulta o asegúrese de que está disponible más memoria del sistema.

RC_SE_MAX_NUMBER_OF_BUSY_INDEXES 

Explicación: El servicio de búsqueda ha impedido la función pedida porque el número máximo de índices está activo actualmente.

Lo que se ha de hacer: Vuelva a emitir la función después de un corto período de tiempo. En general, el problema es sólo temporal.

RC_SE_NO_DATA 

Explicación: No se trata de ningún error. Ningún documento de texto coincide con los criterios de búsqueda. Si pide información de examen, no se devuelve ninguna. No se asigna almacenamiento para la información de examen.

Lo que se ha de hacer: No es necesaria ninguna acción.

RC_SE_NOT_ENOUGH_MEMORY 

Explicación: No hay suficiente espacio de almacenamiento en el sistema cliente o servidor. No puede procesarse la petición actual.

Lo que se ha de hacer: Libere espacio de almacenamiento y finalice la aplicación.

RC_SE_PROCESSING_LIMIT_EXCEEDED 

Explicación: La petición de búsqueda actual ha excedido el tamaño máximo del resultado o el tiempo máximo de proceso especificado para el entorno de cliente/servidor. Se ha cancelado la petición.

Lo que se ha de hacer: Especifique más la petición de búsqueda. Tome en consideración la posibilidad de aumentar el tiempo máximo de proceso.

RC_SE_QUERY_TOO_COMPLEX 

Explicación: La consulta especificada es demasiado compleja.

Lo que se ha de hacer: Adapte la aplicación para evitar el uso excesivo de caracteres de máscara y de sinónimos.

El uso excesivo de símbolos de máscara o el uso excesivo de la opción SYNONYM puede ampliar la consulta a un tamaño que DB2 Text Extender no pueda gestionar.

RC_SE_REQUEST_IN_PROGRESS 

Explicación: Se ha llamado a un servicio API de examen de DB2 Text Extender mientras estaba activada otra petición API de examen para la misma sesión.

Lo que se ha de hacer: Finalice la sesión llamando a DesEndBrowseSession y libere almacenamiento llamando a DesFreeBrowseInfo.

La API de examen de DB2 Text Extender no soporta el acceso simultáneo a la misma sesión de examen.

Todas las aplicaciones que se ejecutan simultáneamente en el mismo proceso deben manejar sus propias sesiones de examen.

RC_SE_SERVER_BUSY 

Explicación: El cliente DB2 Text Extender no puede establecer actualmente una sesión con el servidor DB2 Text Extender pedido o se ha interrumpido el enlace de comunicaciones del servidor DB2 Text Extender y no se puede volver a establecer.

El servidor DB2 Text Extender se ha iniciado correctamente, pero se ha alcanzado el número máximo de procesos paralelos del servidor.

Lo que se ha de hacer: Si no se trata de un problema temporal, cambie la configuración de las comunicaciones en el servidor.

RC_SE_SERVER_CONNECTION_LOST 

Explicación: Se ha interrumpido la comunicación entre el cliente y el servidor y no se puede volver a establecer.

Puede que un administrador haya detenido la tarea del servidor DB2 Text Extender o puede que se haya concluido la estación de trabajo servidor.

Lo que se ha de hacer: Compruebe si se ha producido alguna de estas condiciones y corríjalas.

RC_SE_SERVER_NOT_AVAILABLE 

Explicación: Los servicios API de DB2 Text Extender no han podido establecer una sesión con el servidor DB2 Text Extender pedido.

Puede que no se haya iniciado el servidor DB2 Text Extender.

Lo que se ha de hacer: Compruebe que el servidor DB2 Text Extender se haya iniciado correctamente. Si persiste el error, es que hay un problema de instalación.

RC_SE_STOPWORD_IGNORED 

Explicación: Este código informativo se devuelve cuando la consulta especificada contiene como mínimo un término de búsqueda que sólo consta de palabras de parada. Se ha pasado por alto el término de búsqueda al procesar la consulta.

Lo que se ha de hacer: Puede continuar emitiendo llamadas a API. Evite la utilización de palabras de parada en consultas DB2 Text Extender.

RC_SE_UNEXPECTED_ERROR 

Explicación: Se ha producido un error que podría estar provocado por una instalación incorrecta de DB2 Text Extender.

Lo que se ha de hacer: Finalice la aplicación, guardando la información que pueda ayudar a averiguar la causa del error.

RC_SE_UNKNOWN_INDEX_NAME 

Explicación: El nombre del índice de texto asociado a la columna de texto forma parte del descriptor de contexto.

Lo que se ha de hacer: Asegúrese de que el descriptor de contexto que utiliza como entrada para DesGetBrowseInfo sea correcto.

RC_SE_UNKNOWN_SECTION_NAME 

Explicación: Un nombre de sección especificado no forma parte de ningún modelo especificado en un archivo de modelos de documentos o del modelo por omisión utilizado.

Lo que se ha de hacer: Especifique un nombre de sección que forme parte del modelo especificado o del modelo por omisión.

RC_SE_UNKNOWN_SERVER_NAME 

Explicación: El nombre del servidor DB2 Text Extender forma parte del descriptor de contexto.

Lo que se ha de hacer: Asegúrese de que el descriptor de contexto que utiliza como entrada para DesGetBrowseInfo sea correcto.

RC_SE_WRITE_TO_DISK_ERROR 

Explicación: Se ha producido un error de grabación que podría estar provocado por un disco lleno en la estación de trabajo del servidor DB2 Text Extender o por una instalación incorrecta de DB2 Text Extender.

Lo que se ha de hacer: Finalice la aplicación, guardando la información que pueda ayudar a averiguar la causa del error. Compruebe que haya suficiente espacio de disco disponible en el servidor.

RC_SQL_ERROR_WITH_INFO 

Explicación: Se ha producido un error SQL. Se devuelve un mensaje de error.

Lo que se ha de hacer: Compruebe el mensaje de error devuelto por DB2 Text Extender para obtener más información como, por ejemplo, el mensaje de error SQL, el SQLState y el código de error SQL nativo.

RC_SQL_ERROR_NO_INFO 

Explicación: Se ha producido un error SQL. No se ha devuelto ningún mensaje.

RC_TEXT_COLUMN_NOT_ENABLED 

Explicación: La columna de descriptores de contexto especificada no es una columna de la tabla que ha especificado.

Lo que se ha de hacer: Compruebe si el nombre de la columna de descriptores de contexto que ha especificado es correcto. Asegúrese de que la columna de texto de esa tabla se ha habilitado.


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