Sintaxis y opciones de la sentencia de control LISTDEF

La sentencia de control de utilidad LISTDEF, con sus múltiples opciones, define una lista de espacios de tabla, espacios de índice o ambos en la que pueden operar otros programas de utilidad.

Puede crear una declaración de control con la función de edición de PDF ( ISPF ). Después de crearlo, guárdelo en un conjunto de datos secuencial o particionado. Cuando cree el JCL para ejecutar el trabajo, utilice la instrucción SYSIN DD para especificar el nombre del conjunto de datos que contiene la instrucción de control de utilidad.

Diagrama de sintaxis

Leer diagrama de sintaxisOmitir el diagrama de sintaxis visual LISTDEF nombre-lista Opciones de lista
Opciones de lista
Leer diagrama de sintaxisOmitir el diagrama de sintaxis visualINCLUDEEXCLUDETABLESPACES1INDEXSPACES1COPYNOYESLISTlista-de-referenciasespecificación-objeto-inicialCLONEDYESNODEFINEDYESDEFINEDNOALLRIBASELOBXMLALLHISTORY2ARCHIVE2BASICNOYESEXTENDEDNOYES
especificación-objeto-inicial
Leer diagrama de sintaxisOmitir el diagrama de sintaxis visualDATABASEnombre-base-datosTABLESPACEnombre-base-datos.nombre-del-espacio-de-la-tablaINDEXSPACEnombre-base-datos.nombre del espacio-índiceTABLEcreador-id.nombre-tablaINDEXcreador-id.nombre-índicePARTLEVEL(,enterointeger1: integer2)
Notas:
  • 1 Debe especificar TABLESPACES o INDEXESPACES si especifica DATABASE.
  • 2 HISTORY o ARCHIVE pueden especificarse antes o después de las palabras clave BASE, LOB, XML y ALL. Sin embargo, HISTORY y ARCHIVE siempre se procesan al final, después de que se hayan manejado todas las demás palabras clave.

Descripciones de opciones

LISTDEF nombre-lista
Define una lista de Db2 objetos y asigna un nombre a la lista. El nombre de la lista hace que la lista esté disponible para su posterior ejecución como objeto de una instrucción de control de utilidad o como elemento de otra instrucción LISTDEF.

list-name es el nombre (de hasta 18 caracteres alfanuméricos de longitud) de la lista definida.

Inicio del cambiolist-name no puede ser un nombre de palabra clave de utilidad.fin del cambio

Puede poner instrucciones LISTDEF en un conjunto de datos de biblioteca LISTDEF independiente o antes de una Db2 sentencia de control de utilidad que haga referencia al nombre de la lista.

INCLUDE
Especifica que la lista de objetos que resulta de la expresión que sigue debe añadirse a la lista. Primero debe especificar una cláusula INCLUDE. A continuación, puede especificar cláusulas INCLUDE o EXCLUDE posteriores en cualquier orden para añadir o eliminar cláusulas de la lista existente.

Referenciar un gran número de bases de datos en una sola lista LISTDEF podría llenar el pool EDM DBD y dar lugar a un error de tipo abend 04E con el código de razón 00C90089. Si se da esta situación, disminuya el número de bases de datos a las que se hace referencia en la instrucción LISTDEF. Si esta condición se produce con frecuencia, aumente el tamaño de su grupo de DBD de EDM.

EXCLUDE
Especifica, después de la cláusula INCLUDE inicial, una lista de objetos a excluir. La expresión que sigue a la palabra clave EXCLUDE determina esta lista de objetos a excluir. Estos objetos se excluyen de la lista LISTDEF existente si los objetos ya están en la lista. Si los objetos no están en la lista existente, se ignoran y Db2 se procede a la siguiente cláusula INCLUDE o EXCLUDE.
TABLESPACES
Especifica que la expresión de objeto INCLUDE o EXCLUDE es para crear una lista de espacios de tabla relacionados.

TABLESPACES es el tipo predeterminado para las listas que utilizan un espacio de tabla o una tabla para la búsqueda inicial. Para obtener más información sobre la especificación de estos objetos, consulte las descripciones de las opciones TABLESPACE y TABLE.

