Atributos para colas

Hay cinco tipos de definición de cola. Algunos atributos de cola se aplican a todos los tipos de cola; otros atributos de cola sólo se aplican a determinados tipos de cola.

Tipos de cola

El gestor de colas da soporte a los siguientes tipos de definición de cola:
Cola local
Puede almacenar mensajes en una cola local.
[z/OS]En z/OS® puedes hacer que sea una cola compartida o privada.

Una cola se conoce en un programa como local si es propiedad del gestor de colas al que está conectado el programa. Puede obtener mensajes y transferirlos en las colas locales.

El objeto de definición de cola contiene la información de definición de la cola, así como los mensajes físicos colocados en cola.

Cola del gestor de colas local
La cola existe en el gestor de colas local.
[z/OS]La cola se conoce como cola privada en z/OS.
[z/OS]Cola compartida (z/OS solamente)
La cola existe en un repositorio compartido al que pueden acceder todos los gestores de colas que pertenecen al grupo de compartición de colas propietario del repositorio compartido.

Las aplicaciones conectadas a cualquier administrador de colas en el grupo de uso compartido de colas pueden colocar mensajes y eliminar mensajes de colas de este tipo. Estas colas son en realidad las mismas que las colas locales. El valor de laQType atributo de cola es MQQT_LOCAL .

Las aplicaciones conectadas al administrador de colas local pueden colocar mensajes y eliminar mensajes de colas de este tipo. El valor de laQType atributo de cola es MQQT_LOCAL .

Cola de clúster

Puede almacenar mensajes en una cola de clúster en el gestor de colas donde está definido. Una cola de clúster es una cola que se aloja en un gestor de colas de clúster y que está disponible para otros gestores de colas del clúster. El valor del atributo de cola QType es MQQT_CLUSTER.

Una definición de cola de clúster se anuncia en otros gestores de colas del clúster. Los otros gestores de colas del clúster pueden transferir mensajes a una cola de clúster sin necesidad de que haya una definición de cola remota correspondiente. Una cola de clúster se puede anunciar en más de un clúster utilizando una lista de nombres de clúster.

Cuando se anuncia una cola, cualquier gestor de colas del clúster puede poner mensajes en ella. Para transferir un mensaje, el gestor de colas debe averiguar, en los repositorios completos, donde está alojada la cola. A continuación, añade información de direccionamiento al mensaje y pone el mensaje a una cola de transmisión de clúster.

Un gestor de colas puede almacenar mensajes para otros gestores de colas en un clúster en varias colas de transmisión. Puede configurar un gestor de colas para almacenar mensajes en varias colas de transmisión de clúster de dos maneras diferentes. Si establece el atributo de gestor de colas DEFCLXQ en CHANNEL, se crea automáticamente una cola de transmisión de clúster diferente de SYSTEM.CLUSTER.TRANSMIT.MODEL.QUEUE para cada canal de clúster emisor. Si establece la opción de cola de transmisión CLCHNAME para que coincida con uno o varios canales de clúster emisor, el gestor de colas puede almacenar mensajes para los canales coincidentes en esa cola de transmisión.
Atención: Si utiliza SYSTEM.CLUSTER.TRANSMIT.QUEUES dedicado con un gestor de colas que se ha actualizado desde una versión del producto anterior a IBM® WebSphere® MQ 7.5, asegúrese de que SYSTEM.CLUSTER.TRANSMIT.MODEL.QUEUE tenga la opción SHARE/NOSHARE establecida en SHARE.

Una cola de clúster puede ser una cola compartida por miembros de un grupo de compartición de colas enIBM MQ for z/OS .

Cola remota
Una cola remota no es una cola física; es la definición local de una cola que existe en un gestor de colas remoto. La definición local de la cola remota contiene información que indica al gestor de colas local cómo direccionar los mensajes al gestor de colas remoto.

