DEFINE BUFFPOOL (definir una agrupación de almacenamiento intermedio) en z/OS

Utilice el mandato MQSC DEFINE BUFFPOOL para definir una agrupación de almacenamiento intermedio que se utiliza para contener mensajes en el almacenamiento principal.

Utilización de mandatos MQSC en z/OS

Para obtener información sobre cómo utilizar los mandatos MQSC en z/OS®, consulte Orígenes desde los que puede emitir mandatos MQSC y PCF en IBM® MQ for z/OS.

Puede emitir este mandato desde los orígenes 1. Para obtener una explicación de los símbolos de origen, consulte Orígenes desde los que puede emitir mandatos MQSC y PCF en IBM MQ for z/OS.

Diagrama de sintaxis
Notas de uso
Descripciones de parámetros para DEFINE BUFFPOOL

Sinónimo: DEF BP

DEFINE BUFFPOOL

Notas de uso

Especifique los mandatos DEFINE BUFFPOOL en un conjunto de datos identificado por la concatenación CSQINP1 DD en el procedimiento de tarea iniciada del gestor de colas.
Utilice el mandato DISPLAY USAGE TYPE (PAGESET) para visualizar información de agrupación de almacenamientos intermedios (consulte DISPLAY USAGE (visualizar información de uso) en z/OS ).
Utilice el mandato ALTER BUFPOOL para cambiar dinámicamente los valores de una agrupación de almacenamiento intermedio predefinida (consulte ALTER BUFFPOOL (modificar valores de agrupación de almacenamiento intermedio) en z/OS ).

Descripciones de parámetros para DEFINE BUFFPOOL

Si se emite más de un mandato DEFINE BUFFPOOL para la misma agrupación de almacenamiento intermedio, sólo se procesa el último.

(id-agrupación-buf)

Identificador de la agrupación de almacenamiento intermedio.

Este parámetro es un entero en el rango de cero a 99.

BUFFERS( entero )

Este parámetro es necesario y es el número de almacenamientos intermedios de 4096 bytes que deben utilizarse en esta agrupación de almacenamientos intermedios.

Si el valor del parámetro LOCATION es BELOW, el valor mínimo de búferes es 100 y el valor máximo es 500.000. Si el valor del parámetro LOCATION es ABOVE, los valores válidos están comprendidos entre 100 y 999999999 (nueve nueves). El almacenamiento utilizado para almacenamientos intermedios en una agrupación de almacenamientos intermedios con LOCATION ABOVE se obtiene en múltiplos de 4MB. Por lo tanto, especificar un valor BUFFERS que sea un múltiplo de 1024 hará el uso más eficiente del almacenamiento.

LOCATION( LOC ) (ABAJO o ARRIBA )

LOCATION y LOC son sinónimos y se puede utilizar cualquiera de ellos, pero no ambos.

El parámetro LOCATION o LOC especifica dónde se encuentra la memoria utilizada por la agrupación de almacenamiento intermedio especificada.

Atención: A partir de IBM MQ 9.1, LOCATION ( BELOW ) está obsoleto y sólo debe utilizar LOCATION ( ABOVE ).

Esta posición de memoria puede ser ABOVE (64 bits) o BELOW (31 bits) la barra. Los valores válidos para este parámetro son BELOW o ABOVE, siendo BELOW el valor por defecto.

Al modificar una agrupación de almacenamiento intermedio, debe asegurarse de que haya suficiente almacenamiento disponible si aumenta el número de almacenamientos intermedios o si cambia el valor de LOCATION . Cambiar la ubicación de la agrupación de almacenamiento intermedio puede ser una tarea en donde se utilicen muchos recursos de la CPU y entrada/salida. Debe realizar esta tarea cuando el gestor de colas no se esté utilizando mucho.

Para obtener más información, consulte Almacenamiento de espacio de direcciones.

PAGECLAS( 4KB o FIXED4KB )

El parámetro opcional que describe el tipo de páginas de almacenamiento virtual utilizadas para la copia de seguridad de los almacenamientos intermedios de la agrupación de almacenamiento intermedio.

Este atributo se aplica a todos los búferes de la reserva de búferes, incluidos los que se añadan posteriormente como resultado del uso del comando ALTER BUFFPOOL. El valor predeterminado es 4KB, lo que significa que se utilizan páginas de 4KB paginables para dar respaldo a los almacenamientos intermedios de la agrupación.