No existe ningún valor de tipo predeterminado para las listas que utilizan otras listas para la búsqueda inicial. Se utiliza la lista a la que se hace referencia en la opción LIST, a menos que especifique TABLESPACES o INDEXSPACES. Del mismo modo, no existe ningún valor predeterminado de tipo para las listas que utilizan bases de datos para la búsqueda inicial. Si especifica la opción DATABASE, debe especificar INDEXSPACES o TABLESPACES. Para obtener más información sobre la especificación de listas y bases de datos, consulte las descripciones de las opciones LISTA y BASE DE DATOS.

El resultado de la palabra clave TABLESPACES varía en función del tipo de objeto que especifique en la cláusula INCLUDE o EXCLUDE. Estos resultados se muestran en la siguiente tabla.

Tabla 1. Resultado de la palabra clave TABLESPACES basada en el tipo de objeto que se especifica en la cláusula INCLUDE o EXCLUDE.
Tipo de objeto que se especifica en la cláusula INCLUDE o EXCLUDE Resultado de la palabra clave TABLESPACES
BASE DE DATOS Devuelve todos los espacios de tabla que están contenidos en la base de datos
TABLESPACE Devuelve el espacio de tabla especificado
TABLA Devuelve el espacio de la tabla que contiene la tabla
INDEXSPACE Devuelve el espacio de la tabla que contiene la tabla relacionada
ÍNDICE Devuelve el espacio de la tabla que contiene la tabla relacionada
Lista de espacios de tabla Devuelve los espacios de la tabla de la lista ampliada a la que se hace referencia
LISTA de espacios de índice Devuelve los espacios de tabla relacionados para los espacios de índice en la lista referenciada expandida
LISTA de espacios de tabla y espacios de índice Devuelve los espacios de tabla de la lista referenciada expandida y los espacios de tabla relacionados para los espacios de índice en la misma lista
INDEXSPACES
Especifica que la expresión de objeto INCLUDE o EXCLUDE es para crear una lista de espacios de índice relacionados.

INDEXSPACES es el tipo predeterminado para las listas que utilizan un espacio de índice o un índice para la búsqueda inicial. Para obtener más información sobre cómo especificar estos objetos, consulte las descripciones de las opciones INDEXSPACE e INDEX.

No existe ningún valor de tipo predeterminado para las listas que utilizan otras listas para la búsqueda inicial. Se utiliza la lista a la que se hace referencia en la opción LIST, a menos que especifique TABLESPACES o INDEXSPACES. Del mismo modo, no existe ningún valor predeterminado de tipo para las listas que utilizan bases de datos para la búsqueda inicial. Si especifica la opción DATABASE, debe especificar INDEXSPACES o TABLESPACES. Para obtener más información sobre la especificación de listas y bases de datos, consulte las descripciones de las opciones LISTA y BASE DE DATOS.

El resultado de la palabra clave INDEXSPACES varía en función del tipo de objeto que especifique en la cláusula INCLUDE o EXCLUDE. Estos resultados se muestran en la siguiente tabla.

Tabla 2. Resultado de la palabra clave INDEXSPACES basada en el tipo de objeto que se especifica en la cláusula INCLUDE o EXCLUDE.
Tipo de objeto que se especifica en la cláusula INCLUDE o EXCLUDE Resultado de la palabra clave INDEXSPACES
BASE DE DATOS Devuelve todos los espacios de índice que están contenidos dentro de la base de datos
TABLESPACE Devuelve todos los espacios de índice para índices en todas las tablas del espacio de tablas
TABLA Devuelve todos los espacios de índice para índices sobre la tabla
INDEXSPACE Devuelve el espacio de índice especificado.
ÍNDICE Devuelve el espacio de índice que contiene el índice
Lista de espacios de tabla Devuelve los espacios de índice relacionados para los espacios de tabla en la lista referenciada expandida
LISTA de espacios de índice Devuelve los espacios de índice de la lista referenciada expandida
LISTA de espacios de tabla y espacios de índice Devuelve los espacios de índice de la lista referenciada expandida y los espacios de índice relacionados para los espacios de tabla en la misma lista
COPY
Especifica si los índices con atributos COPY YES o COPY NO deben incluirse o excluirse en esta parte de la lista. Si omite COPY, todos los espacios de índice que satisfagan la expresión INCLUDE o EXCLUDE, independientemente de su atributo COPY, se incluyen o excluyen en esta parte de la lista. Si se especifica, esta palabra clave debe seguir inmediatamente a la palabra clave INDEXSPACES. Si especifica esta palabra clave en otro lugar, se interpreta como el inicio de la instrucción de control de la utilidad COPY.
YES
Especifica que solo los espacios de índice que se definieron con COPY YES o se modificaron a COPY YES se incluirán en esta parte de la lista. Utilice INCLUDE con COPY YES para desarrollar una lista de espacios de índice que la utilidad COPY puede procesar.
NO
Especifica que solo los espacios de índice que se definieron con COPY NO o se modificaron a COPY NO se incluirán en esta parte de la lista. Utilice EXCLUDE con COPY NO para eliminar de una lista más grande los índices que la utilidad COPY no puede procesar.
LIST lista-de-referencias
Especifica el nombre de una lista de objetos previamente definida que se va a expandir y utilizar para la búsqueda inicial del objeto.