Las aplicaciones conectadas al gestor de colas local pueden colocar mensajes en colas de este tipo; los mensajes se colocan en la cola de transmisión local que se utiliza para direccionar los mensajes al gestor de colas remoto. Las aplicaciones no pueden eliminar mensajes de colas remotas. El valor del atributo de cola QType es MQQT_REMOTE.

También puede utilizar una definición de cola remota para:
  • Alias de cola de respuestas

    En este caso, el nombre de la definición es el nombre de una cola de respuestas. Para obtener más información, consulte Alias de cola de respuesta y clústeres.

  • Alias de gestor de colas

    En este caso, el nombre de la definición es un alias para un gestor de colas, no el nombre de una cola. Para obtener más información, consulte Alias y clústeres de gestores de colas.

Cola alias
No es una cola física; es un nombre alternativo para una cola local, una cola compartida, una cola de clúster o una cola remota. El nombre de la cola en la que se resuelve el alias forma parte de la definición de la cola alias.

Las aplicaciones conectadas al gestor de colas local pueden colocar mensajes en colas de este tipo; los mensajes se colocan en la cola en la que se resuelve el alias. Las aplicaciones pueden eliminar mensajes de colas de este tipo si el alias se resuelve en una cola local, una cola compartida o una cola de clúster que tiene una instancia local. El valor del atributo de cola QType es MQQT_ALIAS.

Cola modelo
No es una cola física; es un conjunto de atributos de cola a partir de los cuales se puede crear una cola local.

Los mensajes no se pueden almacenar en colas de este tipo.

límites en cola

Puede configurar y supervisar colas que soporten sustancialmente más del límite predeterminado de dos terabytes utilizado en releases anteriores de IBM MQ. También tiene la opción de reducir hasta qué tamaño puede aumentar un archivo de la cola.

Para permitirle configurar colas, puede utilizar el atributo MAXFSIZE en colas locales y de modelo, y para supervisar colas, puede utilizar los atributos de estado de cola CURFSIZE y CURMAXFS.

Para obtener más información, consulte Modificación de archivos de cola de IBM MQ.

Atributos de colas

Algunos atributos de cola se aplican a todos los tipos de cola; otros atributos de cola sólo se aplican a determinados tipos de cola. Los tipos de cola a los que se aplica un atributo se muestran en Tabla 1 y tablas posteriores.
La tabla 1 resume los atributos que son específicos de las colas. Los atributos se describen en orden alfabético.
Nota: Los nombres de los atributos que se muestran en esta sección son nombres descriptivos utilizados con las llamadas MQINQ y MQSET ; los nombres son los mismos que para los mandatos PCF. Cuando se utilizan mandatos MQSC para definir, modificar o visualizar atributos, se utilizan nombres abreviados alternativos; consulte Mandatos MQSC para obtener más detalles.
En la tabla siguiente, las columnas se aplican de la forma siguiente:
  • La columna para las colas locales también se aplica a las colas compartidas.
  • La columna para colas modelo indica qué atributos hereda la cola local creada a partir de la cola modelo.
  • La columna para colas de clúster indica los atributos que se pueden consultar cuando la cola de clúster se abre solo para consulta, o para consulta y salida. Si se consulta cualquier otro atributo, la llamada devuelve el código de terminación MQCC_WARNING y el código de razón MQRC_SELECTOR_NOT_FOR_TYPE (2068).

    Si la cola de clúster se abre para realizar consultas más una o más entradas, examinar o establecer, en su lugar se aplica la columna correspondiente a las colas locales.

    Si la cola de clúster se abre solo para consultas, o para consultas y salidas, además de especificar el nombre del gestor de colas base, en su lugar se aplica la columna para colas locales.

