Sintaxis y opciones de la sentencia de control REORG TABLESPACE

Descripciones de opciones

TABLESPACE database-name.table-space-name

Especifica el espacio de la tabla (y, opcionalmente, la base de datos a la que pertenece) que se va a reorganizar.

Si reorganiza un espacio de tabla, sus índices también se reorganizan.

nombre-base-datos

Es el nombre de la base de datos a la que pertenece el espacio de tabla. El nombre no puede ser DSNDB07.

El valor predeterminado es DSNDB04.

nombre-del-espacio-de-la-tabla

Es el nombre del espacio de la tabla que se va a reorganizar. El nombre no puede ser SYSUTILX si el nombre de la base de datos especificada es DSNDB01.

LIST listdef-name

Especifica el nombre de una lista LISTDEF definida previamente. La utilidad permite una palabra clave LIST para cada instrucción de control de REORG TABLESPACE. La lista debe contener solo espacios de tabla.

No especifique FROM TABLE, STATISTICS TABLE nombre-tabla o STATISTICS INDEX nombre-índice con REORG TABLESPACE LIST. Si desea recopilar estadísticas en línea para una lista de espacios de tabla, especifique TABLA DE ESTADÍSTICAS (TODAS). Si desea recopilar estadísticas en línea para una lista de índices, especifique ÍNDICE DE ESTADÍSTICAS (TODOS). No especifique PART con LIST.

REORG TABLESPACE se invoca una vez por cada elemento de la lista. Esta utilidad solo procesará datos de clonación si se especifica la palabra clave CLONE. El uso de YES CLONADO en la instrucción LISTDEF no es suficiente.

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

LISTPARTS norte

Especifica el número máximo de particiones de datos que se reorganizarán en un solo REORG en un LISTDEF que contiene elementos de lista PARTLEVEL.

n

Especifica un número entero que representa el número máximo de particiones de datos que se pueden reorganizar a la vez. El valor válido es mayor que 0.

Si no se especifica LISTPARTS, el valor por defecto viene determinado por el valor del parámetro del subsistema REORG_LIST_PROCESSING. Si REORG_LIST_PROCESSING se establece en SERIAL, se utiliza LISTPARTS 1. Si REORG_LIST_PROCESSING se establece en PARALLEL, todas las particiones especificadas se reorganizan en una única operación REORG.

PARALLEL(número de subtareas )

Especifica el número máximo de subtareas que se deben iniciar en paralelo para reorganizar un espacio de tabla. Si se omite la palabra clave PARALLEL, el número máximo de subtareas está limitado por el número de particiones que se están descargando o el número de índices que se están construyendo.

El valor de num-subtasks debe ser un número entero entre 0 y 32767, ambos inclusive. Si el valor especificado para num-subtasks es mayor que 32767, la instrucción REORG TABLESPACE falla. Si se especifica 0 o ningún valor para num-subtasks, la utilidad REORG TABLESPACE utiliza el número óptimo de subtareas paralelas. Si el valor especificado para num-subtareas es mayor que el número óptimo calculado, la utilidad REORG TABLESPACE limita el número de subtareas paralelas al número óptimo con las restricciones aplicadas.

El número especificado de subtareas para PARALLEL siempre anula la especificación del parámetro del subsistema PARAMDEG_UTIL, por lo que PARALLEL puede ser menor o mayor que el valor de PARAMDEG_UTIL.

REORG TABLESPACE utiliza algoritmos sofisticados para asignar subtareas para descargar particiones, recargar particiones, crear índices, aplicar cambios de registro y recopilar estadísticas. Como resultado, el número de subtareas que se inician podría ser inferior al número especificado en PARALELO.

INITCDDS

Especifica si REORG TABLESPACE realiza un procesamiento REORG normal o copia diccionarios de expansión para un espacio de tablas que contiene tablas definidas con el atributo DATA CAPTURE CHANGES en el conjunto de datos de diccionario de compresión (CDDS).

Esta opción sólo se aplica a un grupo de compartición de datos en un entorno de GDPS® Disponibilidad continua con pérdida de datos cero.

NO

Especifica que REORG TABLESPACE realiza el procesamiento normal de REORG.

YES

Especifica que REORG TABLESPACE rellena el CDDS y no reorganiza el espacio de la tabla. Especifique SÍ sólo cuando las tablas del espacio de tablas estén definidas con CAMBIOS DE CAPTURA DE DATOS, el espacio de tablas esté en un grupo de compartición de datos y el grupo de compartición de datos forme parte de un entorno de GDPS Disponibilidad continua con pérdida de datos cero.

SEARCHTIME

Especifica la marca de tiempo que REORG TABLESPACE utiliza para determinar qué diccionario de expansión se debe utilizar para rellenar el CDDS. Si el diccionario de expansión que utiliza actualmente el conjunto de páginas de destino tiene un valor LRSN posterior al valor SEARCHTIME, REORG busca el diccionario de expansión anterior en el Db2 registro y en la información de SYSCOPY. Si existe un diccionario de expansión anterior, REORG copia ese diccionario en el CDDS.

la marca de tiempo o el resultado de la evaluación de la expresión de duración etiquetada debe ser un valor TIMESTAMP(6).

NONE

Especifica que REORG rellena el CDDS a partir del diccionario de expansión que el conjunto de páginas de destino está utilizando actualmente.

indicación de fecha y hora

Especifica una constante TIMESTAMP(6) que determina qué diccionario de expansión se debe utilizar para rellenar el CDDS.

etiquetado-duración-expresión

Evalúa una constante TIMESTAMP(6) que determina qué diccionario de expansión se debe utilizar para rellenar el CDDS. El cálculo se basa en la FECHA Y HORA ACTUALES o en la FECHA ACTUAL. Puede sumar o restar uno o más valores constantes al valor de la FECHA ACTUAL o de la FECHA ACTUAL. La expresión no debe evaluar una marca de tiempo que se produzca después de ejecutar REORG. CURRENT TIMESTAMP y CURRENT DATE se evalúan una vez, cuando se procesa por primera vez la sentencia REORG. Si se especifica una lista de objetos, el mismo valor se aplica a todos los objetos de la lista.

CURRENT_DATE

Especifica que la marca de tiempo del diccionario de expansión debe calcularse en función de la FECHA ACTUAL.

CURRENT_TIMESTAMP

Especifica que la marca de tiempo del diccionario de expansión debe calcularse en función de la MARCA DE TIEMPO ACTUAL.

WITH TIME ZONE

Especifica que el valor CURRENT TIMESTAMP incluye una zona horaria. La precisión de la marca de tiempo del registro especial CURRENT TIMESTAMP debe ser la misma que la precisión de la marca de tiempo equivalente al valor LRSN para el diccionario de expansión. De lo contrario, se utiliza la precisión de marca de tiempo predeterminada. La zona horaria de CURRENT TIMESTAMP es el valor del registro especial CURRENT TIMEZONE. La comparación se realiza comparando la parte UTC de las marcas de tiempo.

constante

Indica una unidad de tiempo y va seguida de una de las siete palabras clave de duración: AÑOS, MESES, DÍAS, HORAS, MINUTOS, SEGUNDOS o MICROSEGUNDOS. La forma singular de estas palabras también es aceptable: AÑO, MES, DÍA, HORA, MINUTO, SEGUNDO, MICROSEGUNDO.

CLONE

Indica que REORG TABLESPACE debe reorganizar solo las tablas clonadas de los espacios de tablas especificados. Esta utilidad solo procesará datos de clonación si se especifica la palabra clave CLONE. El uso de YES CLONADO en la instrucción LISTDEF no es suficiente. Las mesas base en los espacios de mesa especificados no se reorganizan. Si especifica CLONE, no puede especificar STATISTICS. No se recopilan estadísticas para las tablas clonadas.

REUSE

Cuando se utiliza con SHRLEVEL NONE, especifica que REORG debe restablecer y reutilizar lógicamente Db2 -los conjuntos de datos gestionados sin borrarlos ni redefinirlos. Si no especifica REUSE y SHRLEVEL NONE, Db2 borra y redefine Db2 -los conjuntos de datos gestionados para restablecerlos.

Si un conjunto de datos tiene varias extensiones, estas no se liberan si se utiliza el parámetro REUSE.

REUSE no se aplica si también especifica SHRLEVEL REFERENCE o CHANGE.

SCOPE

Indica el alcance de la reorganización del espacio de tabla especificado o de una o más particiones especificadas.

ALL

Indica que desea reorganizar el espacio de la tabla especificado o una o varias particiones. El valor predeterminado es Todos.

PENDING

Indica que desea que el espacio de tabla especificado o una o más particiones se reorganicen solo si están en estado REORG-pending (REORP, AREO* o AREOR).

PART(entero )

PART(entero1:entero2)

PART( entero,… entero,… entero1 : entero2,… entero1 : entero2 )

Identifica el conjunto de particiones que se van a reorganizar. El conjunto de particiones debe estar entre paréntesis.

Puede reorganizar:

• Una o más particiones individuales
• Uno o más rangos de particiones
• Una combinación de una o más particiones individuales y una o más gamas de particiones

Las particiones no tienen que ser consecutivas.

entero, integer1, y integer2 son números de partición física. Cada número de partición debe estar en el rango de 1 al número de particiones que están definidas para el espacio de tabla o índice de partición. El máximo es 4096.

entero

Designa una sola partición.

integer1:integer2

Designa una serie de particiones de espacio de mesa existentes. Puede especificar el rango en cualquier orden. Por ejemplo, puede especificar (100:199) o (199:100). En cualquier caso, se reorganizan las particiones 100 a 199. Si integer1 es igual a integer2, solo se reorganiza esa partición. Por ejemplo, si especifica (5:5), sólo se reorganizará la partición 5.

Si omite la palabra clave PART, se reorganiza todo el espacio de la tabla.

Si especifica la palabra clave PART para un espacio de tabla LOB, Db2 emite un mensaje de error y el procesamiento de la utilidad finaliza con el código de retorno 8.

Si especifica un rango de particiones y las particiones altas o bajas de la lista están en estado REORG-pending (REORG pendiente), la partición adyacente que está fuera del rango especificado no debe estar en estado REORG-pending; de lo contrario, la utilidad finaliza con un error.

Restricción: No puede ejecutar REORG TABLESPACE SHRLEVEL CHANGE PART entero s simultáneas en el mismo espacio de tabla con uno o más índices no particionados definidos en él. En lugar de enviar varios trabajos, puede fusionarlos en uno solo especificando todas las particiones de destino en el mismo trabajo REORG.

Si reorganiza una sola partición o un rango de particiones, todos los índices del espacio de tabla se ven afectados. En función de la desorganización de los índices de no particionamiento, es posible que desee reorganizarlos. Véase Determinar qué índices requieren reorganización.

REBALANCE

Especifica que REORG TABLESPACE debe establecer nuevos límites de partición para que las filas se distribuyan uniformemente en las particiones reorganizadas. Si las columnas que se utilizan para definir los límites de la partición tienen muchos valores duplicados dentro de las filas de datos, ni siquiera el equilibrio es siempre posible. Especifique REBALANCE para más de una partición; si especifica una sola partición para reequilibrar, REORG TABLESPACE ignorará la especificación.

Una operación REORG REBALANCE que construye diccionarios de compresión construye un único diccionario utilizando filas de datos de todas las particiones de destino en la fase UNLOAD. A continuación, REORG carga ese diccionario en todas las particiones de datos de destino y lo utiliza para comprimir los datos en la fase RELOAD.

Puede especificar REBALANCE con SHRLEVEL NONE, SHRLEVEL CHANGE o SHRLEVEL REFERENCE. Debe especificar SHRLEVEL REFERENCE o SHRLEVEL CHANGE si el espacio de tabla base tiene un espacio de tabla LOB auxiliar asociado. En este caso, también debe especificar AUX YES, que es el valor predeterminado si especifica REBALANCE. Cuando se especifica REBALANCE con SHRLEVEL REFERENCE o SHRLEVEL CHANGE, los cambios de definición pendientes para la conversión de un espacio de tabla particionado a un espacio de tabla particionado por rango no se materializan.

REBALANCE no puede especificarse con SCOPE PENDING.

Restricciones : REBALANCE no se puede especificar para los siguientes objetos:

• Espacios de tablas de partición por crecimiento
• Tablas base con columnas XML
• Espacios de tablas XML
• Objeto que participa en una relación de clonación. (Debido a que las tablas base y clon comparten información de catálogo, REBALANCE puede cambiar los límites de partición de la tabla de destino)
• Espacios de mesa con cambios de clave pendientes de límite de modificación

Cuando especifique REBALANCE, debe crear una copia en línea realizando una de las siguientes acciones:

• Proporcione un extracto SYSCOPY DD en el JCL.
• Utilice la utilidad TEMPLATE para asignar dinámicamente el conjunto de datos SYSCOPY.
• Especifique un nombre de DD con la opción COPYDDN en la sentencia de control REORG y especifique una sentencia DD correspondiente o una sentencia TEMPLATE.

Al finalizar, Db2 se invalidan los paquetes y la caché dinámica.

SORTCLUSTER

Determina si REBALANCE debe intentar ordenar los registros de datos en orden de agrupación. Esta opción se ignora si no existe ningún índice de agrupación en la tabla, o cuando las columnas clave de límite son idénticas o son un superconjunto de las columnas de índice de agrupación.

NO

Especifica que los registros de datos no deben ordenarse explícitamente en orden de agrupación. Esta opción es el comportamiento predeterminado.

Si se especifica explícitamente SORTCLUSTER NO, el estado de aviso pendiente de REORG (AREO*) no se establece en las particiones de datos afectadas tras la finalización de REORG REBALANCE. Si SORTCLUSTER NO no se especifica explícitamente y en su lugar se acepta por defecto, el estado AREO* puede seguir configurándose en las particiones afectadas.

YES

Especifica que los registros de datos deben ordenarse explícitamente en orden de agrupación según sea necesario.

LOG

Especifica si los registros deben registrarse durante la fase RELOAD de REORG SHRLEVEL NONE. Si los registros no se registran, el espacio de la tabla solo se puede recuperar después de realizar una copia de imagen. Se toma una copia de la imagen durante la ejecución de REORG si se especifica COPYDDN, FCCOPYDDN, RECOVERYDDN, SHRLEVEL REFERENCE o SHRLEVEL CHANGE.

SÍ

Especifica que los registros de registro deben tomarse durante la fase de RECARGA. Esta opción no está permitida para ningún espacio de tabla en DSNDB01 o DSNDB06, o si se especifica la opción SHRLEVEL REFERENCE o CHANGE.

El valor predeterminado es SÍ si SHRLEVEL NONE se especifica explícitamente o por defecto. Si se especifica SHRLEVEL NONE pero el espacio de la tabla tiene el atributo NOT LOGGED, Db2 procesa LOAD con LOG NO.

NO

Especifica que los registros no deben registrarse. Esta opción es la predeterminada y necesaria si se especifica la opción SHRLEVEL REFERENCE o CHANGE. LOG NO pone el espacio de la tabla en estado COPY-pending cuando REORG se ejecuta de forma remota y RECOVERYDDN no se especifica.