referenced-list es el nombre de la lista. Debe especificar explícitamente este nombre. No puede especificar caracteres de coincidencia de patrones (%, *,? y _) para las listas.

No existe ningún valor de tipo predeterminado para las listas que se desarrollan a partir de la opción LISTA. La lista se amplía según se define y, a continuación, se modifica mediante palabras clave posteriores, si las hay.

Puede especificar un tipo de TABLESPACES para crear una lista de solo espacios de tabla. Si la lista que se va a procesar contiene espacios de índice, la palabra clave TABLESPACES crea una lista que incluye espacios de tabla relacionados.

Puede especificar un tipo-spec de INDEXSPACES para crear una lista de espacios de índice solamente. Si la lista que se va a procesar contiene espacios de tabla, la palabra clave INDEXSPACES crea una lista que incluye espacios de índice relacionados.

Puede utilizar la palabra clave LIST para realizar cualquiera de las siguientes acciones:
  • Hacer listas agregadas de listas
  • Excluir listas enteras de otras listas
  • Desarrollar listas de objetos que están relacionados con otras listas

Las particiones o rangos de particiones se pueden especificar en una lista.

DATABASE nombre-base-datos
Especifica la base de datos que se va a utilizar para la búsqueda inicial del objeto.

Puede especificar el nombre de la base de datos explícitamente o como un nombre que coincida con un patrón. DATABASE * y DATABASE % no son compatibles.

Si especifica DATABASE, también debe especificar TABLESPACES o INDEXSPACES como tipo de lista. Dependiendo del tipo de lista que especifique, Db2 incluye todos los espacios de tabla o espacios de índice en nombre-base-de-datos que satisfacen la expresión de coincidencia de patrón en la lista.

No puede especificar DSNDB01, DSNDB06, DSNDB07 o bases de datos de archivos de trabajo definidos por el usuario en un LISTDEF.

Tenga cuidado cuando especifique un nombre de BASE DE DATOS implícito. La autorización para acceder a objetos que se encuentran dentro de una base de datos implícita no es uniforme. Utilice la instrucción de control OPTIONS EVENT (ITEMERROR, SKIP) para continuar el procesamiento cuando se produzcan errores de autorización.

TABLESPACE database-name.table-space-name
Especifica el espacio de la tabla que se va a utilizar para la búsqueda inicial del objeto.

Si especifica TABLESPACE, el tipo de lista predeterminado es TABLESPACES. Todos los espacios de tabla que satisfacen la expresión de coincidencia de patrones se incluyen en la lista, a menos que la lista se modifique con otras palabras clave. TABLESPACE *.* y TABLESPACE %.% no son compatibles.

database-name especifica el nombre de la base de datos a la que pertenece el espacio de tabla. El valor predeterminado es DSNDB04.

table-space-name especifica el nombre del espacio de tabla.

Puede especificar explícitamente o utilizar caracteres de coincidencia de patrones para especificar el nombre de la base de datos, el nombre del espacio de la tabla o ambos. La búsqueda de patrones no es compatible con los objetos DSNDB01 y DSNDB06.

En una lista LISTDEF no se puede incluir ningún objeto en DSNDB07 ni ninguna base de datos de archivos de trabajo definida por el usuario.

INDEXSPACE database-name.index-space-name
Especifica el espacio de índice que se va a utilizar para la búsqueda inicial del objeto.

Si especifica INDEXSPACE, el tipo de lista predeterminado es INDEXSPACES. Todos los espacios de índice que satisfacen la expresión de coincidencia de patrones se incluyen en la lista, a menos que los espacios de índice estén excluidos por otras opciones LISTDEF. INDEXSPACE *.* y INDEXSPACE %.% no son compatibles.