Tabla 1. Atributos para colas
Atributo Descripción Local Modelo Alias Remoto Clúster
AlterationDate Fecha en la que se modificó por última vez la definición X   X X  
AlterationTime Hora en que se cambió por última vez la definición X   X X  
BackoutRequeueQName Nombre de cola de reposición en cola de restitución excesivo X X      
BackoutThreshold Umbral de restituciones X X      
BaseQName Nombre de cola al que se resuelve el alias     X    
CFStrucName Nombre de estructura de recurso de acoplamiento X X      
CLCHNAME Nombres de canal de clúster emisor X X      
ClusterName Nombre del clúster al que pertenece la cola X   X X X
ClusterNamelist Nombre del objeto de lista de nombres que contiene nombres de clústeres a los que pertenece la cola X   X X  
CLWLQueuePriority Prioridad de cola de carga de trabajo de clúster X   X X X
CLWLQueueRank Rango de cola de carga de trabajo de clúster X   X X X
CLWLUseQ Utilizar cola remota X        
CreationDate Fecha de creación de la cola X        
CreationTime Hora a la que se ha creado la cola X        
CurrentQDepth Profundidad de cola actual X        
DefaultPutResponse Resp predet de transferencia X X X X  
DefBind Enlace predeterminado X   X X X
DefinitionType attribute Tipo de definición de cola X X      
DefInputOpenOption Opción abierta de entrada predeterminada X X      
DefPersistence Persistencia de mensajes predeterminada X X X X X
DefPriority Prioridad de mensajes predeterminada X X X X X
DefReadAhead Lectura anticipada predeterminada X X X    
DistLists Soporte de lista de distribución X X      
HardenGetBackout Si se debe mantener un recuento de restituciones preciso X X      
IndexType Tipo de índice X X      
InhibitGet Si se permiten operaciones get para la cola X X X    
InhibitPut Si se permiten operaciones de colocación para la cola X X X X X
InitiationQName Nombre de cola de inicio X X      
MaxMsgLength Longitud máxima de mensaje en bytes X X      
MaxQDepth Profundidad máxima de la cola X X      
MsgDeliverySequence attribute Secuencia de entrega de mensajes X X      
NonPersistentMessage Class Objetivo de fiabilidad para mensajes no persistentes X X      
OpenInputCount Número de aperturas para entrada X        
OpenOutputCount Número de aperturas para salida X        
PropertyControl Control de propiedad X X X    
ProcessName Nombre de proceso X X      
QDepthHighEvent attribute Si se generan sucesos de profundidad de cola alta X X      
QDepthHighLimit Límite alto para profundidad de cola X X      
QDepthLowEvent attribute Si se generan sucesos de profundidad de cola baja X X      
QDepthLowLimit attribute Límite bajo para profundidad de cola X X      
QDepthMaxEvent Si se generan sucesos de cola llena X X      
QDesc Descripción de la cola X X X X X
QName Nombre de cola X   X X X
QServiceInterval Destino para intervalo de servicio de cola X X      
QServiceIntervalEvent attribute Si se generan sucesos de intervalo de servicio alto o de intervalo de servicio correcto X X      
QSGDisp attribute Disposición de grupo de uso compartido de colas X   X X  
QueueAccounting Recopilación de datos de contabilidad de cola X X X X X
QueueMonitoring Datos de supervisión en línea para colas X X      
QueueStatistics recopilación de datos de estadísticas de cola X X X X X
QType Tipo de cola X   X X X
RemoteQMgrName Nombre del gestor de colas remoto       X  
RemoteQName Nombre de cola remota       X  
RetentionInterval Intervalo de retención X X      
Scope Si también existe una entrada para la cola en un directorio de célula X   X X  
Shareability Compartibilidad de cola X X      
StorageClass Clase de almacenamiento para cola X X      
TriggerControl Activar control X X      
TriggerData Datos desencadenantes X X      
TriggerDepth Profundidad de desencadenante X X      
TriggerMsgPriority Prioridad de mensaje de umbral para desencadenantes X X      
TriggerType Tipo de desencadenante X X      
Usage attribute Uso de cola X X      
XmitQName Nombre de cola de transmisión       X