DROP_PART

Especifica si la utilidad REORG TABLESPACE eliminará las particiones numeradas más altas en un espacio de tabla de partición por crecimiento, si están vacías, cuando se reorganice todo el espacio de tabla.

La palabra clave DROP_PART no tiene efecto cuando REORG se ejecuta en los siguientes espacios de tabla:

• espacios de tabla LOB
• Espacios de mesa que no están definidos como partición por crecimiento
• Espacios de tabla de partición por crecimiento que se definen con un valor MAXPARTITONS de 1
• Espacios de tabla de partición por crecimiento que contienen tablas definidas con CAMBIOS DE CAPTURA DE DATOS
• Hash partición por crecimiento espacios de tabla
• Un objeto que participa en una relación de clonación

Cuando no se especifica DROP_PART, el comportamiento de la utilidad REORG se basa en el valor del parámetro del subsistema REORG_DROP_PBG_PARTS.

NEE

Especifica que la utilidad REORG TABLESPACE no eliminará ninguna de las particiones con el número más alto en un espacio de tabla de particiones por crecimiento, si están vacías, al completarse con éxito.

YES

Especifica que la utilidad REORG TABLESPACE eliminará las particiones con el número más alto en un espacio de tabla de particiones por crecimiento, si están vacías, al completarse con éxito.

Cuando se especifica AUX YES o se establece por defecto con DROP_PART YES y se eliminan particiones vacías durante la reorganización del espacio de la tabla base, también se eliminan los espacios de la tabla LOB para esas particiones.

Cuando se especifica DROP_PART YES para un espacio de tabla que no es un espacio de tabla de partición por crecimiento, o cuando se especifica REORG TABLESPACE en un nivel de partición, DROP_PART YES se ignora y se devuelve un mensaje informativo.

Si se especifica FASTSWITCH NO, la palabra clave DROP_PART no tiene efecto.

SORTDATA o SORTDATA NO

SORTDATA especifica que los datos deben descargarse mediante un escaneo del espacio de tabla y ordenarse en orden de agrupación.

El valor predeterminado es SORTDATA, a menos que especifique UNLOAD ONLY o UNLOAD EXTERNAL. Si especifica una de estas opciones, el valor predeterminado es SORTDATA NO.

SORTDATA NO especifica que, cuando sea posible, los datos se descargarán en el orden del índice de agrupación. Especifique SORTDATA NO si se cumple una de las siguientes condiciones:

• Los datos están en orden de agrupación perfecto o casi perfecto, y la utilidad REORG se utiliza para recuperar espacio de las tablas eliminadas.
• La cantidad de datos es muy grande y no hay suficiente espacio en disco disponible para ordenarlos.

Para un espacio de tabla particionado, REORG no descarga los registros mediante el índice de agrupación cuando el índice de agrupación no está particionando. Los registros de datos deben descargarse primero por orden de partición. Además, cuando se utiliza REORG para descargar o recargar el paralelismo de particiones, o cuando REORG se ejecuta en un espacio de tabla de partición por crecimiento, REORG siempre realiza un escaneo del espacio de tabla para descargar los registros de datos, cuando no se utiliza el índice de agrupación.

Información relacionada:

• Índices de agrupación en clúster

RECLUSTER

Especifica si los registros de datos deben reagruparse descargándolos mediante el índice de agrupación.

El N.º DE RECLUSIÓN siempre se aplica en las siguientes situaciones:

• para el procesamiento de CAMBIO DE NIVEL DE SHR
• cuando el índice de agrupación tiene el atributo EXCLUDE NULL KEYS
• para un espacio de mesa PBG
• cuando se utiliza el paralelismo en la operación REORG

YES

Los registros de datos deben reagruparse y descargarse mediante el índice de agrupación, si existe. Esta opción es el comportamiento predeterminado.

NEE

Los registros de datos no deben reagruparse ni descargarse mediante el índice de agrupación.

NOSYSREC

Especifica que REORG TABLESPACE no debe utilizar un conjunto de datos de descarga. La utilidad utiliza el resultado de la clasificación como entrada para recargar, pero no utiliza un conjunto de datos de descarga para este proceso.

Omitir el conjunto de datos de descarga puede mejorar el rendimiento. Sin embargo, cuando omite el conjunto de datos de descarga especificando NOSYSREC, existen las siguientes limitaciones para reiniciar la utilidad:

• Si se produce un error durante la recarga, debe reiniciar la utilidad al comienzo de la fase de DESCARGA. (Si no especifica NOSYSREC, puede iniciar la utilidad en la fase RELOAD)
• Si especifica SHRLEVEL NONE y se produce un error durante la recarga, primero debe ejecutar la utilidad RECOVER con la copia de imagen más reciente.

Si especifica SHRLEVEL NONE con NOSYSREC, cree una copia de imagen antes de ejecutar REORG TABLESPACE.

No puede especificar NOSYSREC si se cumple alguna de las siguientes condiciones:

• No se ordenarán datos durante el trabajo REORG TABLESPACE. Ejemplos: se especifica SORTDATA NO o no se define ningún índice en los datos que se están reorganizando.
• Se especifica DESCARGAR PAUSA.
• SOLO DESCARGA está especificado.

COPYDDN (ddname1,ddname2)

Especifica las instrucciones DD para los conjuntos de datos de copia principal ( ddname1 ) y de respaldo ( ddname2 ) para la copia de imagen.

ddname1 y ddname2 son los nombres de los DD.

El valor predeterminado es SYSCOPY para la copia principal. Cuando se ejecuta REORG, se crea un conjunto completo de datos de copia de imágenes. Esta copia se denomina copia en línea. El espacio de la tabla no permanece en estado COPIA pendiente, independientemente de la opción de REGISTRO que especifique.

Cuando se realiza una copia en línea, Db2 se escribe un registro con ICTYPE='F' en la tabla de catálogo de SYSIBM.SYSCOPY. El nombre del conjunto de datos de copia en línea aparece en ese registro. Si se realiza una copia en línea cuando REORG se ejecuta en un rango de particiones, Db2 escribe un registro con ICTYPE='F' para cada partición. El nombre del conjunto de datos de copia en línea es el mismo en todos esos registros.

Si especifica SHRLEVEL NONE (explícitamente o por defecto) para REORG, y COPYDDN no está especificado, no se crea una copia de imagen en el sitio local.

Se asume COPYDDN (SYSCOPY) y se requiere una declaración DD para SYSCOPY si se cumple alguna de las siguientes condiciones:

• Especifique REORG SHRLEVEL REFERENCE o CHANGE, y no especifique COPYDDN.
• Un espacio de mesa o partición está en estado REORG-pending (REORP).
• Usted especifica REBALANCE.

La palabra clave COPYDDN especifica un nombre DD o un nombre de plantilla de una sentencia TEMPLATE anterior. Si el procesamiento de utilidades detecta que el nombre especificado es tanto un nombre DD en el paso de trabajo actual como un nombre TEMPLATE, la utilidad utiliza el nombre DD. Si el nombre de la plantilla utiliza el &PA. o &PART. rEORG asigna un conjunto de datos de copia independiente para cada partición que se reorganiza.

REORG puede realizar copias en línea de espacios de tablas XML.

RECOVERYDDN (ddname3,ddname4)

Especifica las sentencias DD para los conjuntos de datos de (ddname3) primario y de (ddname4) copia de copia de seguridad para la copia de imagen en el sitio de recuperación.

ddname3 y ddname4 son los nombres DD.

No puede tener conjuntos de datos de copia de imagen duplicados. Las mismas reglas se aplican para RECOVERYDDN que para COPYDDN.

La palabra clave RECOVERYDDN especifica un nombre DD o un nombre de plantilla de una sentencia TEMPLATE anterior. Si el procesamiento de utilidades detecta que el nombre especificado es tanto un nombre DD en el paso de trabajo actual como un nombre TEMPLATE, la utilidad utiliza el nombre DD. Si el nombre de la plantilla utiliza el &PA. o &PART. rEORG asigna un conjunto de datos de copia independiente para cada partición que se reorganiza.

REORG SHRLEVEL REFERENCE de un espacio de tabla LOB admite copias en línea, pero REORG SHRLEVEL NONE no.

ICLIMIT_DASD num-dasd

Especifica el número máximo de copias de imagen secuenciales que REORG TABLESPACE puede asignar a DASD. Los valores válidos para num-dasd son de 0 a 32767. Un valor de 0 indica que no hay límite para el número de copias de imágenes DASD que REORG puede asignar.

El valor especificado para ICLIMIT_DASD anula el valor del parámetro del subsistema REORG_IC_LIMIT_DASD.

ICLIMIT_TAPE cinta numérica

Especifica el número máximo de copias de imagen secuenciales que REORG TABLESPACE puede asignar a la cinta. Los valores válidos para num-tape son de 0 a 32767. Un valor de 0 indica que no hay límite para el número de copias de imágenes de cinta que REORG puede asignar.

El valor especificado para ICLIMIT_TAPE anula el valor del parámetro del subsistema REORG_IC_LIMIT_TAPE.

FLASHCOPY

Especifica si se utiliza la tecnología de compresión de archivos ( FlashCopy ) para crear una copia del objeto. Los valores válidos son SÍ, NO o COHERENTE. Cuando se utiliza FlashCopy, se crea un conjunto de datos independiente para cada partición o pieza del objeto.

Las especificaciones de FlashCopy en la declaración de control de utilidad anulan cualquier especificación para FlashCopy que se defina utilizando los Db2 parámetros del subsistema. Si los parámetros del subsistema FlashCopy especifican el uso de FlashCopy como comportamiento predeterminado de esta utilidad, la opción FLASHCOPY puede omitirse de la instrucción de control de la utilidad.

FlashCopy I mportante : Si el conjunto de datos de entrada es inferior a un cilindro, es posible que no se utilice la tecnología FLASHCOPY para copiar los objetos, independientemente de la configuración de FLASHCOPY. IDCAMS realiza la copia si no se utiliza FlashCopy.

NO

Especifica que no se realiza ningún « FlashCopy ». NO es el valor predeterminado para FLASHCOPY.

YES

Especifica que se utiliza tecnología de compresión ( FlashCopy ) para copiar el objeto.

Especifique SÍ solo si los Db2 conjuntos de datos están en volúmenes de disco de la versión 2 de FlashCopy.

Importante : En las siguientes circunstancias, es posible que la utilidad REORG TABLESPACE no utilice FlashCopy aunque se especifique YES:

• FlashCopy Los volúmenes de disco de la versión 2 no están disponibles
• Las pistas de origen ya son el objetivo de una operación de e FlashCopy
• Las pistas de destino son el origen de una operación de " FlashCopy " (transferencia de archivos)
• Se ha superado el número máximo de relaciones para la copia

Si se solicita FlashCopy pero no se utiliza, REORG TABLESPACE falla con el código de retorno 8 cuando se especifica REORG con SHRLEVEL REFERENCE o SHRLEVEL CHANGE. Los objetos objeto de la reorganización quedan en el mismo estado de lectura/escritura que si nunca se hubiera ejecutado REORG TABLESPACE.

Si no se especifica SHRLEVEL REFERENCE o SHRLEVEL CHANGE y se solicita FlashCopy pero no se utiliza, REORG TABLESPACE finaliza con el código de retorno 8. Si no se solicita una copia en línea secuencial en el mismo trabajo, los objetos se dejan en estado pendiente de COPIA.

CONSISTENT

Especifica que se utiliza tecnología de compresión ( FlashCopy ) para copiar el objeto. Debido a que las copias creadas por la utilidad REORG TABLESPACE ya son consistentes, la utilidad trata una especificación de CONSISTENT de la misma manera que una especificación de YES.

Información relacionada:

• Copias de imagen de FlashCopy
• Parámetros de subsistema para perfeccionar la operación DFSMSdss COPY con programas de utilidad

FCCOPYDDN

Especifica la plantilla que se utilizará para crear los nombres de los conjuntos de datos de copia de imágenes de FlashCopy. Si no se especifica un valor para FCCOPYDDN en la instrucción de control REORG TABLESPACE cuando se utiliza FlashCopy, el valor especificado en el parámetro del subsistema FCCOPYDDN determina la plantilla que se utilizará.

(nombre-plantilla )

Los nombres de los conjuntos de datos para la copia de la imagen FlashCopy se asignan de acuerdo con la especificación de la plantilla. Para copias de imágenes de nivel de espacio de tabla o espacio de índice FlashCopy, dado que se asigna un conjunto de datos para cada partición o pieza, asegúrese de que la convención de nomenclatura de conjuntos de datos en la especificación de la plantilla sea lo suficientemente única. Utilice la variable &DSNUM, que se resuelve en un número de partición o número de pieza en el momento de la ejecución.

AUTOESTSPACE

Especifica que REORG calcula y formatea automáticamente el tamaño del espacio hash fijo para los espacios de tablas organizados por hash. El uso de AUTOESTSPACE YES podría reducir el número de filas en el área de desbordamiento.

YES

Especifica que Db2 utiliza valores de estadísticas en tiempo real (RTS) para ajustar el tamaño del espacio hash. Los valores HASH SPACE especificados por el usuario almacenados en las tablas de catálogo SYSIBM.SYSTABLESPACE y SYSIBM.SYSTABLEPART no se modifican. SÍ es el valor predeterminado para AUTOESTSPACE.

NO

Especifica que Db2 utiliza el valor HASH SPACE especificado para CREATE TABLE o ALTER TABLE. Estos valores se almacenan en las tablas de catálogo SYSIBM.SYSTABLESPACE y SYSIBM.SYSTABLEPART.

SHRLEVEL

Especifica el método que se utilizará para la reorganización. El parámetro que sigue a SHRLEVEL indica el tipo de acceso que se va a permitir durante la fase RELOAD de REORG.

None

Especifica que la reorganización funcionará de la siguiente manera:

• Descarga desde el área que se está reorganizando (mientras que las aplicaciones pueden leer pero no escribir en el área)
• Recargar en esa área (mientras las aplicaciones no tienen acceso) y luego permitir el acceso de lectura/escritura nuevamente

Si especifica NINGUNO (explícitamente o por defecto), no podrá especificar los siguientes parámetros:

• TABLA DE CORRESPONDENCIAS
• MAXRO
• LONGLOG
• DELAY
• Fecha límite
• DRAIN_WAIT
• RETRY
• RETRY_DELAY

Restricciones:

• Si especifica UNLOAD PAUSE o UNLOAD ONLY, no puede especificar NOSYSREC. SHRLEVEL NONE no se puede especificar para tablas que se definen con ORGANIZE BY HASH.
• No se puede especificar SHRLEVEL NONE en una instrucción de control REORG TABLESPACE que complete el proceso de recuperación a un punto en el tiempo anterior a la materialización de los cambios de definición pendientes.