database-name especifica el nombre de la base de datos a la que pertenece el espacio de índice. El valor predeterminado es DSNDB04.

index-space-name especifica el nombre del espacio de índice.

Puede especificar explícitamente o utilizar caracteres de coincidencia de patrones para especificar el nombre de la base de datos, el nombre del espacio de índice o ambos. La búsqueda de patrones no es compatible con los objetos DSNDB01 y DSNDB06.

No puede incluir ningún objeto en un DSNDB07, ni en ninguna base de datos de archivos de trabajo definida por el usuario en un LISTDEF.

TABLE creator-id.table-name
Especifica la tabla que se va a utilizar para la búsqueda inicial del objeto.

Si especifica TABLE, el tipo de lista predeterminado es TABLESPACES. Todos los espacios de tabla que contienen tablas que satisfacen la expresión de coincidencia de patrones se incluyen en la lista, a menos que la lista se modifique con otras palabras clave. TABLE *.* y TABLE %.% no son compatibles.

creator-id especifica el identificador de creador calificador para la tabla. El valor predeterminado es el identificador de usuario de la utilidad. table-name especifica el nombre de la tabla. Si especifica un nombre de tabla con CLONED, la palabra clave CLONED se ignora.

Puede especificar explícitamente o utilizar caracteres de coincidencia de patrones para especificar el identificador del creador, el nombre de la tabla o ambos. Sin embargo, el carácter de coincidencia de patrones de subrayado se ignora en un nombre de tabla.

Encierre el nombre de tabla entre comillas si la tabla contiene un espacio en blanco.

No se pueden especificar tablas de catálogos y directorios.

INDEX creator-id.index-name
Especifica el índice que se va a utilizar para la búsqueda inicial del objeto.

Si especifica INDEX, el tipo de lista predeterminado es INDEXSPACES. Todos los espacios de índice que contienen índices que satisfacen la expresión de coincidencia de patrones se incluyen en la lista, a menos que la lista sea modificada por otras palabras clave. INDEX *.* y INDEX %.% no son compatibles.

creator-id especifica el identificador de creador calificador para el índice. El valor predeterminado es el identificador de usuario de la utilidad.

index-name especifica el nombre del índice.

Encierre el nombre de índice entre comillas si el nombre contiene un espacio en blanco.

Puede especificar explícitamente o utilizar caracteres de coincidencia de patrones para especificar el identificador de creador, el nombre de índice o ambos. Sin embargo, el carácter de coincidencia de patrones guión bajo se ignora en un nombre de índice.

PARTLEVEL
Especifica la granularidad de partición para espacios de tabla particionados, índices de partición e índices secundarios de datos particionados que deben estar contenidos en la lista. No se puede especificar la palabra clave PARTLEVEL con la palabra clave RI.
(entero)
entero es el número de partición física donde entero >= 0.

Si especifica PARTLEVEL 0, la lista resultante contiene una entrada para cada objeto no particionado.

Si especifica PARTLEVEL con un operando distinto de cero, la lista resultante contiene una entrada para la partición especificada para los objetos particionados y una entrada para cada objeto no particionado.

Si especifica PARTLEVEL sin (entero ), la lista resultante contiene una entrada para cada partición en el objeto particionado y una entrada para cada objeto no particionado.

(integer1:integer2)
Inicio del cambioDesigna un rango de particiones a especificar en la lista. integer1 y integer2 son números de partición física y deben ser mayores que 1. Puede especificar el rango en cualquier orden. Por ejemplo, puede especificar (100:199) o (199:100). En cualquier caso, las particiones 100 a 199 se especifican en la lista. Si integer1 es igual a integer2, solo se especifica esa partición. Por ejemplo, si especifica (5:5), sólo se especifica la partición 5.fin del cambio

Un INCLUDE con la palabra clave PARTLEVEL solo puede eliminarse de la lista mediante un EXCLUDE con PARTLEVEL.

Para los objetos de partición por crecimiento, la palabra clave PARTLEVEL da como resultado una entrada para cada partición que existe cuando se evalúa la lista LISTDEF. Las particiones que se añaden después de evaluar la lista no se incluyen en ella. Si se añade una partición durante los pasos de un trabajo de larga duración en el que se reutiliza la lista, las particiones que se añadieron no se incluyen en la lista y no se procesan. Si se reinicia un trabajo de utilidad que utiliza una lista PARTLEVEL, la lista original se guarda durante la ejecución original para un reinicio posterior. La lista no incluye ninguna partición añadida.

