Función INDICES

Sintaxis

INDICES (variable.archivo [ ,nombreíndice])

Descripción

Utilice la función INDICES para devolver información sobre los índices de clave secundarios de un archivo.

El valor de variable.archivo especifica un archivo abierto.

El valor de nombreíndice es el nombre de un índice secundario del archivo especificado.

Si solo se especifica variable.archivo, se devuelve una matriz dinámica que contiene los nombres de índice de todos los índices secundarios del archivo. Los nombres de índice están separados por marcas de campo. Si variable.archivo no tiene índices, se devuelve una serie vacía.

Si se especifica nombreíndice, se devuelve información en una matriz dinámica para nombreíndice. El campo 1 de la matriz dinámica contiene la información siguiente:

Tabla 1. Campo 1 de matrices dinámicas
Valor El valor puede ser... Descripción
Valor 1 D

I

A

S

C

SQL

Índice de descriptor de datos.

Índice de descriptor de tipo I.

Índice de descriptor de tipo A.

Índice de descriptor de tipo S.

Índice de descriptor de tipo A o S con correlativo en campo 8. Índice de SQL.

Valor 2 1

vacío

El índice debe volver a crearse.

No es necesario volver a crear el índice.

Valor 3 1

vacío

Las series vacías no están indexadas.

Las series vacías están indexadas.

Valor 4 1

vacío

La actualización automática está habilitada.

La actualización automática está inhabilitada.

Valor 5 Nombre de vía de acceso

vacía

Nombre de vía de acceso completo del archivo de índice.

El archivo es un archivo distribuido.

Valor 6 1

vacío

Hay actualizaciones pendientes.

No hay actualizaciones pendientes.

Valor 7 L

R

Justificación a la izquierda.

Justificación a la derecha.

Valor 8 N

U

No exclusivo.

Exclusivo.

Valor 9 Números de componente Lista con subvalores de números de componente de archivos distribuidos.
Valor 10 1 Necesita crearse índice

Vacío No necesita crearse

Lista con subvalores correspondientes con los subvalores del valor 9.
Valor 11 1 Series vacías no indexadas

Vacío Series vacías indexadas

Lista con subvalores correspondientes con los subvalores del valor 9.
Valor 12 1 Actualización habilitada

Vacío Actualización inhabilitada

Lista con subvalores correspondientes con los subvalores del valor 9.
Valor 13 Nombres de vía de acceso de índice Lista con subvalores de nombres de vía de acceso de índices de archivos componentes de archivos distribuidos, correspondientes con los subvalores del valor 9.
Valor 14 1 Actualizaciones pendientes

Vacío Sin actualizaciones pendientes

Lista con subvalores correspondientes con los subvalores del valor 9.
Valor 15 L Justificación a la izquierda

R Justificación a la derecha

Lista con subvalores correspondientes con los subvalores del valor 9.
Valor 16 N No exclusivo

U exclusivo

Lista con subvalores correspondientes con los subvalores del valor 9.
Valor 17 Nombre de clasificación Nombre del convenio de clasificación del índice.

Si el valor 1 del campo 1 es D, A o S, el campo 2 contiene la ubicación del campo (es decir, el número de campo) y el campo 6 contiene S (campo de un solo valor) o M (campo de varios valores).

Si el valor 1 del campo 1 es I o SQL, los demás campos de la matriz dinámica contienen la información siguiente, obtenida del descriptor de tipo I del diccionario de archivo:

Campo
El valor puede ser...
Campo 2
Expresión de tipo I
Campo 3
Código de conversión de salida
Campo 4
Cabecera de columna
Campo 5
Ancho, justificación
Campo 6
S - Campo de un solo valor

M - Campo de varios valores

Campo 7
Nombre de asociación
Campos 8-15
Vacío
Campos 16-19
Datos del descriptor de tipo I compilados
Campo 20
Código del descriptor de tipo I compilado

Si el valor 1 del campo 1 es C, los demás campos de la matriz dinámica contienen la información siguiente, obtenida del descriptor de tipo A o S del diccionario de archivo:

Campo
El valor puede ser...
Campo 2
Número de campo (ubicación del campo)
Campo 3
Cabecera de columna
Campo 4
Código de asociación
Campos 5-6
Vacío
Campo 7
Código de conversión de salida
Campo 8
Código correlativo
Campo 9
L o R (justificación)
Campo 10
Ancho de la columna de visualización

Si variable.archivo o nombreíndice es el valor nulo, la función INDICES falla y el programa termina con un mensaje de error de tiempo de ejecución.

Las actualizaciones de archivo ejecutadas en una transacción (es decir, entre una sentencia BEGIN TRANSACTION y una sentencia COMMIT) no son accesibles para la función INDICES hasta después de ejecutarse la sentencia COMMIT.

Si el soporte multilingüístico está habilitado, la función INDICES reporta el nombre del convenio de clasificación actual (como se especifica en el archivo NLS.LC.COLLATE) en vigor al crearse el índice. Consulte el valor 17 del campo 1 para ver el nombre del convenio de clasificación del índice.