Cuando se especifica SHRLEVEL NONE, los cambios de definición pendientes no se materializan y los estados restrictivos asociados no se restablecen. Por ejemplo, los cambios pendientes de la clave de límite no se materializan y el estado de aviso de REORG-pendiente asociado no se restablece. (Los cambios inmediatos de límite de alteración pueden materializarse mediante REORG SHRLEVEL NONE)

SHRLEVEL NONE no es compatible cuando REORG se ejecuta en un espacio de tabla LOB.

REFERENCE

Especifica que la reorganización funcionará de la siguiente manera:

• Descarga desde el área que se está reorganizando (mientras que las aplicaciones pueden leer pero no escribir en el área)
• Recargar en una copia sombra de esa área (mientras que las aplicaciones pueden leer pero no pueden escribir en la copia original)
• Cambiar el acceso futuro de una aplicación de la copia original a la copia sombra intercambiando los nombres de los conjuntos de datos y, a continuación, permitir de nuevo el acceso de lectura/escritura

Si especifica SHRLEVEL REFERENCE y FASTSWITCH NO:

• Los cambios de definición pendientes no se han materializado.
• El parámetro del subsistema REORG_DROP_PBG_PARTS o la opción DROP_PART no tienen efecto. Si REORG_DROP_PBG_PARTS está configurado en ENABLE o si DROP_PART está configurado en YES, las particiones finales vacías no se eliminan.

Si especifica REFERENCE para un espacio de tabla LOB, debe realizar una copia en línea durante la reorganización.

Si especifica REFERENCE, no podrá especificar los siguientes parámetros:

• INICIO DE SESIÓN. La reorganización con REFERENCE siempre crea una copia de imagen y siempre se abstiene de registrar registros durante la recarga.
• DESCARGAR EN PAUSA, DESCARGAR SOLO o DESCARGAR EXTERNO. La reorganización con REFERENCE siempre utiliza DESCARGAR CONTINUAR, que es el valor predeterminado. (Puede especificar explícitamente DESCARGAR CONTINUAR o ninguna de las opciones de DESCARGAR, pero no puede especificar DESCARGAR PAUSA, DESCARGAR SOLO o DESCARGAR EXTERNO)
• TABLA DE CORRESPONDENCIAS.

Especificar REORG TABLESPACE PART SHRLEVEL REFERENCE con el parámetro del subsistema REORG_PART_SORT_NPSI habilitado podría requerir conjuntos de datos de trabajo de clasificación más grandes debido al aumento del número de claves clasificadas para índices secundarios no particionados.

Especificar SHRLEVEL REFERENCE o CHANGE en un espacio de tabla XML particionado completo convierte el espacio de tabla XML al formato extendido de 10 bytes si se cumple una de las siguientes condiciones:

• El parámetro del subsistema UTILITY OBJECT CONVERSION está establecido en EXTENDED o NOBASIC.
• Se especifican las palabras clave RBALRSN_CONVERSION EXTENDED.

Restricción : No puede especificar SHRLEVEL REFERENCE cuando se ejecuta REORG TABLESPACE con PART en un espacio de tabla NOT LOGGED en el que se definen índices no particionados.

CHANGE

Especifica que la reorganización funcionará de la siguiente manera:

• Descarga desde el área que se está reorganizando (mientras que las aplicaciones pueden leer y escribir en el área)
• Recargar en una copia sombra de esa área (mientras las aplicaciones tienen acceso de lectura/escritura a la copia original del área)
• Aplicar el registro de la copia original a la copia sombra (mientras que las aplicaciones pueden leer y normalmente escribir en la copia original)
• Cambiar el acceso futuro de una aplicación de la copia original a la copia sombra intercambiando los nombres de los conjuntos de datos y, a continuación, permitir de nuevo el acceso de lectura/escritura

Si especifica CAMBIO DE NIVEL y FASTSWITCH NO:

• Los cambios de definición pendientes no se han materializado.
• El parámetro del subsistema REORG_DROP_PBG_PARTS o la opción DROP_PART no tienen efecto. Si REORG_DROP_PBG_PARTS está configurado en ENABLE o si DROP_PART está configurado en YES, las particiones finales vacías no se eliminan.

Si especifica CHANGE, no podrá especificar los siguientes parámetros:

• INICIO DE SESIÓN. La reorganización con CHANGE siempre crea una copia de la imagen y siempre se abstiene de registrar los registros durante la recarga.
• DESCARGAR EN PAUSA, DESCARGAR SOLO o DESCARGAR EXTERNO. La reorganización con CHANGE siempre utiliza UNLOAD CONTINUE, que es el valor predeterminado. (Puede especificar explícitamente DESCARGAR CONTINUAR o ninguna de las opciones de DESCARGAR, pero no puede especificar DESCARGAR PAUSA, DESCARGAR SOLO o DESCARGAR EXTERNO)

Realizar REORG TABLESPACE PART SHRLEVEL CHANGE con el parámetro del subsistema REORG_PART_SORT_NPSI habilitado podría requerir conjuntos de datos de trabajo de clasificación más grandes debido al aumento del número de claves clasificadas para índices secundarios no particionados.

Especificar SHRLEVEL REFERENCE o CHANGE en un espacio de tabla XML particionado completo convierte el espacio de tabla XML al formato extendido de 10 bytes si se cumple una de las siguientes condiciones:

• El parámetro del subsistema UTILITY OBJECT CONVERSION está establecido en EXTENDED o NOBASIC.
• Se especifican las palabras clave RBALRSN_CONVERSION EXTENDED.

Si especifica SHRLEVEL CHANGE y no especifica KEEPDICTIONARY al ejecutar REORG TABLESPACE en el grupo de origen en un entorno GDPS de disponibilidad continua con pérdida de datos cero, Db2 inserta un diccionario de descompresión en el CDDS durante la fase de cambio.

Restricciones:

• No puede especificar SHRLEVEL CHANGE si el espacio de tabla tiene el atributo NOT LOGGED, a menos que el espacio de tabla sea un espacio de tabla LOB.
• Si especifica SHRLEVEL CHANGE en una instrucción de control REORG TABLESPACE que completa el proceso de recuperación a un punto en el tiempo anterior a la materialización de los cambios de definición pendientes, REORG emite un mensaje y utiliza SHRLEVEL REFERENCE.

DEADLINE

Especifica la fecha límite para el inicio de la fase SWITCH. Si Db2 estima que la fase SWITCH no comenzará en el plazo establecido, Db2 emite los mensajes que emitiría el comando DISPLAY UTILITY y, a continuación, finaliza la reorganización.

El resultado final y todos los cálculos de la marca de tiempo de DEADLINE estarán en TIMESTAMP(6).

Si REORG SHRLEVEL REFERENCE o SHRLEVEL CHANGE finalizan debido a una especificación de FECHA LÍMITE, Db2 emite un mensaje DSNU374I con el código de motivo 2, pero no establece un estado restrictivo.

None

Especifica que no existe un plazo límite para el inicio de la fase SWITCH del procesamiento de registros.

marca de tiempo

Especifica la fecha límite para que comience la fase SWITCH del procesamiento de registros. Este plazo no debe haber vencido cuando se ejecute REORG.

etiquetado-duración-expresión

Calcula la fecha límite para que comience la fase SWITCH del procesamiento de registros. El cálculo se basa en la FECHA Y HORA ACTUALES o en la FECHA ACTUAL. Puede sumar o restar uno o más valores constantes para especificar la fecha límite. Este plazo no debe haber vencido cuando se ejecute REORG. CURRENT TIMESTAMP y CURRENT DATE se evalúan una vez, cuando se procesa por primera vez la sentencia REORG. Si se especifica una lista de objetos, el mismo valor se aplicará a todos los objetos de la lista.

CURRENT_DATE

Especifica que el plazo debe calcularse en función de la FECHA ACTUAL.

CURRENT_TIMESTAMP

Especifica que la fecha límite debe calcularse en función de la FECHA Y HORA ACTUALES.

WITH TIME ZONE

Especifica que la FECHA Y HORA ACTUAL se compara con la columna de zona horaria. La precisión de la marca de tiempo del registro especial CURRENT TIMESTAMP debe ser la misma que la precisión de la marca de tiempo de la columna. De lo contrario, se utiliza la precisión de marca de tiempo predeterminada. La zona horaria de CURRENT TIMESTAMP es el valor del registro especial CURRENT TIMEZONE. La comparación se realiza comparando la parte UTC de la marca de tiempo.

constante

Indica una unidad de tiempo y va seguida de una de las siete palabras clave de duración: AÑOS, MESES, DÍAS, HORAS, MINUTOS, SEGUNDOS o MICROSEGUNDOS. La forma singular de estas palabras también es aceptable: AÑO, MES, DÍA, HORA, MINUTO, SEGUNDO, MICROSEGUNDO.

DRAIN_WAIT entero

Especifica el número de segundos que la utilidad espera al vaciar el espacio de la tabla o el índice. El tiempo especificado es el tiempo total para los objetos que se van a reorganizar. Este valor anula los valores especificados por IRLMRWT y UTIMOUT. Los valores válidos para enteros son de 0 a 1800. Si se omite la palabra clave o si se especifica un valor de 0, la utilidad utiliza el valor del parámetro del sistema de tiempo de espera de bloqueo IRLMRWT.

RETRY entero

Especifica el número máximo de reintentos que REORG debe intentar. Los valores válidos para enteros son de 0 a 255.

Especificar REINTENTAR puede conllevar un aumento de los costes de procesamiento y puede dar lugar a períodos múltiples o prolongados de acceso de solo lectura. Por ejemplo, cuando especifica RETRY y SHRLEVEL CHANGE, el tamaño de la copia que toma REORG podría aumentar.

El valor predeterminado es el valor del parámetro del subsistema UTIMOUT.

RETRY_DELAY entero

Especifica la duración mínima, en segundos, entre reintentos. Los valores válidos para enteros son de 1 a 1800.

Si no especifica RETRY_DELAY, REORG TABLESPACE utiliza el menor de los dos valores siguientes:

• Valor DRAIN_WAIT × valor RETRY
• Valor DRAIN_WAIT × 10

MAPPINGTABLE nombre-tabla

Especifica el nombre de la tabla de correspondencia que REORG TABLESPACE debe utilizar para establecer correspondencias entre los RID de los registros de datos en la copia original del área y los RID correspondientes en la copia sombra. Encierre el nombre de tabla entre comillas si la tabla contiene un espacio en blanco. Si se requiere una tabla de correspondencia y no se especifica ninguna, REORG la creará.

MAPPINGDATABASE nombre-base-datos

Especifica la base de datos en la que REORG crea implícitamente la tabla de asignación y los objetos de índice. Esta palabra clave anula el valor del parámetro del subsistema en REORG_MAPPING_DATABASE. El valor no puede ser DSNDB01, DSNDB06, DSNDB07, base de datos implícita y archivo de trabajo o base de datos temporal.

MAXRO entero

Especifica la cantidad máxima de tiempo para la última iteración del procesamiento de registro. Durante esa iteración, las aplicaciones tienen acceso de solo lectura. MAXRO es un parámetro de fase de registro. Si se especifica MAXRO cuando no se necesita una fase de registro, se emite un mensaje de error.

El tiempo de ejecución real de la última iteración podría exceder el valor especificado para MAXRO.

El comando ALTER UTILITY puede cambiar el valor de MAXRO.

El valor predeterminado es el valor predeterminado de RETRY_DELAY.

entero

entero es el número de segundos. Especificar un valor positivo pequeño reduce la duración del periodo de acceso de solo lectura, pero podría aumentar el tiempo transcurrido para que se complete REORG. Si especifica un valor positivo enorme, la segunda iteración del procesamiento de registro es probablemente la última iteración.

DEFER

Especifica que las iteraciones del procesamiento de registros con acceso de lectura-escritura pueden continuar indefinidamente. REORG nunca comienza la iteración final con acceso de solo lectura, a menos que cambie el valor MAXRO con ALTER UTILITY.

Si especifica DEFER, también debe especificar LONGLOG CONTINUE.

Si especifica DEFER, y Db2 determina que el tiempo real para una iteración y el tiempo estimado para la siguiente iteración son ambos inferiores a 5 segundos, Db2 añade una pausa de 5 segundos a la siguiente iteración. Esta pausa reduce el consumo de tiempo del procesador. La primera vez que se produce esta situación para una ejecución determinada de REORG, Db2 envía un mensaje DSNU362I a la consola. El mensaje indica que el número de registros de registro que deben procesarse es pequeño y que se produce la pausa. Para cambiar el valor MAXRO y hacer que REORG finalice, ejecute el comando ALTER UTILITY . Db2 añade la pausa siempre que se da la situación; sin embargo, Db2 envía el mensaje solo si han transcurrido 30 minutos desde que se envió el último mensaje para una ejecución determinada de REORG.

DRAIN

Especifica el comportamiento de drenaje al final de la fase de registro después de que se alcance el umbral MAXRO y cuando se deba aplicar la última iteración del registro. DRAIN es un parámetro de fase de registro. Si se especifica DRENAJE cuando no se necesita una fase de registro, se emite un mensaje de error.

WRITERS

Especifica que Db2 drena solo los escritores durante la fase de registro después de que se alcanza el umbral MAXRO y luego emite DRAIN ALL al entrar en la fase de conmutación.

TODOS

Especifica la acción predeterminada actual, en la que Db2 es vaciar todos los lectores y escritores durante la fase de registro, después de que se alcance el umbral MAXRO.

Considere especificar DRENAJE TOTAL si se cumplen las dos condiciones siguientes:

• La actividad de actualización de SQL es alta durante la fase de registro.
• El comportamiento predeterminado da como resultado un gran número de mensajes de error SQL -911.

Información relacionada:

• Reclamar clases que REORG TABLESPACE drena

LONGLOG

Especifica la acción que Db2 se va a realizar, después de enviar un mensaje a la consola, si el número de registros que la siguiente iteración de registro va a procesar no es lo suficientemente inferior al número que procesaron las iteraciones anteriores. Esta situación significa que la lectura del registro por la utilidad REORG TABLESPACE no se está realizando al mismo tiempo que la escritura del registro de la aplicación. LONGLOG es un parámetro de fase de registro. Si se especifica LONGLOG cuando no se necesita una fase de registro, se emite un mensaje de error.

CONTINUAR

Especifica que hasta que expire el tiempo en la declaración JOB, Db2 debe continuar realizando la reorganización, incluidas las iteraciones del procesamiento de registros, si el tiempo estimado para realizar una iteración supera el tiempo especificado para MAXRO.

Un valor de DEFER para MAXRO y un valor de CONTINUE para LONGLOG juntos significan que REORG continuará permitiendo el acceso a la copia original del área que se está reorganizando y no cambiará a la copia sombra. El usuario puede ejecutar el comando ALTER UTILITY con un valor grande para MAXRO para iniciar el cambio.

TERM

Especifica que Db2 es finalizar la reorganización después del retraso especificado por el parámetro DELAY.

DRAIN

Especifica que Db2 es vaciar la clase de reclamación de escritura después del retraso especificado por el parámetro DELAY. Esta acción fuerza la iteración final del procesamiento de registro. DRAIN es un parámetro de fase de registro. Si se especifica DRENAJE cuando no se necesita una fase de registro, se emite un mensaje de error.