CLONED
Utilice la palabra clave CLONED para que LISTDEF realice un filtrado final de los contenidos de la cláusula INCLUDE o EXCLUDE en función de la existencia o ausencia de datos clonados. Esta operación se realiza en último lugar, después de que LISTDEF procese todas las demás palabras clave de la cláusula INCLUDE o EXCLUDE.

CLONED YES especifica que solo los espacios de tabla y los espacios de índice que contienen objetos clonados deben devolverse en la cláusula INCLUDE o EXCLUDE. CLONED NO especifica que solo los espacios de tabla y los espacios de índice que no contengan objetos clonados deben devolverse en la cláusula INCLUDE o EXCLUDE. Omita la palabra clave CLONED si la existencia de datos clonados no es un factor.

El uso de SÍ CLONADO o NO CLONADO afecta solo al contenido de la lista. No determina si los datos clonados o de base son procesados posteriormente por la utilidad que utiliza la lista. Solo la presencia o ausencia de la palabra clave CLONE en las sentencias de control de utilidad individuales determina si se procesan datos clonados o de base.

DEFINED
Especifica si se deben devolver espacios de tabla o espacios de índice con conjuntos de datos definidos o no definidos en la cláusula INCLUDED o EXCLUDE. Si omite la palabra clave DEFINED, DEFINED YES es el valor predeterminado.
YES
Especifica que solo los espacios de tabla o los espacios de índice que están definidos actualmente deben incluirse en la cláusula INCLUDED o EXCLUDED.

SÍ es el valor predeterminado si no se especifica DEFINIDO. Por defecto, solo se incluyen en la lista los objetos definidos. Antes de DB2® 10, la palabra clave DEFINED no existía y todos los objetos, tanto definidos como no definidos, se incluían en la lista. Especifique DEFINED ALL para obtener el comportamiento de DB2 9 y anteriores.

NO
Especifica que solo los espacios de tabla o los espacios de índice que no están definidos actualmente se incluyen en la cláusula INCLUDED o EXCLUDED. Utilice EXCLUDE con DEFINED NO para eliminar espacios de tabla y espacios de índice que actualmente no están definidos y que normalmente no serían procesados por la utilidad. Si especifica NO DEFINIDO, no puede especificar SÍ CLONADO.
ALL
Especifica que los espacios de tabla o los espacios de índice que están tanto indefinidos como definidos deben incluirse en la cláusula INCLUDED o EXCLUDED.

Antes de DB2 10, la palabra clave DEFINED no existía y todos los objetos, tanto definidos como no definidos, se incluían en la lista. Especifique DEFINED ALL para obtener el comportamiento de DB2 9 y anteriores.

RI
Especifica que todos los objetos que están relacionados referencialmente con la expresión de objeto (PRIMARY KEY <--> FOREIGN KEY) deben incluirse en la lista. Db2 procesa todas las relaciones referenciales repetidamente hasta que se desarrolla todo el conjunto referencial. No se puede especificar RI con PARTLEVEL(n ).

Palabras clave de indicador auxiliar : Utilice una de las cuatro palabras clave de indicador auxiliar para dirigir el procesamiento LISTDEF a seguir relaciones auxiliares para incluir objetos LOB o XML relacionados en la lista. La relación auxiliar puede seguirse en cualquier dirección. Los objetos auxiliares incluyen los espacios de tabla auxiliares, las tablas auxiliares, los índices de las tablas auxiliares y los espacios de índice que los contienen.

Las definiciones LOB o XML incompletas hacen que no se encuentren objetos aparentemente relacionados. La relación auxiliar no existe hasta que se crea la TABLA AUX con la palabra clave STORES.

No existe ninguna palabra clave de indicador auxiliar predeterminado. Si no especifica BASE, LOB, XML o ALL, Db2 no sigue las relaciones auxiliares.

ALL
Especifica que los objetos BASE, LOB y XML deben incluirse en la lista. Las relaciones auxiliares se siguen de todos los objetos que resultan de la búsqueda de objetos inicial. Los objetos BASE, LOB y XML permanecen en la lista final enumerada.