4KB es el único valor válido si el grupo de búferes tiene el atributo LOCATION establecido en BELOW. Si el grupo de búferes tiene el atributo LOCATION establecido en ABOVE, también es posible especificar FIXED4KB. Esto significa que las páginas fijas 4KB, que están permanentemente en el almacenamiento real y nunca se paginan al almacenamiento auxiliar, se utilizan para respaldar los búferes en la reserva de búferes.

El atributo PAGECLAS de un grupo de búferes puede modificarse en cualquier momento. Sin embargo, la modificación solo se lleva a cabo cuando la agrupación de almacenamiento intermedio cambia de ubicación desde la parte superior de la barra a la parte inferior de la barra o a la inversa. De lo contrario, el valor es el que está almacenado en el registro del gestor de colas y se aplica la próxima vez que se reinicia el gestor de colas.

Cuando se especifica PAGECLAS ( FIXED4KB ) todo el conjunto de búferes está respaldado por páginas fijas 4KB, así que asegúrese de que hay suficiente almacenamiento real disponible en la LPAR. De lo contrario, es posible que el gestor de colas no se inicie o que otros espacios de direcciones se vean afectados. Para más información, consulte Almacenamiento del espacio de direcciones.

Consulte IBM MQ Support Pac MP16: IBM MQ for z/OS - Capacity planning & tuning para obtener consejos sobre cuándo utilizar el valor FIXED4KB del atributo PAGECLAS.

REPLACE/NOREPLACE

Atributo opcional que describe si esta definición de una agrupación de almacenamiento intermedio altera temporalmente cualquier definición que ya esté contenida en el registro del gestor de colas.

El gestor de colas registra los valores de la agrupación de almacenamiento intermedio actual en los registros de punto de comprobación. Estos tamaños de la agrupación de almacenamiento intermedio se restauran automáticamente cuando se reinicia un gestor de colas posteriormente. Esta restauración se lleva a cabo después de procesar el conjunto de datos CSQINP1.

Por lo tanto, si se ha utilizado ALTER BUFFPOOL desde la última vez que se definió el grupo de búferes, cualquier comando DEFINE BUFFPOOL en CSQINP1 se ignora al reiniciar, a menos que se especifique el atributo REPLACE.

Atención: Si especifica el atributo REPLACE en el comando DEFINE BUFFPOOL en CSQINP1, y algún tiempo después especifica el comando ALTER BUFFPOOL para aumentar el tamaño de la reserva de búferes (por ejemplo, debido a un aumento de la carga de trabajo y, por lo tanto, a un aumento de la demanda de uso de la reserva de búferes), podría producirse un problema la próxima vez que se reinicie el gestor de colas.

Tras el reinicio, los grupos de búferes volverán al tamaño original definido en CSQINP1 y, por tanto, no podrán gestionar el aumento de la carga de trabajo. Por lo tanto, debe considerar eliminar el atributo REPLACE de los comandos DEFINE BUFFPOOL en CSQINP1 tan pronto como los grupos de búferes se hayan definido correctamente.

Esto garantizará que cualquier cambio realizado en los grupos de búferes, como resultado de la especificación de comandos ALTER BUFFPOOL, se conserve al reiniciar el gestor de colas.

REPLACE: Esta definición de la agrupación de almacenamiento intermedio altera temporalmente la definición almacenada en el registro del gestor de colas, si la hay. Si la definición en el registro del gestor de colas es diferente de esta definición, las diferencias se descartan y se emite el mensaje CSQP064I .
NOREPLACE: Este es el valor predeterminado y proporciona el mismo comportamiento que con los releases anteriores de IBM MQ. Si hay una definición de la agrupación de almacenamiento intermedio en el registro del gestor de colas que se utiliza, y esta definición se ignora.

Atención: El gestor de colas registra los valores actuales de la agrupación de almacenamientos intermedios en los registros de anotaciones de punto de comprobación. Estos tamaños de la agrupación de almacenamiento intermedio se restauran automáticamente cuando se reinicia un gestor de colas posteriormente. Esta restauración se lleva a cabo después de procesar el conjunto de datos CSQINP1. Por lo tanto, si ha utilizado ALTER BUFFPOOL desde que se definió por última vez la agrupación de almacenamiento intermedio, cualquier mandato DEFINE BUFFPOOL de CSQINP1 se ha ignorado durante el reinicio, a menos que se haya especificado el atributo REPLACE .