DELAY entero

Especifica el intervalo mínimo entre el momento en que REORG envía el mensaje LONGLOG a la consola y el momento en que REORG realiza la acción especificada por el parámetro LONGLOG. El RETRASO es un parámetro de fase de registro. Si se especifica RETARDO cuando no se necesita una fase de registro, se emite un mensaje de error.

entero es el número de segundos.

El valor predeterminado es 1200.

LASTLOG

Especifica si REORG SHRLEVEL CHANGE debe aplicar algún registro durante la iteración final del registro en la fase LOG.

Especificar LASTLOG NO puede ayudar a reducir el tiempo de interrupción al evitar los costosos subprocesos (como la escritura forzada de conjuntos de páginas) que se producen en la iteración final del registro; sin embargo, LASTLOG NO puede hacer que REORG no se complete si no puede encontrar el período de tiempo requerido sin actividades DML concurrentes. LASTLOG NO requiere que la opción DRAIN ALL esté activa.

LASTLOG se ignora para ejecuciones REORG sin procesamiento SHRLEVEL CHANGE.

YES

Especifica que REORG debe realizar una ronda final de procesamiento de aplicación de registro después de vaciar todas las clases de reclamaciones (DRAIN ALL). Al especificar SÍ, se garantiza que REORG pase a la fase SWITCH después de completar la ronda final de procesamiento de aplicación de registros en la fase LOG.

SÍ es el valor predeterminado.

NEE

Especifica que REORG no debe aplicar ningún registro de registro en la iteración final del registro. Cuando se cumplen los criterios existentes para que REORG «entre» (obtenga el control de los objetos), REORG primero drena todas las clases de reclamaciones y luego procesa los registros desde el final de la última iteración de registro hasta el actual. Si se encuentra algún registro de los objetos de destino en esta iteración final del registro, REORG deshace el drenaje de los objetos de destino y vuelve a convertir esta iteración final del registro en una iteración normal del registro. Cuando REORG se «interrumpe» de nuevo en una iteración de registro futura, la utilidad repite este ciclo de vaciado completo, lectura de registro y vaciado hasta que puede completar la iteración de registro final sin registros de registro que aplicar. La reversión a una iteración de registro normal debido a la presencia de registros cuenta como un fallo de drenaje para la consideración de REINTENTO; por lo tanto, se recomienda un valor de REINTENTO alto para disminuir el impacto de los repetidos intentos de "introducción".

TIMEOUT

Especifica la acción que se debe tomar si la utilidad REORG obtiene una condición de tiempo de espera mientras intenta vaciar un objeto en las fases de registro o de conmutación.

DURACIÓN

Indica que Db2 debe comportarse de la siguiente manera si especifica la opción TERM y se produce una condición de tiempo de espera:

1. Db2 emite un comando implícito TERM UTILITY, lo que hace que la utilidad finalice con un código de retorno 8.
2. Db2 emite los mensajes DSNU590I y DSNU170I.
3. Db2 deja el objeto en un estado de lectura-escritura.

ABEND

Indica que, si se produce una condición de tiempo de espera, Db2 lleva a cabo una de las siguientes acciones:

• Si se especifica DRENA TODO, Db2 deja el objeto en estado UTRW.
• Si se especifica o se utiliza por defecto DRAIN WRITERS:
  • Si el fallo se produce cuando hay un bloqueo de drenaje de escritura en el objeto, Db2, el objeto queda en estado UTRW.
  • Si el fallo se produce cuando hay un bloqueo de lectura de drenaje en el objeto, Db2 deja el objeto en estado UTRO.

LOGOS

Especifica si REORG debe utilizar la información de SYSLGRNX para la fase LOG.

YES

REORG utiliza la información de SYSLGRNX para la fase LOG siempre que es posible. Esta opción es el comportamiento predeterminado.

NEE

REORG no utiliza información SYSLGRNX para la fase LOG. Esta opción puede hacer que REORG tarde mucho más en ejecutarse. En un entorno de intercambio de datos, esta opción puede dar lugar a la fusión de todos los registros de todos los miembros. Esta opción es factible cuando existe un problema de integridad conocido con las entradas SYSLGRNX y problemas de rendimiento al acceder a SYSLGRNX para la determinación de la lectura de registros.

DESAGÜE_TODAS_LAS_PIEZAS

Especifica la acción que se debe realizar durante una REORG TABLESPACE SHRLEVEL REFERENCE o CHANGE a nivel de parte cuando se define un índice secundario no particionado en un espacio de tabla particionado.

NEE

REORG vacía las particiones de datos de destino en serie, seguidas de los índices secundarios no particionados. Esta opción es el comportamiento predeterminado.

YES

REORG obtiene primero el vaciado del nivel de espacio de tabla en todo el espacio de tabla particionado, antes de vaciar las particiones de datos de destino y los índices. Esta opción puede proporcionar alivio al eliminar el agotamiento del drenaje o los bloqueos causados por el orden inverso de drenaje de objetos por REORG y reclamación de objetos por instrucciones DML.

SWITCHTIME

Especifica la hora de inicio de la iteración final del registro de la fase LOG. El resultado final y todos los cálculos de marca de tiempo de SWITCHTIME están en TIMESTAMP(6). Esta palabra clave puede especificarse con la palabra clave MAXRO. Si no se especifica MAXRO DEFER, REORG entra en la iteración final del registro de la fase LOG antes del valor SWITCHTIME especificado si se cumple el criterio MAXRO especificado o predeterminado. Cuando se especifica MAXRO DEFER, REORG no intenta entrar en la iteración final del registro hasta que se cumpla el SWITCHTIME especificado o se vea afectado por un comando externo ALTER UTILITY en el cambio de su valor MAXRO.

NONE

No especifica una hora para la iteración de registro final de la fase LOG. Esta opción es el comportamiento predeterminado.

marca de tiempo

Especifica la hora en que debe comenzar la iteración final del registro de la fase LOG. Este tiempo no debe haber transcurrido cuando se ejecute REORG.

etiquetado-duración-expresión

Calcula el momento en que debe comenzar la iteración final del registro de la fase LOG. El cálculo se basa en la FECHA Y HORA ACTUALES o en la FECHA ACTUAL. Puede sumar o restar uno o más valores constantes para especificar el tiempo de conmutación. Este cambio de hora no debe haber ocurrido ya cuando se ejecute REORG. CURRENT TIMESTAMP y CURRENT DATE se evalúan una vez, cuando se procesa por primera vez la sentencia REORG. Si se especifica una lista de objetos, el mismo valor se aplica a todos los objetos de la lista.

CURRENT_DATE

Especifica que el plazo debe calcularse en función de la FECHA ACTUAL.

CURRENT_TIMESTAMP

Especifica que la fecha límite debe calcularse en función de la FECHA Y HORA ACTUALES.

CON ZONA HORARIA

Especifica que la FECHA Y HORA ACTUAL se compara con la columna de zona horaria. La precisión de la marca de tiempo del registro especial CURRENT TIMESTAMP debe ser la misma que la precisión de la marca de tiempo de la columna. De lo contrario, se utiliza la precisión de marca de tiempo predeterminada. La zona horaria de CURRENT TIMESTAMP es el valor del registro especial CURRENT TIMEZONE. La comparación se realiza comparando la porción de Hora Universal Coordinada de la marca de tiempo.

constante

Indica una unidad de tiempo y va seguida de una de las siete palabras clave de duración: AÑOS, MESES, DÍAS, HORAS, MINUTOS, SEGUNDOS o MICROSEGUNDOS. La forma singular de estas palabras también es aceptable: AÑO, MES, DÍA, HORA, MINUTO, SEGUNDO, MICROSEGUNDO.

NEWMAXRO

Especifica la cantidad máxima de tiempo para la última iteración de registro después de que se cumpla SWITCHTIME. También debe especificarse la palabra clave SWITCHTIME. Este valor anula el parámetro MAXRO existente que se especifica. El valor por omisión es NONE.

NONE

Especifica que cuando se cumple el SWITCHTIME especificado, REORG procede a la última iteración de registro sin tener en cuenta el tiempo de procesamiento del registro. Si se especifica NINGUNO, REORG entrará en la última iteración de registro casi inmediatamente en el SWITCHTIME especificado o después. Esta opción es el valor predeterminado.

entero

entero es el número de segundos. Especificar un valor positivo pequeño reduce la duración del periodo de acceso de solo lectura, pero podría aumentar el tiempo transcurrido para que se complete REORG. Especificar un valor positivo grande probablemente garantice que REORG entre en la última iteración de registro casi inmediatamente en o después del SWITCHTIME especificado.

FORCE

Especifica la acción que se debe tomar cuando la utilidad está drenando el espacio de la tabla.

Cuando REORG FORCE cancela los hilos, realiza una cancelación suave similar a la cancelación que realiza CANCEL THREAD.

NONE

Especifica que no se realiza ninguna acción cuando REORG lleva a cabo el vaciado. La utilidad REORG espera a que los reclamantes se comprometan. La utilidad se agotará o reiniciará cuando falle el drenaje, según lo determinen las condiciones existentes.

READERS

Especifica que los reclamantes leídos se cancelan cuando REORG solicita un vaciado total en el último procesamiento de REINTENTO.

ALL

Especifica que tanto los reclamantes de lectura como los de escritura se cancelan cuando REORG solicita un vaciado total o vaciado de escritores en el último procesamiento de REINTENTO.

SORTNPSI

Especifica cuándo REORG TABLESPACE PART debe ordenar todas las claves de un índice secundario no particionado (NPSI). La ventaja de ordenar todas las claves NPSI aumenta a medida que aumenta la proporción de datos reorganizados respecto al total de datos en el espacio de la tabla. Sin embargo, la clasificación de las claves de índice puede añadir una sobrecarga de procesamiento para la utilidad.

Esta palabra clave se ignora para una operación REORG que no sea a nivel de partición o sin NPSI. El valor predeterminado es el valor del parámetro del subsistema REORG_PART_SORT_NPSI.

AUTO

La utilidad determina si ordenar todas las claves NPSI o sólo las claves en el ámbito de la operación REORG.

La decisión se basa en muchos factores, incluida una proyección del tiempo estimado transcurrido y el ahorro de rendimiento de la CPU al ordenar todas las claves NPSI que se están procesando. Sin embargo, el rendimiento real varía en función del escenario específico, y las reducciones de la CPU y del tiempo transcurrido no siempre están garantizadas.

YES

Todas las claves NPSI están ordenadas.

NO

Solo se ordenan las claves NPSI que están dentro del alcance de la operación REORG.

Cuando se especifica STATISTICS INDEX y se especifica SORTNPSI AUTO o el parámetro del subsistema REORG_PART_SORT_NPSI se establece en AUTO, REORG TABLESPACE PART puede recopilar estadísticas para un NPSI. Sin embargo, en alguno de estos casos, REORG no recopila estadísticas.

AUX

Especifica que los espacios de tabla LOB asociados a las particiones de un espacio de tabla particionado que está siendo reorganizado por la utilidad REORG también se reorganizan.

NO

Indica que se realiza una reorganización en el espacio de la tabla base, pero los espacios de las tablas LOB asociadas no se reorganizan.

Si se omite la palabra clave AUX, AUX NO es el valor predeterminado a menos que se den una o más de las circunstancias descritas en AUX YES.

AUX NO se ignora cuando el espacio de tabla de destino tiene cambios de definición pendientes para convertirlo de un espacio de tabla simple o segmentado (no UTS) a un espacio de tabla de partición por crecimiento. En este caso, AUX YES está en vigor.

No se puede especificar el LOG NO para una operación REORG que complete la recuperación a un punto en el tiempo anterior a que se materializaran los cambios de definición pendientes, si había cambios de definición pendientes en el espacio de la tabla base y en el espacio de la tabla LOB. REORG debe ejecutarse primero en el espacio de tabla LOB y, a continuación, en el espacio de tabla base. Cuando REORG se ejecuta en el espacio de la tabla base, AUX YES está en efecto.

Para una tabla con columnas LOB que se ven afectadas por claves de límite pendientes de modificación, un trabajo REORG con AUX NO no materializa los cambios de clave de límite. En este caso, debe especificar AUX SI para que esos cambios se materialicen.

YES

Indica que los espacios de tabla LOB asociados con el espacio de tabla particionado base se reorganizan cuando se reorganiza el espacio de tabla base. Las particiones de los espacios de tabla asociados también se reorganizan.

Si se omite la palabra clave AUX, en los siguientes casos, AUX YES es el valor predeterminado:

• REORG TABLESPACE de un espacio de tabla base de partición por crecimiento con una o más columnas LOB, donde el espacio de tabla tiene un valor MAXPARTITIONS mayor que uno.
• REORGANIZAR TABLESPACE SHRLEVEL REFERENCE REBALANCE de un espacio de tabla base particionado con una o más columnas LOB.
• REORG TABLESPACE se ejecuta contra el espacio de tabla de directorios SPT01, y SPT01 está en el estado REORP o AREOR. En este caso, siempre se utiliza AUX YES.
• REORG TABLESPACE de un espacio de tabla base particionado con una o más columnas LOB donde uno o más rangos de particiones están en estado pendiente de REORG porque se ha emitido un comando ALTER TABLE PARTITION para cambiar los límites de la clave de partición.
• REORG TABLESPACE DESCARTAR una tabla en un espacio de tabla particionado con una o más columnas LOB.

Cuando AUX YES se especifica implícita o explícitamente, y el parámetro COPYDDN especifica una instrucción de control de utilidad TEMPLATE con &SN. o &TS. sin notación de subcadenas, REORG toma las siguientes medidas para los espacios de tabla LOB:

• Crea copias de imágenes en línea
• Restablece el estado COPIA-pendiente

Cuando se especifique implícita o explícitamente AUX YES y se especifiquen plantillas, asegúrese de que dichas plantillas generen nombres de conjuntos de datos únicos para los espacios de tablas auxiliares que se están reorganizando. Asegúrese de tener en cuenta los espacios de las tablas auxiliares que se incluyen en cualquier lista LISTDEF especificada.

Cuando AUX YES se especifica implícita o explícitamente, y se toman copias de imagen de l FlashCopy es como parte de REORG, REORG produce copias de imagen para todos los espacios de tabla LOB que se están reorganizando.

REORG AUX YES no materializa alteraciones pendientes en los espacios de la tabla LOB y sus índices y por lo tanto no reinicia el estado AREOR en estos objetos. Debe ejecutar un REORG separado en el espacio de tabla LOB para materializar estos cambios de definición pendientes.

Restricciones : Cuando se ejecuta REORG con AUX YES en un espacio de tabla de partición por crecimiento con columnas LOB, se aplican las siguientes restricciones:

• Si especifica que REORG debe crear copias en línea y utilizar una plantilla para las copias, no utilice la opción STACK YES para la plantilla. Si lo hace, REORG falla, porque los espacios de las tablas base y auxiliar no se pueden apilar en el mismo volumen de cinta. Si necesita utilizar una plantilla con la opción STACK YES, especifique AUX NO en la instrucción REORG y, a continuación, reorganice y copie los espacios de tabla auxiliares por separado.

FASTSWITCH

Especifica qué metodología de cambio se va a utilizar para una reorganización determinada.

SÍ

Permite que la fase SWITCH utilice la metodología FASTSWITCH. Esta opción no está permitida para el catálogo ( DSNDB06 ) ni para el directorio ( DSNDB01 ).

NO

Hace que la fase SWITCH utilice IDCAMS RENAME.

Cuando se especifica FASTSWITCH NO con SHRLEVEL REFERENCE o SHRLEVEL CHANGE, los cambios de definición pendientes no se materializan.

OFFPOSLIMIT entero

La opción OFFPOSLIMIT está obsoleta y la alternativa es ejecutar DSNACCOX.

Indica que el valor especificado debe compararse con el valor que Db2 se calcula para los índices de agrupación explícitos de cada tabla en las particiones especificadas que están en SYSIBM.SYSINDEXPART. El cálculo se realiza de la siguiente manera:

(NEAROFFPOSF + FAROFFPOSF) × 100 / CARDF 

De forma alternativa, Db2 comprueba los valores en SYSINDEXPART para un único espacio de tabla no particionado, o para cada partición si especificó un espacio de tabla particionado completo como objeto de destino. Si al menos un valor calculado supera el valor OFFPOSLIMIT, se realiza o recomienda REORG. Esta opción es válida únicamente para espacios de tabla que no son LOB.

entero es el valor que se va a comparar y puede variar de 0 a 65535.

El valor por omisión es 10.

INDREFLIMIT entero

La opción INDREFLIMIT está obsoleta y la alternativa es ejecutar DSNACCOX.

Indica que el valor especificado debe compararse con el valor que Db2 calcula para las particiones especificadas en SYSIBM.SYSTABLEPART para el espacio de tabla especificado. El cálculo se realiza de la siguiente manera:

(NEARINDREF + FARINDREF) × 100 / CARDF

Alternativamente, Db2 comprueba los valores en SYSTABLEPART para un único espacio de tabla no particionado, o para cada partición si especificó un espacio de tabla particionado completo como objeto de destino. Si al menos un valor calculado supera el valor calculado supera el valor INDREFLIMIT, se realiza o recomienda REORG. Esta opción es válida únicamente para espacios de tabla que no son LOB.

entero es el valor que se va a comparar y puede variar de 0 a 65535.

El valor por omisión es 10.

REPORTONLY

La opción REPORTONLY está obsoleta y la alternativa es ejecutar DSNACCOX.

Especifica que REORG solo debe recomendarse, no realizarse. REORG genera un informe con uno de los siguientes códigos de devolución:

1

No se ha alcanzado ningún límite; no se debe realizar ni recomendar ninguna REORG.

2

Se va a realizar o recomendar una REORG.

UNLOAD

Especifica si el trabajo de utilidad debe continuar procesándose o finalizar después de descargar los datos. A menos que especifique UNLOAD EXTERNAL, los datos solo pueden recargarse en la misma tabla y espacio de tabla (como se define en el Db2 catálogo) en el mismo subsistema. (Esto no impide la redefinición de VSAM durante la PAUSA DE DESCARGA)

Debe especificar UNLOAD ONLY (solo descarga) para que el conjunto de datos esté en un formato compatible con la opción FORMAT UNLOAD (formato de descarga) de LOAD. Sin embargo, con LOAD, puede cargar los datos solo en el mismo objeto desde el que se descargan.

Esta opción es válida únicamente para espacios de tabla que no son LOB.

Debe especificar UNLOAD EXTERNAL para que el conjunto de datos esté en un formato que pueda ser utilizado por LOAD sin la opción FORMAT UNLOAD. Con UNLOAD EXTERNAL, puede cargar los datos en cualquier tabla con columnas compatibles en cualquier espacio de tabla en cualquier Db2 subsistema.

CONTINUAR

Especifica que, después de que se hayan descargado los datos, la utilidad debe continuar procesando. Se puede llamar a una rutina de edición para decodificar una fila de datos codificada previamente si una clave de índice requiere la extracción de esa fila.

Si especifica DESCARTAR, las filas se descomprimen y las rutinas de edición se decodifican. Si también especifica DESCARTAR en un archivo, las filas se decodifican mediante el procedimiento de campo y las siguientes columnas se convierten a Db2 formato externo:

• SMALLINT
• ENTERO
• FLOAT
• DECIMAL
• HORA
• TIMESTAMP

De lo contrario, las rutinas de edición o los procedimientos de campo se omiten tanto en la fase de DESCARGA como en la de RECARGA para los espacios de tabla. Los procedimientos de validación no se aplican durante ninguna de las dos fases.

PAUSE

La opción DESCARGAR EN PAUSA está obsoleta y la alternativa es ejecutar la utilidad DESCARGAR.

Especifica que, una vez descargados los datos, el procesamiento debe finalizar. La utilidad se detiene y el estado RELOAD se almacena en un SYSIBM.SYSUTIL, de modo que el procesamiento puede reiniciarse con RELOAD RESTART(PHASE).

Esta opción es útil si desea redefinir conjuntos de datos durante la reorganización. Por ejemplo, con un conjunto de datos definido por el usuario, puede:

• Ejecute REORG con la opción UNLOAD PAUSE.
• Redefina el conjunto de datos utilizando los servicios de método de acceso.
• Reinicie REORG volviendo a enviar el trabajo anterior y especificando RESTART(PHASE).

Sin embargo, no puede utilizar DESCARGAR PAUSA si especifica la opción LIST.

ONLY

La opción SOLO DESCARGAR está obsoleta y la alternativa es ejecutar la utilidad DESCARGAR.

Especifica que, después de que se hayan descargado los datos, el trabajo de utilidad finaliza y el estado que corresponde a este ID de utilidad se elimina de SYSIBM.SYSUTIL.

Si especifica UNLOAD ONLY con REORG TABLESPACE, cualquier rutina de edición o procedimiento de campo se ejecuta durante la recuperación de registros en la fase de descarga.

Esta opción no está permitida para ningún espacio de mesa en DSNDB01 o DSNDB06.

Las opciones DESCARTAR y CUANDO no están permitidas con SOLO DESCARGAR.

EXTERNAL

La opción DESCARGAR EXTERNO está obsoleta y la alternativa es ejecutar la utilidad DESCARGAR.

Especifica que, después de que se hayan descargado los datos, el trabajo de utilidad debe finalizar y se elimina el estado que corresponde a este ID de utilidad.

La utilidad UNLOAD tiene más funciones. Si especifica UNLOAD EXTERNAL con REORG TABLESPACE, las filas se descomprimen, las rutinas de edición se decodifican, los procedimientos de campo se decodifican y las columnas SMALLINT, INTEGER, FLOAT, DECIMAL, DATE, TIME y TIMESTAMP se convierten a Db2 formato externo. No se aplican procedimientos de validación.

No especifique la palabra clave EXTERNA para:

• Espacios de mesa en DSNDB01 o DSNDB06
• Tablas base con columnas XML
• Espacios de tablas XML

La opción DESCARTAR no está permitida con DESCARGAR EXTERNO.

NOPAD

Especifica si las columnas de longitud variable en los registros descargados o descartados deben ocupar la longitud real de los datos sin relleno adicional. Los registros descargados pueden tener longitudes variables.

SÍ

Especifica que las columnas de longitud variable no deben tener relleno adicional.

El valor por defecto de NOPAD se establece mediante el parámetro del subsistema REORG_TS_NOPAD_DEFAULT, cuyo valor por defecto es YES.

Información relacionada:

• REORG TS NOPAD DEFAULT (parámetro del subsistema REORG_TS_NOPAD_DEFAULT)

NO

Especifica que REORG procesa las columnas de longitud variable en los registros descargados o descartados hasta su longitud máxima; los registros descargados o descartados tienen la misma longitud para cada tabla.

Puede especificar la opción NOPAD solo con UNLOAD EXTERNAL o con UNLOAD DISCARD.

Aunque la utilidad LOAD procesa registros con columnas de longitud variable que se descargaron o descartaron con la opción NOPAD, estos registros no pueden ser procesados por aplicaciones que procesan solo campos que están en posiciones fijas.

Para que la sentencia LOAD generada proporcione una condición NULLIF para los campos que no están en una posición fija, Db2 genera una definición de campo de entrada con un nombre en forma de DSN_NULL_IND_nnnnn, donde nnnnn es el número de la columna asociada.

El siguiente ejemplo muestra una sentencia LOAD que se generó para la tabla EMPsample :

LOAD DATA INDDN SYSREC   LOG NO  RESUME YES
 EBCDIC CCSID(00500,00000,00000)
 INTO TABLE "DSN8C10 "."EMP               "
 WHEN(00004:00005 = X'0012')
 ( "EMPNO             " POSITION(00007:00012) CHAR(006)
 , "FIRSTNME          " POSITION(00013)       VARCHAR
 , "MIDINIT           " POSITION(*)           CHAR(001)
 , "LASTNAME          " POSITION(*)           VARCHAR
 ,  DSN_NULL_IND_00005  POSITION(*)           CHAR(1)
 , "WORKDEPT          " POSITION(*)           CHAR(003)
                          NULLIF(DSN_NULL_IND_00005)=X'FF'
 ,  DSN_NULL_IND_00006  POSITION(*)           CHAR(1)
 , "PHONENO           " POSITION(*)           CHAR(004)
                          NULLIF(DSN_NULL_IND_00006)=X'FF'
 ,  DSN_NULL_IND_00007  POSITION(*)           CHAR(1)
 , "HIREDATE          " POSITION(*)           DATE EXTERNAL
                          NULLIF(DSN_NULL_IND_00007)=X'FF'
 ,  DSN_NULL_IND_00008  POSITION(*)           CHAR(1)
 , "JOB               " POSITION(*)           CHAR(008)
                          NULLIF(DSN_NULL_IND_00008)=X'FF'
 ,  DSN_NULL_IND_00009  POSITION(*)           CHAR(1) 
 , "EDLEVEL           " POSITION(*)           SMALLINT
                          NULLIF(DSN_NULL_IND_00009)=X'FF'
 ,  DSN_NULL_IND_00010  POSITION(*)           CHAR(1)
 , "SEX               " POSITION(*)           CHAR(001)
                          NULLIF(DSN_NULL_IND_00010)=X'FF'
 ,  DSN_NULL_IND_00011  POSITION(*)           CHAR(1)
 , "BIRTHDATE         " POSITION(*)           DATE EXTERNAL
                          NULLIF(DSN_NULL_IND_00011)=X'FF'
 ,  DSN_NULL_IND_00012  POSITION(*)           CHAR(1)
 , "SALARY            " POSITION(*)           DECIMAL
                          NULLIF(DSN_NULL_IND_00012)=X'FF'
 ,  DSN_NULL_IND_00013  POSITION(*)           CHAR(1)
 , "BONUS             " POSITION(*)           DECIMAL
                          NULLIF(DSN_NULL_IND_00013)=X'FF'
 ,  DSN_NULL_IND_00014  POSITION(*)           CHAR(1)
 , "COMM              " POSITION(*)           DECIMAL
                          NULLIF(DSN_NULL_IND_00014)=X'FF'
 )

FROM TABLE

Especifica las tablas que se van a reorganizar. El espacio de tabla que se especifica en REORG TABLESPACE puede almacenar más de una tabla. Todas las tablas que se especifican mediante sentencias FROM TABLE deben ser únicas. Todas las mesas se descargan para DESCARGAR EXTERIOR, y todas las mesas pueden estar sujetas a DESCARTAR. Si especifica UNLOAD EXTERNAL y desea limitar las tablas y filas que se descargan, especifique FROM TABLE con la opción WHEN. Si especifica DESCARTAR, debe calificar las filas que desea descartar especificando DESDE TABLA con la opción CUANDO.

No especifique FROM TABLE con REORG TABLESPACE LIST.

nombre-tabla

Especifica el nombre de la tabla que debe ser calificada por la siguiente cláusula WHEN. La tabla debe describirse en el catálogo y no debe ser una tabla de catálogo.

Si el nombre de la tabla no está calificado por un nombre de esquema, el ID de autorización de la persona que invoca el paso de trabajo de la utilidad se utiliza como calificador de esquema del nombre de la tabla. Encierre el nombre de tabla entre comillas si la tabla contiene un espacio en blanco.

WHEN

Indica qué registros del espacio de tabla se van a descargar (para DESCARGAR EXTERNO) o descartar (para DESCARTAR). Si no se especifica una cláusula WHEN para una tabla en el espacio de tablas, se descargan todos los registros (para UNLOAD EXTERNAL) o no se descarta ninguno de los registros (para DISCARD).

La opción que sigue a CUANDO describe las condiciones para DESCARGAR o DESECHAR registros de una tabla y debe ir entre paréntesis.

condición de selección

Especifica una condición que es verdadera, falsa o desconocida sobre una fila específica. Cuando la condición es verdadera, la fila cumple los requisitos para DESCARGAR o DESCARTAR. Cuando la condición es falsa o desconocida, la fila no cumple los requisitos.

Una condición de selección consta de al menos un predicado y cualquier operador lógico (AND, OR, NOT). El resultado de una condición de selección se obtiene aplicando los operadores lógicos especificados al resultado de cada predicado especificado. Si no se especifican operadores lógicos, el resultado de la condición de selección es el resultado del predicado especificado.

Las condiciones de selección entre paréntesis se evalúan primero. Si el orden de evaluación no se especifica entre paréntesis, se aplica AND antes de OR.

Si la sentencia de control está en el mismo esquema de codificación que los datos de entrada, puede codificar constantes de caracteres en la sentencia de control. De lo contrario, si la instrucción de control no está en el mismo esquema de codificación que los datos de entrada, debe codificar la condición con constantes hexadecimales.

Si se utiliza el carácter comodín ' %' i s, el valor hexadecimal del carácter comodín debe estar en EBCDIC. Por ejemplo, en la siguiente sentencia, x'41' significa 'A' en UNICODE y ASCII y x'6C' significa '%' en EBCDIC: COL1 LIKE X'416C'.

Si la tabla de destino es ASCII, cualquier carácter constante debe especificarse en hexadecimal. Por ejemplo, si el espacio de la tabla está en EBCDIC y la instrucción de control está en UTF-8, utilice (1:1)=X' F1 ' en la condición en lugar de (1:1)='1'.

Restricción : REORG TABLESPACE no puede filtrar filas basadas en datos cifrados a nivel de columna.

predicado

Un predicado especifica una condición que es verdadera, falsa o desconocida sobre una fila o grupo determinado.

predicado básico

Especifica la comparación de una columna con una constante. Si el valor de la columna es nulo, el resultado del predicado es desconocido. De lo contrario, el resultado del predicado es verdadero o falso.

Predicado

Es verdadero si y solo si

column-name = constante