Inicio del cambioLos índices auxiliares LOB creados implícitamente no se incluyen en (ni se excluyen de) la lista cuando la cláusula INCLUDE (o EXCLUDE) especifica un nombre de tabla base que tiene una columna LOB y la opción ALL. Estos índices implícitos son creados por Db2 cuando no se crea explícitamente un índice para una columna LOB. Se crean con un Db2 -nombre de tabla generado que es diferente del nombre de la tabla base. Por lo tanto, cuando su sentencia LISTDEF solicita una lista de índices (con la opción INDEXSPACES) y la cláusula INCLUDE (o EXCLUDE) especifica un nombre de tabla base que tiene una columna LOB y la opción ALL, y no existe ningún otro índice para ninguna columna en el nombre de tabla base, la lista no incluirá (o excluirá) el espacio de índice auxiliar LOB, porque el nombre de tabla auxiliar difiere.fin del cambio

El comportamiento de la palabra clave ALL se ve alterado por la presencia o ausencia de las palabras clave HISTORY o ARCHIVE. Cuando se especifica ALL con HISTORY, la cláusula de lista resultante contiene todos los objetos de historial relacionados. Cuando se especifica ALL con ARCHIVE, la cláusula de lista resultante contiene todos los objetos de archivo relacionados (espacios de tablas y espacios de índices que contienen tablas de archivo y sus índices relacionados). Cuando se especifica ALL sin HISTORY o ARCHIVE, la cláusula de lista resultante contiene todos los objetos relacionados que no son objetos de historial o de archivo.

BASE
Especifica que solo se deben incluir en este elemento de la lista los espacios de tabla base (no LOB, no XML) y los espacios de índice. Si el resultado de la búsqueda inicial del objeto es un objeto base, no se siguen las relaciones auxiliares. Si el resultado de la búsqueda inicial del objeto es un objeto LOB o XML, la relación auxiliar se aplica al espacio de la tabla base o al espacio del índice. Solo aquellos objetos base pasan a formar parte de la lista resultante.

El comportamiento de la palabra clave BASE se ve alterado por la presencia o ausencia de las palabras clave HISTORY o ARCHIVE. Cuando BASE se especifica con HISTORY, la cláusula de lista resultante contiene solo objetos de historial base. Cuando BASE se especifica con ARCHIVE, la cláusula de lista resultante contiene solo objetos de archivo base (espacios de tablas base y espacios de índice que contienen tablas de archivo y sus índices relacionados). Cuando se especifica BASE sin HISTORY o ARCHIVE, la cláusula de lista resultante contiene solo objetos base que no son objetos de historial o de archivo.

LOB
Especifica que solo los espacios de tabla LOB y los espacios de índice relacionados que contienen índices en tablas auxiliares deben incluirse en este elemento de la lista. Si el resultado de la búsqueda inicial del objeto es un objeto LOB, no se siguen las relaciones auxiliares. Si el resultado de la búsqueda inicial del objeto es un objeto base, la relación auxiliar se aplica al espacio de tabla LOB o al espacio de índice. Solo aquellos objetos LOB pasan a formar parte de la lista resultante.

El comportamiento de la palabra clave LOB se ve alterado por la presencia o ausencia de las palabras clave HISTORY o ARCHIVE. Cuando se especifica LOB con HISTORY, la cláusula de lista resultante contiene solo objetos de historial LOB (espacios de tabla LOB y espacios de índice para tablas de historial). Cuando se especifica LOB con ARCHIVE, la cláusula de lista resultante contiene solo objetos de archivo LOB (espacios de tabla LOB y espacios de índice para tablas de archivo). Cuando se especifica LOB sin HISTORY o ARCHIVE, la cláusula de lista resultante contiene solo objetos LOB que no son objetos de historial o archivo.

XML
Especifica que solo los espacios de tablas XML y los espacios de índices relacionados que contienen índices en tablas auxiliares deben incluirse en este elemento de la lista. Si el resultado de la búsqueda inicial del objeto es un objeto XML, no se siguen las relaciones auxiliares. Si el resultado de la búsqueda inicial del objeto es un objeto base, la relación auxiliar se aplica al espacio de tabla XML o al espacio de índice. Solo aquellos objetos XML pasan a formar parte de la lista resultante.