La columna es igual a la expresión de duración constante o etiquetada.

nombre-columna < > constante

La columna no es igual a la constante o a la expresión de duración etiquetada.

nombre-columna > constante

La columna es mayor que la constante o la expresión de duración etiquetada

nombre-columna < constante

La columna es menor que la constante o la expresión de duración etiquetada.

nombre-columna > = constante

La columna es mayor o igual que la expresión de duración constante o etiquetada.

nombre-columna < = constante

La columna es menor o igual que la expresión de duración constante o etiquetada.

Operadores de comparación : Las siguientes formas de los operadores de comparación también son compatibles en predicados básicos y cuantificados:!=,!< y!>, donde! significa que no. Además, en las páginas de códigos 437, 819 y 850, se admiten las formas ¬=, ¬< y ¬>. Todas estas formas específicas de producto de los operadores de comparación están pensadas únicamente para respaldar las sentencias REORG existentes que utilizan estos operadores y no se recomienda su uso en nuevas sentencias REORG.

Un signo no (¬), o el carácter que debe utilizarse en su lugar en ciertos países, puede causar errores de análisis en las sentencias que se pasan de un DBMS a otro. El problema se produce si el estado sufre una conversión de caracteres con ciertas combinaciones de CCSID de origen y destino. Para evitar este problema, sustituya cualquier operador que incluya un signo not por un operador equivalente. Por ejemplo, sustituya «< >» por «¬=», «<=' por «¬>» y «>=' por «¬<».

ENTRE predicado

Indica si un valor dado está entre otros dos valores dados que se especifican en orden ascendente. Cada una de las dos formas del predicado (BETWEEN y NOT BETWEEN) tiene una condición de búsqueda equivalente, como se muestra en la siguiente tabla. Si procede, la tabla también muestra cualquier predicado equivalente.

Tabla 1. ENTRE los predicados y sus condiciones de búsqueda equivalentes

Predicado	Predicado equivalente	Condición de búsqueda equivalente
columna ENTRE value1 Y value2	Ninguno	(columna >= value1 Y columna <= value2 )
columna NO ENTRE value1 Y value2	NOT(columna ENTRE value1 Y value2 )	(columna < value1 O columna > value2 )
Nota : Los valores pueden ser constantes o expresiones de duración etiquetadas.

Por ejemplo, el siguiente predicado es verdadero para cualquier fila cuando el salario es mayor o igual a 10 000 y menor o igual a 20 000:

SALARY BETWEEN 10000 AND 20000

etiquetado-duración-expresión

Especifica una expresión que comienza con los siguientes valores de registro especiales:

• FECHA ACTUAL (se acepta CURRENT_DATE)
• FECHA Y HORA ACTUALES (se acepta CURRENT_TIMESTAMP)

Opcionalmente, la expresión contiene las operaciones aritméticas de suma o resta, expresadas por un número seguido de una de las siete palabras clave de duración:

• AÑOS (o AÑO)
• MESES (o MES)
• DÍAS (o DÍA)
• HORAS (o HORA)
• MINUTOS (o MINUTO)
• SEGUNDOS (o SEGUNDO)
• MICROSEGUNDOS (o MICROSECONDO)

Las utilidades evalúan una expresión de duración etiquetada como una marca de tiempo y realizan implícitamente una conversión a una fecha si la comparación es con una columna de fecha.

Incrementar y disminuir FECHA ACTUAL : El resultado de sumar una duración a una fecha, o de restar una duración de una fecha, es en sí mismo una fecha. (En esta operación, un mes equivale a una página de un calendario. La adición de meses a una fecha es como ir pasando páginas a un calendario, empezando por la página en la que aparece la fecha.) El resultado debe estar comprendido entre las fechas 1 de enero de 0001 y 31 de diciembre de 9999, ambos inclusive.

La siguiente tabla describe los efectos de sumar y restar años, meses, días y otras fechas.

Tabla 2. Efectos de sumar y restar duraciones a la FECHA ACTUAL

Valor que se suma o se resta	Efecto
Años	Añadir o restar una duración de años afecta solo a la parte del año de la fecha. Tanto el mes como el día permanecen inalterados, a no ser que el resultado fuera el 29 de febrero en un año no bisiesto. En este caso, la parte del día del resultado se establece en 28.
Meses	Añadir o restar una duración de meses afecta solo a los meses y, si es necesario, a los años. La parte del día de la fecha no cambia, a menos que ese día no exista en el mes resultante. (31 de septiembre, por ejemplo). En este caso, el día se establece como el último día del mes. Añadir un mes a una fecha da el mismo día un mes después, a menos que ese día no exista en el mes posterior. En ese caso, el día del resultado se establece como el último día del mes posterior. Por ejemplo, el 28 de enero más un mes da como resultado el 28 de febrero; un mes añadido al 29, 30 o 31 de enero da como resultado el 28 de febrero o, en caso de año bisiesto, el 29 de febrero. Si se añade uno o más meses a una fecha determinada y del resultado se resta la misma cantidad de meses, la fecha final no tiene por qué ser necesariamente la misma que la original.
Días	Añadir o restar una duración de días afecta a la parte del día de la fecha y, potencialmente, al mes y al año.
Fechas	Cuando se añade una duración de fecha positiva a una fecha, o se resta una duración de fecha negativa de una fecha, la fecha se incrementa en el número especificado de años, meses y días. Cuando se resta una duración de fecha positiva de una fecha, o se añade una duración de fecha negativa a una fecha, la fecha se reduce en el número especificado de días, meses y años.

El orden en el que se suman y restan las duraciones de las fechas etiquetadas puede afectar a los resultados. Cuando añada duraciones de fechas etiquetadas a una fecha, especifíquelas en el orden AÑOS + MESES + DÍAS. Cuando restes duraciones de fechas etiquetadas de una fecha, especifícalas en el orden DÍAS - MESES - AÑOS. Por ejemplo, para añadir un año y un día a una fecha, especifique el siguiente código:

CURRENT DATE + 1 YEAR + 1 DAY

Para restar un año, un mes y un día de una fecha, especifique el siguiente código:

CURRENT DATE - 1 DAY - 1 MONTH - 1 YEAR

Incrementar y disminuir marcas de tiempo : El resultado de sumar una duración a una marca de tiempo, o de restar una duración de una marca de tiempo, es en sí mismo una marca de tiempo. La aritmética de fecha y hora se realiza como se ha definido anteriormente, excepto que un desbordamiento o desbordamiento por defecto de horas se lleva a la parte de fecha del resultado, que debe estar dentro del rango de fechas válidas. Por ejemplo, si la fecha actual es el 15 de enero y la hora actual es las 20:00, CURRENT_TIMESTAMP+8 HOURS da como resultado el 16 de enero a las 04:00. Del mismo modo, CURRENT_TIMESTAMP-22 HOURS da como resultado 14 de enero, 22:00.

EN predicado

Especifica que un valor debe compararse con un conjunto de valores. En el predicado IN, el segundo operando es un conjunto de uno o más valores que se especifican mediante constantes. Cada una de las dos formas del predicado (IN y NOT IN) tiene una condición de búsqueda equivalente, como se muestra en la siguiente tabla.

Tabla 3. IN predicados y sus condiciones de búsqueda equivalentes

Predicado	Condición de búsqueda equivalente
value1 IN ( value1, value2,..., valuen )	( value1 = value2 O. O value1 = valor n )
value1 NO EN ( value1, value2..., valuen )	value1 ¬= value2 Y. Y value1 ¬= valor )
Nota : Los valores pueden ser constantes o expresiones de duración etiquetadas.

Por ejemplo, el siguiente predicado es verdadero para cualquier fila con un empleado en el departamento D11, B01, o C01:

WORKDEPT IN ('D11', 'B01', 'C01')

Especificar demasiados valores en el predicado IN puede degradar significativamente el rendimiento de la utilidad. El número exacto puede variar; sin embargo, en general, especificar 2500 o más valores puede empezar a afectar al rendimiento.

Predicado LIKE

Califica cadenas que tienen un cierto patrón. Especifique el patrón utilizando una cadena en la que los caracteres de subrayado y signo de porcentaje se pueden utilizar como caracteres comodín. El carácter de subrayado (_) representa un carácter único y arbitrario. El signo de porcentaje (%) representa una cadena de cero o más caracteres arbitrarios.

En esta descripción, x denota la columna que se va a probar e y denota el patrón en la constante de cadena.

Las siguientes reglas se aplican a los predicados de la forma x LIKE y.... Si se especifica NOT, el resultado se invierte.

• Cuando x o y son nulos, el resultado del predicado es desconocido.
• Cuando y está vacío y x no está vacío, el resultado del predicado es falso.
• Cuando x está vacío y y no está vacío, el resultado del predicado es falso a menos que y consista solo en uno o más signos de porcentaje.
• Cuando x e y están vacíos, el resultado del predicado es verdadero.
• Cuando x e y no son nulos, el resultado del predicado es verdadero si x coincide con el patrón en y y falso si x no coincide con el patrón en y.

La cadena de patrón y la cadena que se va a probar deben ser del mismo tipo; es decir, tanto x como y deben ser cadenas de caracteres, o ambas x e y deben ser cadenas gráficas. Cuando x e y son cadenas gráficas, un carácter es un carácter DBCS. Cuando x e y son cadenas de caracteres y x no son datos mixtos, un carácter es un carácter SBCS, e y se interpreta como datos SBCS independientemente de su subtipo.

Dentro del patrón, un signo de porcentaje (%) o un carácter de subrayado (_) pueden representar la aparición literal de un signo de porcentaje o un carácter de subrayado. Para tener un significado literal, cada carácter debe ir precedido de un carácter de escape.

La cláusula de EXENCIÓN designa a un solo personaje. Puede utilizar ese carácter, y solo ese carácter, varias veces dentro del patrón como carácter de escape. Cuando se omite la cláusula ESCAPE, ningún carácter sirve como carácter de escape y los signos de porcentaje y los guiones bajos en el patrón solo pueden utilizarse para representar caracteres arbitrarios; no pueden representar sus apariciones literales.

Las siguientes reglas se aplican al uso de la cláusula de EXENCIÓN:

• La cláusula ESCAPE no puede utilizarse si x son datos mixtos.
• Si x es una cadena de caracteres, el tipo de datos de la constante de cadena debe ser cadena de caracteres. Si x es una cadena gráfica, el tipo de datos de la constante de cadena debe ser cadena gráfica. En ambos casos, la longitud de la constante de cadena debe ser 1.
• El patrón no debe contener el carácter de escape, excepto cuando vaya seguido del carácter de escape «%» o «_». Por ejemplo, si «+» es el carácter de escape, cualquier aparición de «+» que no sea «++», «+_» o «+ %' i n el patrón es un error.

Cuando ese patrón no incluye caracteres de escape, una descripción simple de su significado es:

• El carácter de subrayado (_) representa un carácter único y arbitrario.
• El signo de porcentaje (%) representa una cadena de cero o más caracteres arbitrarios.
• Cualquier otro carácter representa una aparición individual del propio carácter.

Cadenas y patrones:

La cadena y se interpreta como una secuencia del número mínimo de especificadores de subcadenas, de modo que cada carácter de y forma parte de exactamente un especificador de subcadenas. Un especificador de subcadena es un guión bajo, un signo de porcentaje o cualquier secuencia de caracteres no vacía que no sea un guión bajo o un signo de porcentaje.

La cadena x coincide con el patrón y si existe una partición de x en subcadenas, de modo que:

• Una subcadena de x es una secuencia de cero o más caracteres contiguos, y cada carácter de x forma parte de exactamente una subcadena.
• Si el enésimo especificador de subcadena es un guión bajo, la enésima subcadena de x es cualquier carácter individual.
• Si el enésimo especificador de subcadena es un signo de porcentaje, la enésima subcadena de x es cualquier secuencia de cero o más caracteres.
• Si el enésimo especificador de subcadena no es ni un guión bajo ni un signo de porcentaje, la enésima subcadena de x es igual a ese especificador de subcadena y tiene la misma longitud que ese especificador de subcadena.
• El número de subcadenas de x es el mismo que el número de especificadores de subcadenas.

Cuando hay caracteres de escape en la cadena de patrón, un guión bajo, un signo de porcentaje o un carácter de escape representa una sola aparición de sí mismo si y solo si va precedido de un número impar de caracteres de escape sucesivos.

La forma en que se empareja un patrón para evaluar el predicado LIKE depende de si los espacios en blanco al final de las cadenas de longitud fija son significativos o si se ignoran. Cuando el parámetro del subsistema LIKE_BLANK_INSIGNIFICANT está habilitado, el predicado LIKE puede producir resultados diferentes.

Patrones de datos mixtos:

Si x son datos mixtos, se asume que el patrón es de datos mixtos y sus caracteres especiales se interpretan de la siguiente manera:

• Un guión bajo de un solo byte se refiere a un carácter de un solo byte; un guión bajo de doble byte se refiere a un carácter de doble byte.
• Un signo de porcentaje, ya sea de un byte o de dos bytes, se refiere a cualquier número de caracteres de cualquier tipo, ya sea de un byte o de dos bytes.
• Los bytes de desplazamiento redundantes en x o y se ignoran.

Información relacionada:

• Predicado de LIKE

Predicado NULL

Especifica una prueba para valores nulos.

Si el valor de la columna es nulo, el resultado es verdadero. Si el valor no es nulo, el resultado es falso. Si se especifica NOT, el resultado se invierte.

KEEPDICTIONARY

Evita que REORG TABLESPACE cree un nuevo diccionario de compresión al descargar las filas. La utilidad REORG crea el diccionario de compresión durante el proceso UNLOAD. Este diccionario se utiliza durante la fase de RECARGA para comprimir los datos.

La eficiencia de REORG aumenta con la opción KEEPDICTIONARY por las siguientes razones:

• Se elimina el coste de procesamiento de la creación del diccionario de compresión.
• Las filas comprimidas existentes no necesitan comprimirse de nuevo.
• No es necesario expandir las filas comprimidas existentes, a menos que los índices lo requieran o se utilice SORTDATA.

KEEPDICTIONARY sólo es válido si existe un diccionario de compresión y el espacio de tabla o partición que se está reorganizando está definido con compresión. Si no existe un diccionario, se crea uno, se emite un mensaje de advertencia y se comprimen todos los registros.

Las posibles razones para no especificar KEEPDICTIONARY son:

• Si los datos han cambiado significativamente desde que se creó el último diccionario, reconstruirlo podría ahorrar una cantidad significativa de espacio.
• Si el diccionario actual se creó con la utilidad LOAD o automáticamente con Db2 basado en registros que se han insertado con el tiempo, reconstruir el diccionario mediante REORG podría producir un diccionario de compresión mejor.

En las siguientes situaciones, KEEPDICTIONARY se ignora y REORG siempre crea un nuevo diccionario de compresión:

• Si los datos se están convirtiendo de un formato de fila básico a un formato de fila reordenado
• Si REORG está materializando una alteración pendiente del búfer
• Si una partición que se está reorganizando está en estado REORG-pending (pendiente de reorganización)
• FL 508 Si REORG está materializando una operación MOVE TABLE pendiente

Mensajes DSNU234I y DSNU244I, que muestran estadísticas de compresión, no se emiten cuando se especifica REORG UNLOAD CONTINUE KEEPDICTIONARY o REORG UNLOAD PAUSE KEEPDICTIONARY.

Nota : Debe utilizar KEEPDICTIONARY para asegurarse de que se mantiene el diccionario de compresión.

Información relacionada:

• Compresión de datos con el programa de utilidad LOAD

STATISTICS

Especifica que se deben recopilar estadísticas para el espacio de tabla o el índice asociado, o ambos; las estadísticas se informan o almacenan en el Db2 catálogo. Si las estadísticas se recopilan con las opciones predeterminadas, sólo se actualizan las estadísticas para el espacio de tabla.

Si especifica una partición de espacio de tabla o un rango de particiones junto con la palabra clave STATISTICS, Db2 recoge estadísticas solo para las particiones de espacio de tabla especificadas. Esta opción es válida únicamente para espacios de tabla que no son LOB.

Si especifica un espacio de tabla base con la palabra clave STATISTICS, DB2 no recopila estadísticas para el espacio de tabla XML relacionado o sus índices.

Cuando se especifica SORTNPSI AUTO o SORTNPSI YES, o cuando el parámetro de subsistema REORG_PART_SORT_NPSI se establece en AUTO o YES, REORG TABLESPACE PART puede recopilar estadísticas para un índice secundario no particionado cuando se especifican también las palabras clave STATISTICS INDEX. Sin embargo, en alguno de estos casos, REORG no recopila estadísticas. Esta situación se produce si REORG elige no ordenar todas las claves de índice no particionado, porque la cantidad de datos a reorganizar o los tamaños de los objetos superan los umbrales internos.

Restricciones:

• Si especifica STATISTICS para datos cifrados, es posible que DB2 no proporcione estadísticas útiles sobre estos datos.
• No puede especificar STATISTICS si especifica la palabra clave CLONE.

Cuando los cambios de definición pendientes se materializan durante REORG TABLESPACE con SHRLEVEL REFERENCE o CHANGE, las estadísticas tanto de un espacio de tabla como de sus índices asociados se recopilan y actualizan en el Db2 catálogo. En este caso, si la palabra clave STATISTICS no se especifica en la instrucción REORG TABLESPACE, se utilizan las siguientes palabras clave por defecto:

• STATISTICS TABLE ALL
• INDEX ALL
• UPDATE ALL
• HISTORY ALL

Para obtener más información sobre cómo materializar cambios de definición pendientes durante REORG, consulte Reorganización con cambios de definición pendientes.

Recomendación : Las estadísticas de partición pueden quedar obsoletas. Las estadísticas de partición que se vuelven obsoletas son las estadísticas COLGROUP, estadísticas para valores de columna clave en índices, estadísticas HISTOGRAM, estadísticas de frecuencia con NUMCOLS > 1 y estadísticas para índices ampliados donde se pueda aplicar. Ejecute el programa de utilidad RUNSTATS para recopilar estadísticas de partición de nuevo.

Todas las tablas identificadas por la palabra clave STATISTICS TABLE deben pertenecer al espacio de tabla especificado en la opción TABLESPACE.

TABLE

Especifica la tabla para la que se va a recopilar información de columna.

No especifique STATISTICS TABLE nombre_tabla con la palabra clave LIST. En lugar de eso, especifique STATISTICS TABLE (ALL).

(TODOS)

Especifica qué información se va a recopilar para todas las columnas de todas las tablas del espacio de tabla.

Cuando se especifica REORG TABLESPACE STATISTICS TABLE ALL INDEX ALL, se recopilan todas las estadísticas del espacio de tabla, la tabla y los índices tanto a nivel de partición como a nivel agregado.

(nombre-de-la-tabla )

Especifica las tablas para las que se va a recopilar la información de columna. Si omite el calificador, se utiliza el identificador de usuario para el trabajo de utilidad. Encierre el nombre de tabla entre comillas si la tabla contiene un espacio en blanco.

Si especifica más de una tabla, debe repetir la opción TABLE. Se deben especificar varias opciones TABLE completamente antes o después de cualquier palabra clave INDEX que se especifique. Por ejemplo, la palabra clave INDEX puede que no se especifique entre dos palabras clave TABLE.

SAMPLE entero

Indica el porcentaje de filas que hay de ejemplo al recopilar estadísticas en columnas no indexadas iniciales de un índice o columnas no indexadas. Puede especificar cualquier valor de 1 a 100.

El valor predeterminado es 25. La opción SAMPLE no se permite para espacios de tabla LOB.

USE PROFILE

Especifica un perfil de estadísticas almacenado que se utiliza para recopilar estadísticas para una tabla. El perfil de estadísticas se crea utilizando la opción SET PROFILE y se actualiza utilizando la opción UPDATE PROFILE.

La columna, grupo de columnas o especificaciones de índice no se permiten como parte de la sentencia de control, pero se utilizan cuando se almacenan en el perfil de estadísticas.

Si no existe un perfil para la tabla especificada, se recopilan estadísticas predeterminadas:

• Si no se especifica un nombre de tabla, se utiliza TABLE ALL INDEX ALL para la especificación de perfil.
• Cuando se especifica un nombre de tabla, se utiliza COLUMN ALL INDEX ALL para la especificación de perfil.

Cuando se especifica USE PROFILE, las opciones de perfil se incluyen en SYSPRINT en el mensaje DSNU1376I.

FL 507 Además, Db2 borra las estadísticas existentes que no están incluidas en el perfil. Todas las estadísticas de frecuencia, tarjetas de acceso e histogramas que no formen parte del perfil se eliminan del catálogo. Estas estadísticas se eliminan solo para la tabla o partición especificada. Las estadísticas no se eliminan de las tablas del historial del catálogo. Si especifica ACTUALIZAR NINGUNO o ACTUALIZAR ESPACIO, no se borrará ninguna estadística.

Información relacionada:

• Perfiles de estadísticas
• Creación de perfiles de estadísticas
• Sintaxis de perfil de estadísticas

COLUMN

Especifica columnas para las que se va a recopilar información.

Puede especificar esta opción sólo si especifica una tabla concreta para la que se van a recopilar las estadísticas (TABLE (nombre_tabla)). Si especifica tablas concretas y no especifica la opción COLUMN, se utiliza el valor predeterminado, COLUMN(ALL). Si no especifica una tabla concreta cuando utiliza la opción TABLE, no puede utilizar la opción COLUMN; sin embargo, se presupone COLUMN(ALL).

(ALL)

Especifica qué estadísticas se van a recopilar para todas las columnas de la tabla.

(nombre de la columna,...)

Especifica columnas para las que se van a recopilar estadísticas.

Puede especificar una lista de nombres de columna; el máximo es 10. Si especifica más de una columna, separe cada nombre con una coma.

INDEX

Especifica los índices para los que se reunirá información. Se reúne información de columna para la primera columna del índice. Todos los índices deben estar asociados al espacio de tabla, que debe ser el espacio de tabla especificado en la opción TABLESPACE.

No especifique STATISTICS INDEX nombre_índice con la palabra clave LIST. En lugar de eso, especifique STATISTICS INDEX (ALL).

(TODOS)

Especifica qué información de columna se va a recopilar para todos los índices definidos en tablas contenidas en el espacio de tabla.

Cuando se especifica REORG TABLESPACE STATISTICS TABLE ALL INDEX ALL, se recopilan todas las estadísticas del espacio de tabla, la tabla y los índices tanto a nivel de partición como a nivel agregado.

(nombre-índice )

Especifica los índices para los que se va a recopilar información. Encierre el nombre de índice entre comillas si el nombre contiene un espacio en blanco.

COLGROUP (nombre de columna, ... )

Indica que el conjunto de columnas especificado se trata como un grupo. Esta opción permite a las estadísticas en línea recopilar un valor de cardinalidad en el grupo de columnas especificado. Las estadísticas en línea ignoran COLGROUP al procesar índices y espacios de tabla XML.

Cuando especifica la palabra clave COLGROUP, las estadísticas en línea recopilan estadísticas de correlación para el grupo de columnas especificado. Si desea estadísticas en línea para recopilar estadísticas de distribución, especifique la opción FREQVAL con COLGROUP.

(nombre de la columna, ... ) especifica los nombres de las columnas que son parte del grupo de columnas.

Cuando se define un grupo de columnas en una sola columna, se puede mejorar potencialmente el rendimiento de RUNSTATS especificando la opción STATCLGMEMSRT o cambiando el valor del parámetro del subsistema STATCLGSRT. Puede utilizar estas opciones para evitar la ordenación por grupos de columnas mediante programas de ordenación externos.

Para especificar más de un grupo de columnas, repita la opción COLGROUP.

Restricción : La longitud del valor COLGROUP no puede exceder la longitud máxima de la columna COLVALUE en la tabla de catálogo de SYSIBM.SYSCOLDIST.

Información relacionada:

• Campo STATISTICS COLGROUP DATA SORT STG LIMIT (parámetro de subsistema STATCLGSRT)

FREQVAL

Indica, cuando se especifica con la opción COLGROUP, que las estadísticas de frecuencia también se van a recopilar para los grupos de columnas especificados. (COLGROUP indica que se recopilan estadísticas de cardinalidad.) Se recopila un grupo de estadísticas para cada columna. Debe especificar COUNT entero con COLGROUP FREQVAL. La utilidad ignora FREQVAL MOST/LEAST/BOTH al procesar espacios de tablas XML.

COUNTentero

Indica el número de valores que se producen con frecuencia que deben recopilarse desde el grupo de columnas especificado. Por ejemplo, COUNT 20 significa que DB2 recopila 20 valores que se dan frecuentemente desde el grupo de columnas. Cuando no se especifica la palabra clave COUNT, la utilidad determina automáticamente el valor de recuento y recopila los valores más frecuentes. Especificar un valor de 1000 o más puede aumentar el tiempo de preparación de algunas sentencias SQL. Además, especificar un valor de COUNT muy grande utilizará una gran cantidad de almacenamiento, lo que puede causar restricciones de almacenamiento durante la ejecución de la utilidad en objetos particionados con cientos de particiones.

MOST

Indica que el programa de utilidad va a recopilar los valores que se dan con más frecuencia para el conjunto de columnas especificado cuando se especifica COLGROUP.

BOTH

Indica que el programa de utilidad va a recopilar los valores que se dan con más y menos frecuencia para el conjunto de columnas especificado cuando se especifica COLGROUP.

LEAST

Indica que el programa de utilidad va a recopilar los valores que se dan con menos frecuencia para el conjunto de columnas especificado cuando se especifica COLGROUP.

HISTOGRAM

Indica, cuando se especifica con la opción COLGROUP, que las estadísticas de histograma también se van a recopilar para el grupo de columnas especificados. Las estadísticas en línea ignoran HISTOGRAM al procesar índices y espacios de tabla XML.

Las estadísticas de histograma que recopila a través de estadísticas en línea no son las mismas estadísticas de histograma que recopila a través de RUNSTATS. Las estadísticas de histograma que recopila con estadísticas en línea sólo son estimaciones aproximadas. Para obtener estadísticas más exactas, utilice RUNSTATS.

NUMQUANTILES entero

Indica los cuantiles que recopila el programa de utilidad. El valor entero debe ser mayor que o igual a uno. El número de cuantiles que especifica nunca debe superar el número total de los distintos valores de la columna o del grupo de columnas. El número máximo de cuantiles es 100.

Cuando se omite la palabra clave NUMQUANTILES, NUMQUANTILES toma el valor predeterminado de 100. En base al número de registros de la tabla, el número de cuantiles se reajusta a la baja a un número óptimo.

KEYCARD

La opción KEYCARD está en desuso en la sentencia de control del programa de utilidad y ya no necesita especificarse para recopilar estadísticas de cardinalidad en los valores de las columnas clave de un índice.

Cuando se especifican las opciones STATISTICS e INDEX, el programa de utilidad siempre recopila todos los valores distintos en todas las combinaciones de columna clave de 1 a n en un índice.n es el número de columnas del índice. Con el desuso de KEYCARD, esta funcionalidad no se puede inhabilitar.

El programa de utilidad tolera la especificación de la opción KEYCARD. El programa de utilidad no emite mensajes si la sentencia de control incluye o excluye la opción KEYCARD cuando se especifica STATISTICS e INDEX.

FREQVAL

Controla la recopilación de estadísticas de valores frecuentes. Si especifica FREQVAL, debe ir seguida de la palabra clave NUMCOLS

NUMCOLS

Indica el número de columnas clave que se van a concatenar al recopilar valores frecuentes del índice especificado. Especificar '3' significa que los valores frecuentes se van a recopilar en la concatenación de las tres primeras columnas clave. El valor predeterminado es 1, que significa que DB2 recopila valores frecuentes en la primera columna clave del índice.

COUNT

Indica el número de valores frecuentes que se van a recopilar. Especificar '15' significa que DB2 recopila 15 valores frecuentes de las columnas clave especificadas. Si no se especifica la palabra clave COUNT, Db2 recopila estadísticas para un número determinado automáticamente de valores que se producen con frecuencia.

HISTOGRAM

Indica que se solicitan las estadísticas de histograma para el índice especificado.

NUMCOLS

El número de columnas clave que se van a concatenar al recopilar estadísticas de histograma del índice especificado.

NUMQUANTILES

Los valores enteros que siguen a NUMQUANTILES indican el número de cuantiles que se han solicitado. El valor entero debe ser mayor que o igual a 1.

Las estadísticas de histograma se pueden recopilar únicamente en claves con el mismo orden. Si las columnas clave especificadas para las estadísticas de histograma son de orden mezclado, se emite un mensaje de aviso DSNU633I.

Información relacionada:

• Estadísticas de histograma
• DSNU633I

REPORT

Especifica si se va a generar un conjunto de mensajes para informar de las estadísticas recopiladas.

NO

Indica que el conjunto de mensajes no se va a enviar como salida para SYSPRINT.

YES

Indica que el conjunto de mensajes debe enviarse como salida a SYSPRINT. Los mensajes generados dependen de la combinación de palabras clave (como TABLESPACE, INDEX, TABLE y COLUMN) que se especifica con el programa de utilidad RUNSTATS. Sin embargo, estos mensajes no dependen de la especificación de la opción UPDATE. REPORT YES siempre genera un informe de las estadísticas de SPACE y ACCESSPATH.

UPDATE

Indica si las estadísticas recopiladas se van a insertar en las tablas de catálogo. UPDATE también le permite seleccionar estadísticas que utiliza para las estadísticas o selección de vía de acceso que utilizan los administradores de base de datos.

TODOS

Indica que todas las estadísticas recopiladas se van a actualizar en el catálogo.

ACCESSPATH

Indica que las únicas columnas de la tabla de catálogo que se van a actualizar son las que proporcionan estadísticas que se utilizan para la selección de vía de acceso.