El comportamiento de la palabra clave XML se ve alterado por la presencia o ausencia de las palabras clave HISTORY o ARCHIVE. Cuando se especifica XML con HISTORY, la cláusula de lista resultante contiene solo objetos de historial XML (espacios de tabla XML y espacios de índice para tablas de historial). Cuando se especifica XML con ARCHIVE, la cláusula de lista resultante contiene solo objetos de archivo XML (espacios de tabla XML y espacios de índice para tablas de archivo). Cuando se especifica XML sin HISTORY o ARCHIVE, la cláusula de lista resultante contiene solo objetos XML que no son objetos de historial o archivo.

HISTORY
Especifica que solo los objetos de historial (control de versiones) deben incluirse en la cláusula de lista resultante.

HISTORY es una palabra clave de filtrado que opera contra el contenido de la cláusula de lista después de que se aplican otras palabras clave. Utilice las palabras clave BASE, LOB, XML o ALL con o sin la palabra clave HISTORY para hacer referencia a objetos relacionados. El orden en que se especifican estas palabras clave no tiene importancia. Se requieren dos cláusulas INCLUDE o EXCLUDE si se requieren tanto objetos históricos como no históricos.

ARCHIVE
Especifica que solo los objetos de archivo deben incluirse en la cláusula de lista resultante.

ARCHIVE es una palabra clave de filtrado que opera contra el contenido de la cláusula de lista después de que se aplican otras palabras clave. Utilice las palabras clave BASE, LOB, XML o ALL con o sin la palabra clave ARCHIVE para hacer referencia a objetos relacionados. El orden en que se especifican estas palabras clave no tiene importancia. Se requieren dos cláusulas INCLUDE o EXCLUDE si se requieren objetos de archivo y no de archivo.

ARCHIVE no se puede especificar con las palabras clave HISTORY o CLONED YES

BASIC
Especifica que LISTDEF debe realizar un filtrado final de los contenidos de la cláusula INCLUDE o EXCLUDE basándose en el formato básico con valores RBA o LRSN de 6 bytes. Esta operación se realiza en último lugar, después de que LISTDEF procese todas las demás palabras clave de la cláusula INCLUDE o EXCLUDE.
YES
Especifica que solo los espacios de tabla y los espacios de índice que están en formato básico con valores RBA o LRSN de 6 bytes deben devolverse en la cláusula INCLUDE o EXCLUDE. Esta opción es la misma que la de EXTENDED NO.
NO
Especifica que solo los espacios de tabla y los espacios de índice que no estén en formato básico con formato de valores RBA o LRSN de 6 bytes deben devolverse en la cláusula INCLUDE o EXCLUDE. Esta opción es la misma que SÍ EXTENDIDO.
La palabra clave BASIC no tiene un valor predeterminado. Si el formato RBA o LRSN no es un factor, omita las palabras clave BASIC y EXTENDED.

Si la cláusula también incluye la palabra clave PARTLEVEL con un operando distinto de cero o sin operando, el filtrado se realiza en función del formato RBA o LRSN de la partición. Si los objetos particionados tienen particiones en diferentes formatos, PARTLEVEL debe especificar un operando distinto de cero o ningún operando para utilizar BASIC o EXTENDED.

EXTENDED
Especifica que LISTDEF debe realizar un filtrado final de los contenidos de la cláusula INCLUDE o EXCLUDE basándose en el formato extendido con valores RBA o LRSN de 10 bytes. Esta operación se realiza en último lugar, después de que LISTDEF procese todas las demás palabras clave de la cláusula INCLUDE o EXCLUDE.
YES
Especifica que solo los espacios de tabla y los espacios de índice que están en formato extendido con valores RBA o LRSN de 10 bytes deben devolverse en la cláusula INCLUDE o EXCLUDE. Esta opción es la misma que la de N.º BÁSICO.
NO
Especifica que solo los espacios de tabla y los espacios de índice que no están en formato extendido con formato de valores RBA o LRSN de 10 bytes deben devolverse en la cláusula INCLUDE o EXCLUDE. Esta opción es la misma que SÍ BÁSICO.
La palabra clave EXTENDED no tiene un valor predeterminado. Si el formato RBA o LRSN no es un factor, omita las palabras clave BASIC y EXTENDED.

Si la cláusula también incluye la palabra clave PARTLEVEL con un operando distinto de cero o sin operando, el filtrado se realiza en función del formato RBA o LRSN de la partición. Si los objetos particionados tienen particiones en diferentes formatos, PARTLEVEL debe especificar un operando distinto de cero o ningún operando para utilizar BASIC o EXTENDED.