SPACE

Indica que las únicas columnas de la tabla de catálogo que se van a actualizar son las que proporcionan estadísticas para ayudar a los administradores de base de datos a evaluar el estado de un índice o espacio de tabla particular.

NONE

Indica que las tablas de catálogo no se van a actualizar con las estadísticas recopiladas. Esta opción es válida sólo cuando se especifica REPORT YES.

STATCLGMEMSRT entero

Especifica la cantidad de memoria que la utilidad puede utilizar para ordenar los registros al recopilar estadísticas sobre una única columna definida con la opción COLGROUP. Utilice STATCLGMEMSRT para evitar que un programa de clasificación externo clasifique grupos de columnas, lo que puede afectar negativamente al rendimiento de la recopilación de estadísticas.

el número entero especifica la cantidad de megabytes de espacio de memoria que la utilidad puede usar para una clasificación en memoria. Si la cantidad de espacio que se necesita para la clasificación excede el valor entero, la utilidad invoca un programa de clasificación. Si especifica 0, la utilidad invoca automáticamente un programa de clasificación.

La cantidad de espacio que se necesita para la clasificación del grupo de columnas depende de los siguientes factores:

• El número de grupos de columnas para los que la utilidad está recopilando estadísticas
• La longitud del grupo de columnas de una sola columna
• El número de valores distintos en la columna (cardinalidad)

El valor de STATCLGMEMSRT anula el valor del parámetro del subsistema STATCLGSRT.

Información relacionada:

• Campo STATISTICS COLGROUP DATA SORT STG LIMIT (parámetro de subsistema STATCLGSRT)

INVALIDATECACHE

Indica si las sentencias de la memoria caché de la sentencia dinámica se invalida como resultado de la recopilación de estadísticas en línea. Esta opción no impide que el programa de utilidad invalide las sentencias almacenadas en memoria caché por otros motivos.

YES

Las sentencias de las memoria caché dinámica se invalidan para los objetos especificados en la sentencia de trabajo.

NO

La recopilación de estadísticas en línea no invalidan las sentencias de la memoria caché dinámica para los objetos especificados en la sentencia de trabajo. Sin embargo, el programa de utilidad puede invalidar las sentencias almacenadas en memoria caché por motivos distintos a las estadísticas en línea, como cuando el programa de utilidad resuelve objetos en estados restringidos o aplica operaciones ALTER pendientes.

HISTORY

Especifica que se deben registrar todas las inserciones de tablas de catálogo o actualizaciones de las tablas de historial de catálogo.

El valor predeterminado es el valor especificado en el campo HISTORIAL DE ESTADÍSTICAS en el panel DSNTIP6.

ALL

Indica que todas las estadísticas recopiladas se van a actualizar en las tablas de historial de catálogo.

ACCESSPATH

Indica que se van a actualizar únicamente las columnas de la tabla de historial de catálogo que proporcionan estadísticas que se utilizan para la selección de vía de acceso.

SPACE

Indica que sólo se van a actualizar las estadísticas de catálogo relacionadas con el espacio en las tablas de historial de catálogo.

NONE

Indica que las tablas de historial de catálogo no se van a actualizar con las estadísticas recopiladas.

FORCEROLLUP

Especifica si la agregación o resumen de estadísticas va a tener lugar cuando se ejecuta RUNSTATS aunque no se hayan recopilado estadísticas en algunas particiones; por ejemplo, las particiones no tienen datos cargados. El optimizador utiliza estadísticas agregadas para seleccionar la mejor vía de acceso.

YES

Indica que se va a realizar el proceso de resumen o agregación forzado, aunque es posible que algunas particiones no contengan datos.

NO

Indica que la agregación o resumen se ha realizar sólo si hay datos disponibles para todas las particiones.

Si no hay datos disponibles para todas las particiones, se emite el mensaje DSNU623I si el valor de instalación para STATISTICS ROLLUP en el panel DSNTIP6 se establece en NO.

PUNCHDDN ddname

Especifica la sentencia DD para un conjunto de datos que va a recibir las sentencias de control de la utilidad LOAD generadas por REORG TABLESPACE UNLOAD EXTERNAL o REORG TABLESPACE DISCARD FROM TABLE. CUÁNDO.

ddname es el nombre DD.

El valor predeterminado es SYSPUNCH.

PUNCHDDN es necesario si se ha reducido la clave de límite de la última partición de un espacio de tabla particionado.

PUNCHDDN no es válido para espacios de tablas LOB.

La palabra clave PUNCHDDN especifica un nombre DD o una especificación de nombre TEMPLATE de una instrucción de control TEMPLATE anterior. Si el procesamiento de utilidades detecta que el nombre especificado es tanto un nombre DD en el paso de trabajo actual como un nombre TEMPLATE, la utilidad utiliza el nombre DD.

DISCARDDN ddname

Especifica la instrucción DD para un conjunto de datos descartados, que contiene copias de registros que cumplen la condición DISCARD FROM TABLE. CUANDO se especifique.

ddname es el nombre DD.

Si omite la opción DISCARDDN, la utilidad guarda los registros descartados solo si hay una instrucción SYSDISC DD en la entrada JCL.

El valor predeterminado es SYSDISC.

La DISCARDDN especifica un nombre DD o una especificación de nombre TEMPLATE de una instrucción de control TEMPLATE anterior. Si el procesamiento de utilidades detecta que el nombre especificado es tanto un nombre DD en el paso de trabajo actual como un nombre TEMPLATE, la utilidad utiliza el nombre DD.

UNLDDN ddname

Especifica el nombre del conjunto de datos de descarga.

ddname es el nombre DD del conjunto de datos de descarga.

El valor predeterminado es SYSREC.

La palabra clave UNLDDN especifica un nombre DD o una especificación de nombre TEMPLATE de una instrucción de control TEMPLATE anterior. Si el procesamiento de utilidades detecta que el nombre especificado es tanto un nombre DD en el paso de trabajo actual como un nombre TEMPLATE, la utilidad utiliza el nombre DD.

SORTDEVT tipo de dispositivo

Especifica el tipo de dispositivo para conjuntos de datos temporales que el programa de clasificación externo debe asignar dinámicamente.

device-type es el tipo de dispositivo. Puede especificar cualquier dispositivo de disco que sea aceptable para el parámetro DYNALLOC de la instrucción de control SORT u OPTION para el programa de clasificación. El programa de clasificación no admite dispositivos de cinta.

Si omite SORTDEVT y necesita una ordenación de las claves de índice, debe proporcionar las instrucciones DD que el programa de ordenación necesita para los conjuntos de datos temporales.

SORTDEVT se ignora para los espacios de tabla de catálogo y directorio que se enumeran en Reorganización del catálogo y directorio.

SORTDEVT no se puede utilizar para espacios de tabla LOB.

La utilidad no permite que una especificación TEMPLATE asigne dinámicamente conjuntos de datos de trabajo de clasificación. La palabra clave SORTDEVT controla la asignación dinámica de estos conjuntos de datos.

SORTNUM entero

Especifica el número de conjuntos de datos temporales que se asignarán dinámicamente para todos los tipos que REORG realiza.

entero es el número de conjuntos de datos temporales que puede variar de 2 a 255.

Si omite SORTDEVT, SORTNUM se ignora. Si utiliza SORTDEVT y omite SORTNUM, no se pasa ningún valor al programa de clasificación. El programa de clasificación utiliza su propio valor predeterminado SORTNUM.

Necesita al menos dos conjuntos de datos de trabajo de clasificación para cada clasificación. El valor SORTNUM se aplica a cada invocación de ordenación en la utilidad. Por ejemplo, se asignaría un total de 24 conjuntos de datos de trabajo de clasificación para un trabajo, si se cumplen los siguientes criterios:

• Hay tres índices.
• No hay restricciones que limiten el paralelismo.
• SORTNUM se especifica como 8.

Cada conjunto de datos de trabajo de clasificación consume tanto almacenamiento virtual por encima de la línea como por debajo de la línea. Por lo tanto, si especifica un valor demasiado alto para SORTNUM, la utilidad podría disminuir el grado de paralelismo debido a restricciones de almacenamiento virtual, y posiblemente disminuir el grado hasta uno, lo que significaría que no habría paralelismo.

Importante: La palabra clave SORTNUM se ignora si el parámetro del subsistema IGNSORTN está ajustado a YES.

SORTNUM se ignora para los espacios de tabla de catálogo y directorio enumerados en Reorganizar el catálogo y el directorio.

PREFORMAT

Especifica que las páginas restantes deben preformatearse hasta el RBA asignado alto en el espacio de tabla y los espacios de índice asociados con el espacio de tabla o las particiones que se están reorganizando. El preformateo se produce después de cargar los datos y crear los índices.

PREFORMAT puede operar en un espacio de tabla completo y sus espacios de índice, o en una partición de un espacio de tabla particionado y su correspondiente espacio de índice de partición. Cuando se especifica o acepta AUX YES como valor predeterminado, los espacios de la tabla LOB y los índices auxiliares asociados a las particiones base que se están reorganizando también se preformatean al final de la fase RELOAD.

PREFORMAT se ignora si especifica SOLO DESCARGAR o DESCARGAR EXTERNO.

ROWFORMAT

Especifica el formato de la fila de salida en el espacio de tabla o partición afectado. Esta palabra clave no tiene efecto en los espacios de tabla LOB, catálogo, directorio, XML y Universal que participan en una relación CLONE.

Importante : ROWFORMAT está obsoleto en Db2 12 for z/OS, lo que significa que se desaconseja su uso. Aunque esta palabra clave sigue siendo compatible, es probable que el soporte se elimine con el tiempo. Ver Función obsoleta en Db2 12.

BRF

Especifica que el espacio de la tabla o la partición que se está reorganizando o reemplazando debe convertirse o permanecer en formato de fila básica.

RRF

Especifica que el espacio de la tabla o la partición que se está reorganizando o reemplazando debe convertirse o permanecer en formato de fila reordenada.

RBALRSN_CONVERSION

Especifica el formato RBA o LRSN del objeto de destino tras la finalización de la utilidad REORG.

Importante : RBALRSN_CONVERSION está obsoleto, lo que significa que no se recomienda su uso. Aunque esta palabra clave sigue siendo compatible, es probable que el soporte se elimine con el tiempo. La utilidad falla si se especifica BASIC, o si se especifica NONE para un objeto en el formato de 6 bytes.

EXTENDED

Especifica que si un objeto se encuentra en formato básico de 6 bytes, se convierte a formato extendido de 10 bytes.

EXTENDED es el valor predeterminado.

NONE

Especifica que no se realiza ninguna conversión.

La utilidad falla si se especifica RBALRSN_CONVERSION NONE en un espacio de tabla que está en formato básico de 6 bytes.

Si existe una relación CLONE, no se puede realizar la conversión de conjunto de páginas. Para las relaciones de clonación, debe eliminar la tabla de clonación, convertir la tabla base al formato extendido de 10 bytes y, a continuación, volver a crear la tabla de clonación.

Si también se especifica AUX YES, también se convierten los espacios de tabla LOB y los índices auxiliares.

Los índices que se reconstruyen durante REORG TABLESPACE se convierten al mismo formato RBA o LRSN que el espacio de tabla indexado. REORG TABLESPACE en el nivel PART convierte las particiones correspondientes de los índices particionados. Los índices no particionados se convierten si también se especifica SHRLEVEL CHANGE o REFERENCE, o si se reorganiza todo el espacio de la tabla con SHRLEVEL NONE.

Si se ha alcanzado el límite de 6 bytes de RBA o LRSN, es posible que no pueda realizar la primera inserción o carga en un espacio de tabla XML que tenga control de versiones XML y que se haya creado con DEFINE NO y formato de página básico de 6 bytes. Puede ejecutar REORG TABLESPACE en el espacio de tabla DEFINE NO XML para convertir su definición al formato de página extendido de 10 bytes. La REORG debe hacerse en todo el espacio de la mesa.

DISCARD

Especifica que los registros que cumplan las condiciones especificadas en WHEN deben descartarse durante REORG TABLESPACE UNLOAD CONTINUE o UNLOAD PAUSE. Si especifica DISCARDDN o una sentencia SYSDISC DD en el JCL, los registros descartados se guardan en el conjunto de datos asociado. De lo contrario, la utilidad descarta los registros sin guardarlos en un conjunto de datos.

Puede especificar cualquier opción SHRLEVEL con DISCARD. Sin embargo, si especifica SHRLEVEL CHANGE, no se permiten las modificaciones que se realicen durante la reorganización en las filas de datos que coincidan con los criterios de descarte. En este caso, REORG TABLESPACE finaliza con un error.

Si especifica DESCARTAR, las filas se descomprimen y las rutinas de edición se decodifican. Si también especifica DESCARTAR en un archivo, las filas se decodifican mediante el procedimiento de campo y las siguientes columnas se convierten a Db2 formato externo:

• SMALLINT
• ENTERO
• FLOAT
• DECIMAL
• HORA
• TIMESTAMP

De lo contrario, las rutinas de edición o los procedimientos de campo se omiten tanto en la fase de DESCARGA como en la de RECARGA para los espacios de tabla. Los procedimientos de validación no se aplican durante ninguna de las dos fases.

Restricciones : No especifique DESCARTAR si se da alguna de las siguientes condiciones:

• La instrucción REORG TABLESPACE incluye la opción UNLOAD EXTERNAL o UNLOAD ONLY.
• El espacio de la mesa que se va a reorganizar es cualquiera de los siguientes objetos:
  • Una tabla base con columnas XML
  • Un espacio de tabla XML
  • Una tabla base con columnas LOB si los registros que se van a descartar tienen más de 32 KB y desea guardarlos en un conjunto de datos.
  • Un espacio de tabla temporal de período de sistema

Si especifica DESCARTAR y el espacio de tabla que se va a reorganizar contiene una tabla que está involucrada en un conjunto de integridad referencial, cualquier objeto relacionado referencialmente afectado se coloca en estado CHECK-pending. Después de la operación REORG, debe ejecutar CHECK DATA en cualquiera de estos objetos que se hayan colocado en este estado restrictivo.

Si especifica DISCARD en una tabla con columnas LOB y el espacio de tabla es un espacio de tabla no particionado noUTS, los datos LOB no se eliminan con REORG. Si se especifica AUX YES, se devuelve el mensaje de advertencia DSNU124I; si se especifica AUX NO o se acepta como predeterminado, no se informa de ningún mensaje de advertencia. En estos casos, debe identificar los datos LOB huérfanos ejecutando CHECK DATA y eliminarlos manualmente mediante REPAIR LOCATE ROWID VERSION DELETE.

NOCHECKPEND

Especifica que cuando REORG descarta registros de una tabla padre en al menos una relación de integridad referencial, la utilidad no establece el estado CHECK-pending en los espacios de tabla dependientes. NOCHECKPEND solo se aplica cuando REORG descarta registros de una tabla principal; de lo contrario, esta opción se ignora. NOCHECKPEND no elimina ningún estado CHECK-pending que se haya establecido antes de la operación REORG.