DEFINE colas

Utilice el mandato DEFINE de MQSC para definir una cola local, modelo o remota, o un alias de cola, un alias de cola de respuesta o un alias de gestor de colas.

Utilización de mandatos MQSC

Para obtener información sobre cómo utilizar los mandatos MQSC, consulte Administración de IBM® MQ utilizando mandatos MQSC.

[z/OS]Puede emitir este comando desde las fuentes 2CR. 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®.

Diagramas sintácticos de las colas DEFINE

Existe un diagrama sintáctico distinto para cada tipo de cola:

Notas de uso de las colas DEFINE

  • La finalización satisfactoria del mandato no significa que la acción se haya completado. Para comprobar la finalización verdadera, consulte el paso Colas DEFINE en Comprobación de que los mandatos asíncronos para redes distribuidas han finalizado.
  • Para colas locales
    1. [z/OS]Puede definir una cola local con QSGDISP(SHARED) aunque otro administrador de colas del grupo de uso compartido de colas ya tenga una versión local de la cola. Sin embargo, cuando intenta acceder a la cola definida localmente, falla con el código de razón MQRC_OBJECT_NOT_UNIQUE (2343). Una versión local de la cola con el mismo nombre puede ser de tipo QLOCAL, QREMOTE, o QALIAS y tiene la disposición, QSGDISP(QMGR).

      Para resolver el conflicto, debe suprimir una de las colas utilizando el mandato DELETE . Si la cola que desea suprimir contiene mensajes, utilice la opción PURGE o elimine primero los mensajes utilizando el mandato MOVE .

      Por ejemplo, para suprimir la versión de QSGDISP(LOCAL) , que contiene mensajes, y copiarlos en la versión de QSGDISP(SHARED) , emita los mandatos siguientes:
      MOVE QLOCAL(QUEUE.1) QSGDISP(PRIVATE) TOQLOCAL(QUEUE.1) TYPE(ADD)
DELETE QLOCAL(QUEUE.1) QSGDISP(QMGR)
  • Para colas alias:
    1. DEFINE QALIAS( aliasqueue ) TARGET( otherqname ) CLUSTER( c ) anuncia la cola otherqname con el nombre aliasqueue.
    2. DEFINE QALIAS( aliasqueue ) TARGET( otherqname ) permite que una cola anunciada con el nombre otherqname se utilice en este gestor de colas con el nombre aliasqueue.
    3. TARGTYPE y TARGET no son atributos de clúster, es decir, no se comparten en un entorno de clúster.
  • Para colas remotas:
    1. DEFINE QREMOTE( rqueue ) RNAME( otherq ) RQMNAME( otherqm ) CLUSTER( cl ) anuncia este gestor de colas como una pasarela de almacén y reenvío a la que se pueden enviar mensajes para la cola rqueue . No tiene ningún efecto como alias de cola de respuesta, excepto en el gestor de colas local.

      DEFINE QREMOTE( otherqm ) RNAME() RQMNAME( anotherqm ) XMITQ( xq ) CLUSTER anuncia este gestor de colas como una pasarela de almacén y reenvío a la que se pueden enviar mensajes para anotherqm .

    2. RQMNAME puede ser el nombre de un gestor de colas de clúster dentro del clúster. Puede correlacionar el nombre de gestor de colas anunciado con otro nombre localmente. El patrón es el mismo que con las definiciones QALIAS .
    3. Es posible que los valores de RQMNAME y QREMOTE sean los mismos si RQMNAME es en sí mismo un gestor de colas de clúster. Si esta definición también se anuncia utilizando un atributo CLUSTER , no elija el gestor de colas local en la salida de carga de trabajo de clúster. Si lo hace, se genera una definición cíclica.
    4. Las colas remotas no tienen que definirse localmente. La ventaja de hacerlo es que las aplicaciones pueden hacer referencia a la cola mediante un nombre simple definido localmente. Si lo hace, el nombre de cola se califica mediante el nombre del gestor de colas en el que reside la cola. El uso de una definición local significa que las aplicaciones no necesitan conocer la ubicación real de la cola.
    5. Una definición de cola remota también se puede utilizar como mecanismo para contener una definición de alias de gestor de colas o una definición de alias de cola de respuesta. El nombre de la definición en estos casos es:
      • El nombre del gestor de colas que se utiliza como alias para otro nombre de gestor de colas (alias de gestor de colas), o
      • El nombre de cola que se utiliza como alias para la cola de respuesta (alias de cola de respuesta).
    6. Defina una cola de respuesta o un alias de gestor de cola con el comando DEFINE QREMOTE (definir una nueva definición de cola remota local ).

Descripción de los parámetros de las colas " DEFINE

La Tabla 1 muestra los parámetros que son relevantes para cada tipo de cola. Hay una descripción de cada parámetro después de la tabla.
Tabla 1. DEFINIR colas parámetros
Parámetro Cola local Cola modelo Cola alias Cola remota
ACCTQ X X    
BOQNAME X X    
BOTHRESH X X    
[ MQ 9.4.0 Jun 2024] CAPEXPRY X X X X
[z/OS] CFSTRUCT X X    
CLCHNAME X      
CLUSNL X   X X
CLUSTER X   X X
CLWLPRTY X   X X
CLWLRANK X   X X
CLWLUSEQ X      
[z/OS] CMDSCOPE X X X X
CUSTOM X X X X
DEFBIND X   X X
DEFPRESP X X X X
DEFPRTY X X X X
DEFPSIST X X X X
DEFREADA X X X  
DEFSOPT X X    
DEFTYPE   X    
DESCR X X X X
DISTL X X    
FORCE X   X X
GET X X X  
HARDENBO or NOHARDENBO X X    
IMGRCOVQ X X    
[z/OS] INDXTYPE X X    
INITQ X X    
LIKE X X X X
MAXDEPTH X X    
MAXFSIZE X X    
MAXMSGL X X    
MONQ X X    
MSGDLVSQ X X    
NOREPLACE X X X X
NPMCLASS X X    
[ MQ 9.4.3 Jun 2025][z/OS]OTELPCTL X X   X
[ MQ 9.4.3 Jun 2025][z/OS]OTELTRAC X X   X
PROCESS X X    
PROPCTL X X X  
PUT X X X X
queue-name X X X X
QDEPTHHI X X    
QDEPTHLO X X    
QDPHIEV X X    
QDPLOEV X X    
QDPMAXEV X X    
[z/OS] QSGDISP X X X X
QSVCIEV X X    
QSVCINT X X    
REPLACE X X X X
RETINTVL X X    
RNAME       X
RQMNAME       X
SCOPE X   X X
SHARE or NOSHARE X X    
STATQ X X    
[z/OS] STGCLASS X X    
STREAMQ X X
STRMQOS X X
TARGET     X  
TARGQ     X  
TARGTYPE     X  
TRIGDATA X X    
TRIGDPTH X X    
TRIGGER or NOTRIGGER X X    
TRIGMPRI X X    
TRIGTYPE X X    
USAGE X X    
XMITQ       X
nombre de la cola
Nombre local de la cola, excepto la cola remota donde es la definición local de la cola remota.
Véanse las reglas de denominación de los objetos IBM MQ .
ACCTQ
Especifica si se debe activar la recopilación de datos de contabilidad para la cola. En z/OS, los datos recopilados son datos de contabilidad de clase 3 (contabilidad a nivel de subproceso y a nivel de cola). Para que se recopilen los datos contables de esta cola, también deben estar habilitados los datos contables de esta conexión. Active la recopilación de datos contables configurando el atributo del gestor de colas ACCTQ o el campo de opciones de la estructura MQCNO en la llamada MQCONNX .
QMGR
La recogida de datos contables se basa en la configuración del parámetro ACCTQ en la definición del gestor de colas.
ON
La recopilación de datos contables está activada para la cola a menos que el parámetro ACCTQ queue manager tenga el valor NONE.
[z/OS]En los sistemas z/OS , debe activar la contabilidad de clase 3 mediante el comando START TRACE .
OFF
La recopilación de datos contables está desactivada para la cola.
BOQNAME (nombre de la cola )
El nombre de reposición en cola de restitución excesivo.

Este parámetro recibe soporte solamente en colas locales y de modelo.

Utilice este parámetro para establecer o cambiar el atributo de nombre de cola de restitución de una cola local o modelo. Aparte de permitir que se consulte su valor, el gestor de colas no hace nada basándose en el valor de este atributo. IBM MQ classes for JMS transfiere un mensaje que se restituye el número máximo de veces a esta cola. El máximo se especifica mediante el parámetro " BOTHRESH ".

BOTHRESH(número entero )
El umbral de retroceso.
Este parámetro recibe soporte solamente en colas locales y de modelo.
Utilice este parámetro para establecer o cambiar el valor del atributo de umbral de retorno de una cola local o modelo. Aparte de permitir que se consulte su valor, el gestor de colas no hace nada basándose en el valor de este atributo. IBM MQ classes for JMS utilizar el atributo para determinar cuántas veces permitir que un mensaje sea retirado. Cuando se supera el valor, el mensaje se transfiere a la cola nombrada por el parámetro BOQNAME .
Especifique un valor en el rango 0 - 999.999.999.
[ MQ 9.4.0 Jun 2024][ MQ 9.4.0 Jun 2024]CAPEXPRY(número entero )
El tiempo máximo, expresado en décimas de segundo, hasta que un mensaje colocado utilizando un descriptor de objeto con este objeto en la vía de acceso de resolución, pasa a ser elegible para el proceso de caducidad.
[ MQ 9.4.0 Jun 2024][z/OS][ MQ 9.4.0 Jun 2024]Importante: No se puede especificar un valor entero para el CAPEXPRY atributo en un objeto de cola con QSGDISP ( COMPARTIDO | GRUPO | COPIA ), que reside en un grupo de uso compartido de colas que contiene administradores de colas que ejecutan cualquier versión de IBM MQ for z/OS por debajo de 9.4.0. Intentar hacerlo da como resultado CSQM532I y CSQM533I mensajes para identificar qué gestores de cola no admiten CAPEXPRY, y ninguna modificación del objeto.

Para obtener más información sobre el procesamiento de caducidad de mensajes, consulte CAPEXPRY: Limitar el tiempo de caducidad de los mensajes.

entero
El valor debe estar en el rango de uno a 999.999.999.
NOLIMIT
No hay límite en el tiempo de caducidad de los mensajes colocados utilizando este objeto. Éste es el valor predeterminado.
Si establece CAPEXPRY en NOLIMIT, también puede establecer el atributo CUSTOM CAPEXPRY .
Tenga en cuenta que los mensajes existentes en la cola, antes de un cambio en CAPEXPRY, no se ven afectados por el cambio (es decir, su hora de caducidad permanece sin cambios). Sólo los mensajes nuevos que se colocan en la cola después del cambio en CAPEXPRY tienen la nueva hora de caducidad.
[z/OS]CFSTRUCT(nombre de la estructura )
Especifica el nombre de la estructura de la instalación de acoplamiento en la que desea que se almacenen los mensajes cuando utilice colas compartidas.
Este parámetro sólo se admite en z/OS para colas locales y modelo.
El nombre:
  • No puede tener más de 12 caracteres
  • Debe empezar por una letra mayúscula (A - Z)
  • Puede incluir sólo los caracteres A - Z y 0 - 9
El nombre del grupo de compartición de colas al que está conectado el gestor de colas lleva como prefijo el nombre que proporcione. El nombre del grupo de compartición de colas es siempre de cuatro caracteres, rellenado con símbolos @ si es necesario. Por ejemplo, si utiliza un grupo de uso compartido de colas denominado NY03 y proporciona el nombre PRODUCT7, el nombre de la estructura de la instalación de acoplamiento resultante es NY03PRODUCT7. La estructura administrativa del grupo de colas compartidas (en este caso NY03CSQ_ADMIN) no puede utilizarse para almacenar mensajes.
Para ALTER QLOCAL, ALTER QMODEL, DEFINE QLOCAL con REPLACE, y DEFINE QMODEL con REPLACE se aplican las siguientes reglas:
  • En una cola local con QSGDISP(SHARED), CFSTRUCT no puede cambiar.
  • Si cambia el valor de CFSTRUCT o QSGDISP , deberá eliminar y redefinir la cola. Para conservar alguno de los mensajes de la cola, debe descargar los mensajes antes de eliminar la cola. Vuelva a cargar los mensajes después de redefinir la cola, o mueva los mensajes a otra cola.
  • En una cola de modelos con DEFTYPE(SHAREDYN), CFSTRUCT no puede estar en blanco.
  • En una cola local con un QSGDISP distinto de SHARED, o una cola modelo con un DEFTYPE distinto de SHAREDYN, el valor de CFSTRUCT no importa.
Para DEFINE QLOCAL con NOREPLACE y DEFINE QMODEL con NOREPLACE, la estructura de la instalación de acoplamiento:
  • En una cola local con QSGDISP(SHARED) o una cola modelo con DEFTYPE(SHAREDYN), CFSTRUCT no puede estar en blanco.
  • En una cola local con un QSGDISP distinto de SHARED, o una cola modelo con un DEFTYPE distinto de SHAREDYN, el valor de CFSTRUCT no importa.
Nota: Antes de poder utilizar la cola, la estructura debe estar definida en el conjunto de datos de la política de gestión de recursos de instalaciones de acoplamiento (CFRM).
CLCHNAME(nombre del canal )

Este parámetro sólo se admite en colas de transmisión.

CLCHNAME es el nombre genérico de los canales emisores del clúster que utilizan esta cola como cola de transmisión. El atributo especifica los canales de clúster emisor han enviado mensajes a un canal de clúster receptor desde esta cola de transmisión de clúster.
También puede establecer manualmente el atributo de la cola de transmisión CLCHNAME a un canal emisor de clúster. Los mensajes destinados al gestor de colas conectado por el canal de clúster emisor se almacenan en la cola de transmisión que identifica el canal de clúster emisor. No se almacenan en la cola de transmisión de clúster predeterminada. Si establece el atributo CLCHNAME en blanco, el canal cambia a la cola de transmisión de clúster predeterminada cuando se reinicia el canal. La cola por defecto es SYSTEM.CLUSTER.TRANSMIT.ChannelName o SYSTEM.CLUSTER.TRANSMIT.QUEUE, dependiendo del valor del atributo del gestor de colas DEFCLXQ .
Especificando asteriscos, " * ", en CLCHNAME, puede asociar una cola de transmisión a un conjunto de canales emisores de cluster. Los asteriscos pueden estar al principio, al final o en cualquier posición intermedia de la serie de nombre de canal. CLCHNAME tiene una longitud máxima de 48 caracteres, MQ_OBJECT_NAME_LENGTH. El nombre de un canal está limitado a 20 caracteres: MQ_CHANNEL_NAME_LENGTH. Si especifica un asterisco, también debe establecer el atributo SHARE para que varios canales puedan acceder simultáneamente a la cola de transmisión.
[z/OS] Si especifica un * en CLCHNAME, para obtener un nombre de perfil de canal, debe especificar el nombre de perfil de canal entre comillas. Si no especifica el nombre genérico del canal entre comillas, recibirá el mensaje CSQ9030E.
La configuración del gestor de colas predeterminado es para todos los canales de clúster emisor para enviar mensajes desde una sola cola de transmisión, SYSTEM.CLUSTER.TRANSMIT.QUEUE. La configuración por defecto puede modificarse cambiando el atributo del gestor de colas, DEFCLXQ. El valor predeterminado del atributo es SCTQ. Puede cambiar el valor a CHANNEL. Si establece el atributo DEFCLXQ en CHANNEL, cada canal emisor de clúster utiliza por defecto una cola de transmisión de clúster específica, SYSTEM.CLUSTER.TRANSMIT.ChannelName.
[z/OS]En z/OS, si se establece este parámetro, la cola:
  • Debe poder compartirse especificando el atributo SHARE de la cola.
  • Debe indexarse en el ID de correlación especificando INDXTYPE(CORRELID).
  • No debe ser una cola dinámica o compartida.
[AIX, Linux, Windows][z/OS]CLUSNL(namelist nombre )
El nombre de la lista de nombres que especifica una lista de clústeres a la que pertenece la cola.
Este parámetro sólo se admite en colas de alias, locales y remotas.
Los cambios que se realicen a este parámetro no afectarán a las instancias de la cola que ya estén abiertas.

Sólo uno de los valores resultantes de CLUSNL o CLUSTER puede ser no blanco; no se puede especificar un valor para ambos.

En las colas locales, este parámetro no puede establecerse para las colas siguientes:
  • Colas de transmisión
  • SYSTEM.CHANNEL.xx colas
  • SYSTEM.CLUSTER.xx colas
  • SYSTEM.COMMAND.xx colas
  • [z/OS]Sólo en z/OS , SYSTEM.QSG.xx colas
Este parámetro solo es válido en las plataformas siguientes:
  • AIX®, Linux®, and Windows
  • z/OS
[AIX, Linux, Windows][z/OS]CLUSTER(nombre del clúster )
El nombre del clúster al que pertenece la cola.
Este parámetro sólo se admite en colas de alias, locales y remotas.
La longitud máxima es de 48 caracteres, de conformidad con las normas para denominaciónIBM MQ de objetos. Los cambios que se realicen a este parámetro no afectarán a las instancias de la cola que ya estén abiertas.

Sólo uno de los valores resultantes de CLUSNL o CLUSTER puede ser no blanco; no se puede especificar un valor para ambos.

En las colas locales, este parámetro no puede establecerse para las colas siguientes:
  • Colas de transmisión
  • SYSTEM.CHANNEL.xx colas
  • SYSTEM.CLUSTER.xx colas
  • SYSTEM.COMMAND.xx colas
  • [z/OS]Sólo en z/OS , SYSTEM.QSG.xx colas
Este parámetro solo es válido en las plataformas siguientes:
  • AIX, Linux, and Windows
  • z/OS
CLWLPRTY(número entero )
Especifica la prioridad de la cola a efectos de la distribución de la carga de trabajo del clúster. Este parámetro sólo es válido para colas locales, remotas y de alias. El valor debe estar comprendido entre cero y 9, siendo cero la prioridad más baja y 9 la más alta. Para más información sobre este atributo, véase Atributo de cola CLWLPRTY.
CLWLRANK (número entero )
Especifica el rango de la cola a efectos de la distribución de la carga de trabajo del clúster. Este parámetro sólo es válido para colas locales, remotas y de alias. El valor debe estar comprendido entre cero y 9, siendo cero el rango más bajo y 9 el más alto. Para más información sobre este atributo, véase Atributo de cola CLWLRANK.
CLWLUSEQ
Especifica el comportamiento de una operación MQPUT cuando la cola de destino tiene una instancia local y al menos una instancia de clúster remota. El parámetro no tiene efecto cuando el MQPUT se origina en un canal de cluster. Este parámetro sólo es válido para las colas locales.
QMGR
El comportamiento es el especificado por el parámetro CLWLUSEQ de la definición del gestor de colas.
ANY
El gestor de colas debe tratar la cola local como una instancia más de la cola del clúster a efectos de distribución de la carga de trabajo.
LOCAL
La cola local es el único objetivo de la operación MQPUT .
[z/OS]CMDSCOPE
Este parámetro se aplica únicamente a z/OS. Especifica dónde se ejecuta el comando cuando el gestor de colas es miembro de un grupo de compartición de colas.
CMDSCOPE debe estar en blanco, o el gestor de colas local, si QSGDISP está configurado como GROUP o SHARED.
''
El comando se ejecuta en el gestor de colas en el que se introdujo.
QmgrName
El comando se ejecuta en el gestor de colas que especifiques, siempre que el gestor de colas esté activo dentro del grupo de colas compartidas.

Puede especificar un nombre de gestor de colas distinto del gestor de colas en el que se introdujo el comando. Puede especificar otro nombre, sólo si está utilizando un entorno de grupo de compartición de colas y si el servidor de comandos está activado.

*
El comando se ejecuta en el gestor de colas local y también se transmite a todos los gestores de colas activos del grupo de colas compartidas. El efecto de * es el mismo que el de introducir el comando en cada gestor de colas del grupo de colas compartidas.
CUSTOM(cadena )
Este atributo contiene los valores de los atributos, como pares de nombre y valor, separados por al menos un espacio.
Los pares nombre-valor de los atributos tienen la forma NOMBRE(VALOR). Los nombres de atributos que comienzan por IBM, AMQ, CSQ, o MQ están reservados para uso exclusivo de IBM . Los atributos reservados adicionales son CAPEXPRY, SQGETTMR, y PAGEVAL. Como administrador, puede establecer y utilizar otros nombres para sus propios fines.
La longitud máxima viene definida por la constante IBM MQ MQ_CUSTOM_LENGTH y está fijada en 128 en todas las plataformas.
El valor CUSTOM es una lista de cero o más pares de propiedades-valores, en sintaxis de estilo MQSC, separados por al menos un espacio. Los nombres y valores de las propiedades distinguen entre mayúsculas y minúsculas, y deben especificarse en mayúsculas. Los valores pueden contener espacios, paréntesis y comillas simples (que deben ir encerradas por otra comilla simple). Otros caracteres, incluidos los paréntesis anidados (), pueden incluirse encerrándolos entre dos comillas simples a cada lado. A continuación figuran ejemplos de sintaxis válida:
  • CUSTOM('')
  • CUSTOM('A(B)')
  • CUSTOM('C(D) E(F)')
  • CUSTOM('G(5000) H(''9.20.4.6(1415)'')')
La última sintaxis utiliza pares de comillas simples, no dobles.
[En desuso][ MQ 9.4.0 Jun 2024][ MQ 9.4.0 Jun 2024]Nota: A partir de IBM MQ 9.4.0, el atributo de cola CAPEXPRY sustituye el uso de la opción CAPEXPRY en el campo CUSTOM . No se puede establecer el atributo de cola CAPEXPRY si el atributo CUSTOM ya tiene definida la opción CAPEXPRY . Debe modificar las colas existentes para establecer el atributo de cola CAPEXPRY y desactivar la opción CAPEXPRY del atributo CUSTOM . Por ejemplo:
ALTER TOPIC(T1) CAPEXPRY(1000) CAPEXPRY('')
Para obtener más información sobre los valores permitidos, consulte CAPEXPRY.
DEFBIND
Especifica el enlace que se utilizará cuando la aplicación especifique MQOO_BIND_AS_Q_DEF en la llamada a MQOPEN y la cola sea una cola de clúster.
OPEN
Cuando se abre la cola, el manejador de cola se enlaza a una instancia específica de la cola de clúster.
NOTFIXED
El gestor de cola no está vinculado a ninguna instancia de la cola del clúster. El gestor de colas selecciona una instancia de cola específica cuando el mensaje se pone utilizando MQPUT. Cambia esa selección más tarde, si surge la necesidad.
GROUP
Permite que una aplicación solicite que un grupo de mensajes se asigne a la misma instancia de destino.
Se pueden anunciar varias colas con el mismo nombre en un clúster de gestores de colas. Una aplicación puede enviar todos los mensajes a una única instancia, MQOO_BIND_ON_OPEN. Puede permitir que un algoritmo de gestión de la carga de trabajo seleccione el destino más adecuado para cada mensaje, MQOO_BIND_NOT_FIXED. Puede permitir que una aplicación solicite que un grupo de mensajes se asigne a la misma instancia de destino. El equilibrio de la carga de trabajo vuelve a seleccionar un destino entre grupos de mensajes, sin necesidad de MQCLOSE y MQOPEN de la cola.
La llamada a MQPUT1 se comporta siempre como si se especificara NOTFIXED .
Este parámetro es válido en todas las plataformas.
DEFPRESP
Especifica el comportamiento que deben utilizar las aplicaciones cuando el tipo de respuesta put, dentro de las opciones de MQPMO , se establece en MQPMO_RESPONSE_AS_Q_DEF.
SYNC
Las operaciones Put a la cola especificando MQPMO_RESPONSE_AS_Q_DEF se emiten como si se especificara MQPMO_SYNC_RESPONSE en su lugar.
ASYNC
Las operaciones Put a la cola que especifica MQPMO_RESPONSE_AS_Q_DEF se emiten como si se especificara MQPMO_ASYNC_RESPONSE en su lugar; consulte Opciones de MQPMO (MQLONG).
DEFPRTY(número entero )
La prioridad por defecto de los mensajes puestos en la cola. El valor debe estar en el rango de 0 a 9. Cero es la prioridad más baja, hasta el parámetro MAXPRTY queue manager. El valor por defecto de MAXPRTY es 9.
DEFPSIST
Especifica la persistencia de mensajes que se utilizará cuando las aplicaciones especifiquen la opción MQPER_PERSISTENCE_AS_Q_DEF .
NO
Los mensajes de esta cola se pierden tras el reinicio del gestor de colas.
YES
Los mensajes de esta cola perduran tras el reinicio del gestor de colas.
[z/OS]En z/OS, N y Y se aceptan como sinónimos de NO y YES.
DEFREADA
Especifica el comportamiento predeterminado de lectura anticipada para los mensajes no persistentes entregados al cliente. Activar la lectura anticipada puede mejorar el rendimiento de las aplicaciones cliente que consumen mensajes no persistentes.
NO
Los mensajes no persistentes no se leen por adelantado a menos que la aplicación cliente esté configurada para solicitar la lectura por adelantado.
YES
Los mensajes no persistentes se envían al cliente antes de que una aplicación los solicite. Los mensajes no persistentes pueden perderse si el cliente finaliza de forma anormal o si no borra todos los mensajes que se le envían.
DISABLED
La lectura anticipada de mensajes no persistentes no está habilitada para esta cola. Los mensajes no se envían por adelantado al cliente, independientemente de si la aplicación cliente solicita la lectura por adelantado.
DEFSOPT
La opción de compartir por defecto para las aplicaciones que abren esta cola de entrada:
EXCL
La petición de apertura es para entrada exclusiva de la cola.
[z/OS]En z/OS, EXCL es el valor por defecto.
SHARED
La petición de apertura es para entrada compartida de la cola.
[UNIX, Linux, Windows, IBM i]En Multiplataformas, SHARED es el valor por defecto.
DEFTYPE
El tipo de definición de la cola.
Este parámetro sólo es compatible con las colas modelo.
PERMDYN
Se crea una cola dinámica permanente cuando una aplicación emite una llamada MQI a MQOPEN con el nombre de esta cola modelo especificado en el descriptor de objeto (MQOD).

[z/OS]En z/OS, la cola dinámica tiene una disposición de QMGR.

[z/OS]SHAREDYN
Esta opción sólo está disponible en z/OS .
Se crea una cola dinámica permanente cuando una aplicación emite una llamada a la API MQOPEN con el nombre de este modelo de cola especificado en el descriptor de objeto (MQOD).
La cola dinámica tiene una disposición de SHARED.
TEMPDYN
Se crea una cola dinámica temporal cuando una aplicación emite una llamada a la API MQOPEN con el nombre de esta cola modelo especificado en el descriptor de objeto (MQOD).
[z/OS]En z/OS, la cola dinámica tiene una disposición de QMGR.
[z/OS]No especifique este valor para una definición de cola de modelo con un parámetro DEFPSIST de YES.
[z/OS]Si especifica esta opción, no especifique INDXTYPE(MSGTOKEN).
DESCR(cadena )
Comentario en texto sin formato. Proporciona información descriptiva sobre el objeto cuando un operador emite el comando DISPLAY QUEUE .
Debe contener sólo caracteres visualizables. La longitud máxima es de 64 caracteres. En una instalación DBCS, contiene caracteres DBCS (sujetos a una longitud máxima de 64 bytes).
Nota: Utilice caracteres que estén en el identificador de conjunto de caracteres codificados (CCSID) de este gestor de colas. Si no lo hace y si la información se envía a otro gestor de colas, podrían traducirse incorrectamente.
[AIX, Linux, Windows]DISTL
Establece si el gestor de colas asociado admite listas de distribución.
YES
El gestor de colas asociado admite listas de distribución.
NO
El gestor de colas asociado no admite listas de distribución.
Nota: Normalmente no se modifica este parámetro, ya que lo establece el MCA. Sin embargo, puede establecer este parámetro al definir una cola de transmisión si se conoce la capacidad de la lista de distribución del gestor de colas de destino.
Este parámetro sólo es válido en AIX, Linux, and Windows.
FORCE
Este parámetro sólo se aplica al comando ALTER en colas de alias, locales y remotas.
Especifique este parámetro para forzar la finalización del comando en las siguientes circunstancias.
Para una cola de alias, si las dos afirmaciones siguientes son verdaderas:
  • El parámetro TARGET especifica una cola
  • Una aplicación tiene abierta esta cola de alias
Para una cola local, si las dos afirmaciones siguientes son verdaderas:
  • Se especifica el parámetro NOSHARE
  • Más de una aplicación tiene la cola de entrada abierta
FORCE también es necesario si las dos afirmaciones siguientes son ciertas:
  • Se modifica el parámetro USAGE
  • Hay uno o varios mensajes en la cola, o una o varias aplicaciones tienen la cola abierta

No modifique el parámetro USAGE mientras haya mensajes en la cola; el formato de los mensajes cambia cuando se ponen en una cola de transmisión.

Para una cola remota, si las dos afirmaciones siguientes son verdaderas:
  • Se modifica el parámetro XMITQ
  • Una o más aplicaciones tienen esta cola abierta como cola remota
FORCE también es necesario si las dos afirmaciones siguientes son ciertas:
  • Se modifica cualquiera de los parámetros RNAME, RQMNAME, o XMITQ
  • Una o más aplicaciones tienen una cola abierta que resolvieron a través de esta definición como un alias de gestor de colas
Nota: FORCE no es necesario si esta definición se utiliza únicamente como alias de cola de respuesta.

Si no se especifica FORCE en las circunstancias descritas, el comando no tiene éxito.

Cuando se utiliza el comando ALTER QLOCAL con el parámetro FORCE , IBM MQ fuerza a permitir los cambios con handles abiertos en la cola. Sin embargo, estos gestores abiertos existentes dejan de ser válidos para algunos atributos y la siguiente operación en estos gestores abiertos devolverá el mensaje de error:
MQRC_OBJETO_MODIFICADO (2041)
Cualquiera de las siguientes operaciones fallará con el error MQRC 2041 :
  • MQPUT
  • MQGET
  • MQINQ
  • MQSET
  • MQCTL
  • MQCB
Puede corregir las aplicaciones que reciben el errorMQRC_OBJECT_CHANGEDmediante los siguientes pasos:
  1. Cerrar el tirador (MQCLOSE)
  2. Vuelva a abrir el objeto (MQOPEN) para seleccionar la nueva definición de cola
GET
Especifica si se debe permitir a las aplicaciones obtener mensajes de esta cola:
ENABLED
Las aplicaciones debidamente autorizadas pueden recuperar mensajes de la cola.
DISABLED
Las aplicaciones no pueden recuperar mensajes de la cola.
Este parámetro también puede modificarse mediante la llamada a la API MQSET .
HARDENBO y NOHARDENBO
Especifica si se endurece el recuento del número de veces que un mensaje ha sido retirado. Cuando se endurece el recuento, el valor del campo BackoutCount del descriptor de mensaje se escribe en el registro antes de que el mensaje sea devuelto por una operación MQGET. Al escribir el valor en el registro se garantiza que el valor sea preciso en todos los reinicios del gestor de colas.
Este parámetro recibe soporte solamente en colas locales y de modelo.
Cuando se endurece el recuento de backout, el rendimiento de las operaciones MQGET para mensajes persistentes en esta cola se ve afectado.
HARDENBO
El recuento de mensajes en esta cola está reforzado para garantizar que el recuento es preciso.
NOHARDENBO
El recuento de mensajes devueltos de esta cola no está reforzado y podría no ser preciso durante los reinicios del gestor de colas.
[z/OS]Nota: Este parámetro sólo afecta a z/OS. Puede configurar este parámetro en Multiplataformas pero no es efectivo.
[UNIX, Linux, Windows, IBM i]IMGRCOVQ
Especifica si un objeto de cola dinámico local o permanente se puede recuperar de una imagen multimedia, si se está utilizando el registro lineal. Los valores posibles son:
SÍ
Estos objetos de cola se pueden recuperar.
NO
Los comandos rcdmqimg (grabar imagen multimedia) yrcrmqobj (volver a crear objeto) no están permitidos para estos objetos, y las imágenes multimedia automáticas, si están activadas, no se escriben para estos objetos.
QMGR
Si especifica QMGR, y el atributo IMGRCOVQ para el gestor de colas especifica YES, estos objetos de cola son recuperables.
Si especifica QMGR, y el atributo IMGRCOVQ para el gestor de colas especifica NO, los comandos rcdmqimg (grabar imagen multimedia) yrcrmqobj (volver a crear objeto) no están permitidos para estos objetos, y las imágenes multimedia automáticas, si están activadas, no se escriben para estos objetos.
QMGR es el valor por omisión.
Este parámetro no es válido en z/OS.
[z/OS]INDXTYPE
Tipo de índice que mantiene el gestor de colas para agilizar las operaciones de MQGET en la cola. Para las colas compartidas, el tipo de índice determina el tipo de operaciones MQGET que pueden utilizarse.
Este parámetro sólo se admite en z/OS.
Este parámetro recibe soporte solamente en colas locales y de modelo.
Los mensajes sólo pueden recuperarse utilizando un criterio de selección si se mantiene un tipo de índice apropiado, como muestra la tabla siguiente:
Tabla 2. Tipo de índice necesario para diferentes criterios de selección de la recuperación
Criterio de selección de la recuperación Tipo de índice requerido
  Cola compartida Otra cola
Ninguna (recuperación secuencial) Cualquiera Cualquiera
Identificador de mensaje MSGID o NONE Cualquiera
Identificador de correlación CORRELID Cualquiera
Identificadores de mensajes y correlaciones MSGID o CORRELID Cualquiera
Identificador de grupo GROUPID Cualquiera
Agrupación GROUPID GROUPID
Señal de mensaje No permitido MSGTOKEN
donde el valor del parámetro INDXTYPE tiene los siguientes valores:
NONE
No se mantiene ningún índice. Utilice NONE cuando los mensajes suelen recuperarse secuencialmente o utilice tanto el identificador del mensaje como el identificador de correlación como criterio de selección en la llamada a MQGET .
MSGID
Se mantiene un índice de los identificadores de mensaje. Utilice MSGID cuando los mensajes se recuperan normalmente utilizando el identificador del mensaje como criterio de selección en la llamada a MQGET con el identificador de correlación establecido en NULL.
CORRELID
Se mantiene un índice de identificadores de correlación. Utilice CORRELID cuando los mensajes se recuperan normalmente utilizando el identificador de correlación como criterio de selección en la llamada a MQGET con el identificador de mensaje establecido en NULL.
GROUPID
Se mantiene un índice de identificadores de grupo. Utilice GROUPID cuando los mensajes se recuperen utilizando criterios de selección de agrupación de mensajes.
Nota:
  1. No puede establecer INDXTYPE en GROUPID si la cola es una cola de transmisión.
  2. La cola debe utilizar una estructura CF en CFLEVEL(3), para especificar una cola compartida con INDXTYPE(GROUPID).
[z/OS] MSGTOKEN
Se mantiene un índice de las señales de mensaje. Utilice MSGTOKEN cuando la cola sea una cola gestionada por WLM que esté utilizando con las funciones de Workload Manager de z/OS.
Nota: No puede configurar INDXTYPE en MSGTOKEN si:
  • La cola es una cola modelo con un tipo de definición de SHAREDYN
  • La cola es una cola dinámica temporal
  • La cola es una cola de transmisión
  • Especifique QSGDISP(SHARED)
Para las colas que no son compartidas y no utilizan agrupación o fichas de mensajes, el tipo de índice no restringe el tipo de selección de recuperación. Sin embargo, el índice se utiliza para agilizar las operaciones de GET en la cola, así que elija el tipo que corresponda a la selección de recuperación más habitual.
Si está modificando o sustituyendo una cola local existente, puede cambiar el parámetro INDXTYPE sólo en los casos indicados en la siguiente tabla:
Tabla 3. Se permite el cambio de tipo de índice en función del reparto de colas y de la presencia de mensajes en la cola
Tipo de cola NO COMPARTIDO SHARED
Estado de cola Actividad no comprometida Ninguna actividad no comprometida, mensajes presentes Sin actividad no comprometida y vacía Abierto o mensajes presentes No abierto, y vacío
Cambia INDXTYPE de: A: ¿Se permite el cambio?
NONE MSGID No Sí Sí No Sí
NONE CORRELID No Sí Sí No Sí
NONE MSGTOKEN No No Sí - -
NONE GROUPID No No Sí No Sí
MSGID NONE No Sí Sí No Sí
MSGID CORRELID No Sí Sí No Sí
MSGID MSGTOKEN No No Sí - -
MSGID GROUPID No No Sí No Sí
CORRELID NONE No Sí Sí No Sí
CORRELID MSGID No Sí Sí No Sí
CORRELID MSGTOKEN No No Sí - -
CORRELID GROUPID No No Sí No Sí
MSGTOKEN NONE No Sí Sí - -
MSGTOKEN MSGID No Sí Sí - -
MSGTOKEN CORRELID No Sí Sí - -
MSGTOKEN GROUPID No No Sí - -
GROUPID NONE No No Sí No Sí
GROUPID MSGID No No Sí No Sí
GROUPID CORRELID No No Sí No Sí
GROUPID MSGTOKEN No No Sí - -
En una cola privada, el mantenimiento de un índice cuando la cola contiene un gran número de mensajes puede utilizar un almacenamiento significativo de 64 bits. Consulte Colas indexadas para obtener más información.
INITQ(cadena )
El nombre local de la cola de iniciación en este gestor de colas, en la que se escriben los mensajes de activación relacionados con esta cola. Véanse las reglas de denominación de los objetos IBM MQ .
Este parámetro recibe soporte solamente en colas locales y de modelo.
LIKE(qtype-nombre )
El nombre de una cola, con parámetros que se utilizan para modelar esta definición.
Si no se completa este campo, los valores de los campos de parámetros no definidos se toman de una de las siguientes definiciones. La elección depende del tipo de cola:
Tabla 4. Tipos de colas y sus correspondientes definiciones
Tipo de cola Definición
Cola alias SYSTEM.DEFAULT.ALIAS.QUEUE
Cola local SYSTEM.DEFAULT.LOCAL.QUEUE
Cola modelo SYSTEM.DEFAULT.MODEL.QUEUE
Cola remota SYSTEM.DEFAULT.REMOTE.QUEUE
Por ejemplo, no completar este parámetro equivale a definir el siguiente valor de LIKE para una cola de alias:
LIKE(SYSTEM.DEFAULT.ALIAS.QUEUE)
Si necesita definiciones por defecto diferentes para todas las colas, modifique las definiciones por defecto de las colas en lugar de utilizar el parámetro LIKE .
[z/OS]En z/OS, el gestor de colas busca un objeto con el nombre y el tipo de cola que especifique con una disposición de QMGR, COPY o SHARED. La disposición del objeto LIKE no se copia en el objeto que está definiendo.
Nota:
  1. QSGDISP(GROUP) no se buscan objetos.
  2. LIKE se ignora si se especifica QSGDISP(COPY).
[AIX, Linux, Windows][z/OS]MAXDEPTH(número entero )
El número máximo de mensajes permitidos en la cola.
Este parámetro recibe soporte solamente en colas locales y de modelo.
En las siguientes plataformas, especifique un valor comprendido entre cero y 999999999:
  • [AIX, Linux, Windows]AIX, Linux, and Windows
  • [z/OS]z/OS
En cualquier otra plataforma IBM MQ , especifique un valor comprendido entre cero y 640000.
Otros factores pueden hacer que la cola se considere llena, por ejemplo, si no hay más espacio disponible en el disco duro.
Si se reduce este valor, los mensajes que ya están en la cola y que superan el nuevo máximo permanecen intactos.
[UNIX, Linux, Windows, IBM i]MAXFSIZE
El tamaño máximo, en megabytes, que puede alcanzar un archivo de cola. Es posible que un archivo de cola supere este tamaño si ha configurado el valor para que sea inferior al tamaño actual del archivo de cola.
Si esto ocurre, el archivo de cola ya no acepta nuevos mensajes, pero permite que se consuman los mensajes existentes. Cuando el tamaño del archivo de cola ha caído por debajo del valor configurado, se pueden poner nuevos mensajes en la cola.
Nota: Esta cifra puede diferir del valor del atributo configurado en la cola, ya que internamente el gestor de colas puede necesitar utilizar un tamaño de bloque mayor para alcanzar el tamaño elegido. Ver Modificación IBM MQ archivos de cola para obtener más información sobre cómo cambiar el tamaño de los archivos de cola y el tamaño y granularidad del bloque.
Cuando es necesario modificar la granularidad porque se ha incrementado este atributo, mensaje de advertencia AMQ7493WGranularity changedse escribe en los registros AMQERR. Esto le indica que debe planificar el vaciado de la cola para que IBM MQ adopte la nueva granularidad.
Especifique un valor mayor o igual a 20 y menor o igual a 267.386.880.
El valor por defecto de este atributo es DEFAULT, que equivale a un valor codificado de 2.088.960 MB, el máximo para una cola en las versiones de IBM MQ anteriores a IBM MQ 9.1.5.
MAXMSGL(número entero )
La longitud máxima (en bytes) de los mensajes en esta cola.
Este parámetro recibe soporte solamente en colas locales y de modelo.
[AIX, Linux, Windows]En AIX, Linux, and Windows, especifique un valor comprendido entre cero y la longitud máxima de mensaje para el gestor de colas. Véase el parámetro MAXMSGL del comando ALTER QMGR , ALTER QMGR MAXMSGL.
[z/OS]En z/OS, especifique un valor comprendido entre cero y 100 MB (104 857 600 bytes).
La longitud del mensaje incluye la longitud de los datos del usuario y la longitud de las cabeceras. Para los mensajes puestos en la cola de transmisión, hay cabeceras de transmisión adicionales. Permita 4000 bytes adicionales para todas las cabeceras de los mensajes.
Si se reduce este valor, los mensajes que ya estén en la cola con una longitud superior al nuevo máximo no se verán afectados.
Las aplicaciones pueden utilizar este parámetro para determinar el tamaño del búfer para recuperar mensajes de la cola. Por lo tanto, el valor sólo puede reducirse si se sabe que esta reducción no provoca un funcionamiento incorrecto de la aplicación.
Tenga en cuenta que al añadir la firma digital y la clave al mensaje, Advanced Message Security aumenta la longitud del mensaje.
MONQ
Controla la recopilación de los datos de supervisión para las colas.
Este parámetro recibe soporte solamente en colas locales y de modelo.
QMGR
Recopilar datos de supervisión según la configuración del parámetro del gestor de colas MONQ.
OFF
La recopilación de datos de supervisión en línea está desactivada para esta cola.
LOW
Si el valor del parámetro MONQ del gestor de colas no es NONE, la recopilación de datos de supervisión en línea se activa para esta cola.
MEDIUM
Si el valor del parámetro MONQ del gestor de colas no es NONE, la recopilación de datos de supervisión en línea se activa para esta cola.
HIGH
Si el valor del parámetro MONQ del gestor de colas no es NONE, la recopilación de datos de supervisión en línea se activa para esta cola.
No hay distinción entre los valores LOW, MEDIUM, y HIGH. Todos estos valores activan la recogida de datos, pero no afectan al ritmo de recogida.
Cuando se utiliza este parámetro en un comando de cola ALTER , el cambio sólo es efectivo la próxima vez que se abra la cola.
MSGDLVSQ
Secuencia de entrega de mensajes.
Este parámetro recibe soporte solamente en colas locales y de modelo.
PRIORITY
Los mensajes se entregan (en respuesta a las llamadas a la API MQGET ) en el orden FIFO (primero en entrar, primero en salir) dentro de la prioridad.
FIFO
Los mensajes se entregan (en respuesta a las llamadas a la API MQGET ) en orden FIFO. La prioridad se ignora para los mensajes de esta cola.
El parámetro de secuencia de entrega de mensajes puede cambiarse de PRIORITY a FIFO mientras haya mensajes en la cola. El orden de los mensajes que ya están en la cola no se modifica. Los mensajes añadidos posteriormente a la cola tienen la prioridad por defecto de la cola, por lo que podrían procesarse antes que algunos de los mensajes existentes.
Si la secuencia de entrega de mensajes se cambia de FIFO a PRIORITY, los mensajes puestos en la cola mientras ésta estaba configurada en FIFO toman la prioridad por defecto.
[z/OS]Nota: Si se especifica INDXTYPE(GROUPID) con MSGDLVSQ(PRIORITY), la prioridad en la que se recuperan los grupos se basa en la prioridad del primer mensaje dentro de cada grupo. El gestor de colas utiliza las prioridades 0 y 1 para optimizar la recuperación de mensajes en orden lógico. El primer mensaje de cada grupo no debe utilizar estas prioridades. En caso afirmativo, el mensaje se almacena como si fuera de prioridad dos.
[UNIX, Linux, Windows, IBM i]NPMCLASS
El nivel de fiabilidad que se asignará a los mensajes no persistentes que se pongan en cola:
NORMAL
Los mensajes no persistentes se pierden tras un fallo o el cierre del gestor de colas. Estos mensajes se descartan al reiniciar el gestor de colas.
HIGH
El gestor de colas intenta retener los mensajes no persistentes en esta cola durante un reinicio o conmutación del gestor de colas.
[z/OS]No es posible configurar este parámetro en z/OS.
[ MQ 9.4.3 Jun 2025][z/OS]OTELPCTL
Si el gestor de colas propaga automáticamente el contexto de seguimiento desde el entorno de la aplicación al mensaje en MQPUT, o desde el mensaje al entorno en MQGET.

Puede ser uno de los valores siguientes:

QMGR
Se utiliza el valor de OTELPCTL en el gestor de colas. Este es el valor predeterminado.
MANUAL
La propagación automática no se produce. Si es necesario, las aplicaciones pueden propagar manualmente las propiedades del contexto de rastreo.
AUTOMÁTICA
La propagación automática se produce si la aplicación se encuentra en un entorno que admite la propagación automática.

Si el gestor de colas está en un grupo de uso compartido de colas y la cola tiene un QSGDISP de SHARED, COPY o GROUP, este valor solo se puede establecer si todos los gestores de colas se han iniciado en IBM MQ 9.4.3 o posterior. De lo contrario, el comando falla y se emiten los CSQM533I mensajes CSQM532I y en el registro de tareas del gestor de colas, para identificar los gestores de colas que no admiten OTELPCTL.

Para más información sobre la propagación automática, véase Propagación de trazas.

Este parámetro sólo es válido en z/OS.

[ MQ 9.4.3 Jun 2025][z/OS]OTELTRAC
Si el gestor de colas emite spans cuando se envían o consumen mensajes de esta cola.

Puede ser uno de los valores siguientes:

QMGR
Se utiliza el valor de OTELTRAC en el gestor de colas. Este es el valor predeterminado.
OFF
Los espacios no se emiten aunque los mensajes tengan contexto de rastreo.
ON
Los espacios se emiten si los mensajes tienen contexto de rastreo.

Para obtener más información sobre la emisión de span, consulte Emisión de span.

Este parámetro sólo es válido en z/OS.

PROCESS(cadena )
El nombre local del proceso IBM MQ .
Este parámetro recibe soporte solamente en colas locales y de modelo.
Este parámetro es el nombre de una instancia de proceso que identifica la aplicación iniciada por el gestor de colas cuando se produce un evento desencadenante; consulte Reglas para nombrar objetos IBM MQ .
La definición del proceso no se comprueba cuando se define la cola local, pero debe estar disponible para que se produzca un evento desencadenante.
Si se trata de una cola de transmisión, la definición del proceso contiene el nombre del canal que debe iniciarse. Este parámetro es opcional para las colas de transmisión de las siguientes plataformas:
  • [IBM i]IBM i
  • [AIX, Linux, Windows]AIX, Linux, and Windows
  • [z/OS]z/OS
Si no lo especifica, el nombre del canal se toma del valor especificado para el parámetro TRIGDATA .
PROPCTL
Atributo de control de la propiedad. El atributo es opcional. Es aplicable a colas locales, de alias y de modelo.
Nota: Si su aplicación está abriendo una cola de alias, debe establecer este valor tanto en la cola de alias como en la de destino.
PROPCTL son las siguientes. Las opciones no afectan a las propiedades de los mensajes en la extensión MQMD o MQMD .
ALL

Configure ALL para que una aplicación pueda leer todas las propiedades del mensaje, ya sea en las cabeceras de MQRFH2 , o como propiedades del manejador del mensaje.

La opción ALL permite a las aplicaciones que no pueden modificarse acceder a todas las propiedades de los mensajes desde las cabeceras MQRFH2 . Las aplicaciones que pueden ser modificadas, pueden acceder a todas las propiedades del mensaje como propiedades del manejador del mensaje.

En algunos casos, el formato de los datos de las cabeceras MQRFH2 en el mensaje recibido puede ser diferente al formato del mensaje cuando se envió.

COMPAT
Establece COMPAT para que las aplicaciones no modificadas que esperan que las propiedades relacionadas con JMS estén en una cabecera MQRFH2 en los datos del mensaje sigan funcionando como antes. Las aplicaciones que pueden ser modificadas, pueden acceder a todas las propiedades del mensaje como propiedades del manejador del mensaje.
Si el mensaje contiene una propiedad con prefijo mcd., jms., usr., o mqext., todas las propiedades del mensaje se entregan a la aplicación. Si no se proporciona ningún manejador de mensaje, las propiedades se devuelven en una cabecera MQRFH2 . Si se proporciona un manejador de mensaje, todas las propiedades se devuelven en el manejador de mensaje.
Si el mensaje no contiene una propiedad con uno de esos prefijos, y la aplicación no proporciona un manejador de mensaje, no se devuelve ninguna propiedad de mensaje a la aplicación. Si se proporciona un manejador de mensaje, todas las propiedades se devuelven en el manejador de mensaje.

En algunos casos, el formato de los datos de las cabeceras MQRFH2 en el mensaje recibido puede ser diferente al formato del mensaje cuando se envió.

FORCE
Obliga a todas las aplicaciones a leer las propiedades de los mensajes de las cabeceras de MQRFH2 .
Las propiedades siempre se devuelven en los datos del mensaje en una cabecera MQRFH2 independientemente de si la aplicación especifica un manejador de mensaje.
Se ignora un manejador de mensaje válido suministrado en el campo MsgHandle de la estructura MQGMO en la llamada a MQGET . Las propiedades del mensaje no son accesibles mediante el manejador del mensaje.

En algunos casos, el formato de los datos de las cabeceras MQRFH2 en el mensaje recibido puede ser diferente al formato del mensaje cuando se envió.

NONE
Si se proporciona un manejador de mensaje, todas las propiedades se devuelven en el manejador de mensaje.
Todas las propiedades del mensaje se eliminan del cuerpo del mensaje antes de entregarlo a la aplicación.
PUT
Indica si pueden transferirse mensajes a la cola.
ENABLED
Se pueden añadir mensajes a la cola (mediante aplicaciones debidamente autorizadas).
DISABLED
No se pueden añadir mensajes a la cola.
Este parámetro también puede modificarse mediante la llamada a la API MQSET .
QDEPTHHI(número entero )
El umbral con el que se compara la profundidad de la cola para generar un evento de profundidad de cola alta.
Este parámetro recibe soporte solamente en colas locales y de modelo.
[z/OS]Para obtener más información sobre el efecto que tienen las colas z/OS compartidas en sobre este evento, consulte Colas compartidas y eventos de profundidad de cola en z/OS.
Este evento indica que una aplicación puso un mensaje en una cola resultando en que el número de mensajes en la cola sea mayor o igual al umbral alto de profundidad de cola. Consulte el parámetro QDPHIEV .
El valor se expresa como porcentaje de la profundidad máxima de la cola (parámetroMAXDEPTH ), y debe estar comprendido entre cero y 100 y no ser inferior a QDEPTHLO.
QDEPTHLO(número entero )
El umbral con el que se compara la profundidad de la cola para generar un evento de profundidad de cola baja.
Este parámetro recibe soporte solamente en colas locales y de modelo.
[z/OS]Para obtener más información sobre el efecto que tienen las colas z/OS compartidas en sobre este evento, consulte Colas compartidas y eventos de profundidad de cola en z/OS.
Este evento indica que una aplicación recuperó un mensaje de una cola resultando en que el número de mensajes en la cola sea menor o igual al umbral bajo de profundidad de cola. Consulte el parámetro QDPLOEV .
El valor se expresa como porcentaje de la profundidad máxima de la cola (parámetroMAXDEPTH ), y debe estar comprendido entre cero y 100 y no ser superior a QDEPTHHI.
QDPHIEV
Controla si se generan eventos de profundidad de cola alta.
Este parámetro recibe soporte solamente en colas locales y de modelo.
Un evento de Profundidad de Cola Alta indica que una aplicación puso un mensaje en una cola resultando en que el número de mensajes en la cola sea mayor o igual al umbral de profundidad de cola alta. Consulte el parámetro QDEPTHHI .
ENABLED
Se generan sucesos de profundidad alta de cola.
DISABLED
No se generan sucesos de profundidad alta de cola.
Nota: El valor de este parámetro puede cambiar implícitamente.

[z/OS]En z/OS, las colas compartidas afectan al evento.

Para obtener más información sobre este evento, consulte Profundidad de cola alta.
QDPLOEV
Controla si se generan eventos de profundidad de cola baja.
Este parámetro recibe soporte solamente en colas locales y de modelo.
Un evento de Profundidad de Cola Baja indica que una aplicación recuperó un mensaje de una cola resultando en que el número de mensajes en la cola sea menor o igual al umbral de profundidad de cola baja. Consulte el parámetro QDEPTHLO .
ENABLED
Se generan sucesos de profundidad baja de cola.
DISABLED
No se generan sucesos de profundidad baja de cola.
Nota: El valor de este parámetro puede cambiar implícitamente.

[z/OS]En z/OS, las colas compartidas afectan al evento.

Para obtener más información sobre este evento, consulte Profundidad de cola baja.
QDPMAXEV
Controla si se generan eventos de Cola Llena.
Este parámetro recibe soporte solamente en colas locales y de modelo.
Un evento Cola llena indica que un envío a una cola ha sido rechazado porque la cola está llena. La profundidad de la cola ha alcanzado su valor máximo.
ENABLED
Se generan sucesos de cola llena.
DISABLED
No se generan sucesos de cola llena.
Nota: El valor de este parámetro puede cambiar implícitamente.

[z/OS]En z/OS, las colas compartidas afectan al evento.

Para más información sobre este evento, consulte Cola llena.
[z/OS]QSGDISP
Este parámetro se aplica únicamente a z/OS.

Especifica la disposición del objeto dentro del grupo.

Tabla 5. Disposiciones de objeto para QSGDISP opciones
QSGDISP DEFINE
Copiar

El objeto se define en el conjunto de páginas del gestor de colas que ejecuta el mandato. Utiliza el objeto GROUP (GRUPO) ( QSGDISP) del mismo nombre que el objeto LIKE.

Por ejemplo, si emite el mandato siguiente,
DEFINE QUEUE(q_name)
REPLACE QSGDISP(COPY)
el gestor de colas busca en el repositorio de configuración compartida una definición de QUEUE denominada q_name. Si se encuentra una definición de QUEUE coincidente, el gestor de colas crea una copia local de esta definición en el conjunto de páginas del gestor de colas.

Para las colas locales, los mensajes se almacenan en los conjuntos de páginas de cada gestor de colas y sólo están disponibles a través de dicho gestor de colas.
Grupo

La definición de objeto reside en el repositorio de configuración compartido. QSGDISP(GRUPO ) solo se permite si el administrador de la cola está en un grupo de cola compartida.

Si el mandato DEFINE para el objeto QSGDISP(GROUP) es satisfactorio, se genera el mandato DEFINE QUEUE(q_name) REPLACE QSGDISP(COPY) y se envía a todos los gestores de colas activos del grupo de compartición de colas para realizar o renovar copias locales en el conjunto de páginas cero.

El DEFINE para el objeto de grupo tiene efecto independientemente de si falla el comando generado con QSGDISP(COPY ).
private No permitido.
QMGR

El objeto se define en el conjunto de páginas del gestor de colas que ejecuta el mandato.
compartidas Esta opción sólo se aplica a las colas locales. El objeto se define en el repositorio compartido. Los mensajes se almacenan en el recurso de acoplamiento y están disponibles para cualquier gestor de colas del grupo de compartición de colas. Sólo puede especificar SHARED si:
  • CFSTRUCT no está en blanco
  • INDXTYPE no es MSGTOKEN
  • La cola no es:
    • SYSTEM.CHANNEL.INITQ
    • SYSTEM.COMMAND.INPUT
Si la cola está en clúster, se genera un mandato. El mandato se envía a todos los gestores de colas activos del grupo de compartición de colas para notificarles de esta cola compartida en clúster.
QSVCIEV
Controla si se generan eventos de Intervalo de Servicio Alto o Intervalo de Servicio OK.
Este parámetro sólo se admite en colas locales y modelo y no es efectivo si se especifica en una cola compartida.
Se genera un evento Intervalo de servicio alto cuando una comprobación indica que no se han recuperado mensajes de la cola durante al menos el tiempo indicado por el parámetro QSVCINT .
Se genera un evento de Intervalo de servicio OK cuando una comprobación indica que se han recuperado mensajes de la cola en el tiempo indicado por el parámetro QSVCINT .
Nota: El valor de este parámetro puede cambiar implícitamente. Para obtener más información, consulte la descripción de los eventos Intervalo de servicio alto e Intervalo de servicio correcto en Intervalo de servicio de cola alto e Intervalo de servicio de cola correcto.
HIGH
Intervalo de servicio Se generan eventos altos
OK
Se generan eventos de intervalo de servicio OK
NONE
No se generan eventos de intervalo de servicio
QSVCINT(número entero )
El intervalo de servicio utilizado como comparación para generar los eventos Intervalo de servicio alto e Intervalo de servicio OK.
Este parámetro sólo se admite en colas locales y modelo y no es efectivo si se especifica en una cola compartida.
Consulte el parámetro QSVCIEV .
El valor está en unidades de milisegundos, y debe estar en el rango de cero a 999999999.
REPLACE & NOREPLACE
Esta opción controla si cualquier definición existente se va a sustituir por esta.
[z/OS]Nota: En IBM MQ for z/OS, una definición existente solo se sustituye si tiene la misma disposición. Cualquier objeto con una disposición diferente no se cambia.
REPLACE
Si el objeto existe, el efecto es como emitir el mandato ALTER sin el parámetro FORCE y con todos los demás parámetros especificados. En concreto, tenga en cuenta que los mensajes que están en la cola existente se conservan.

Existe una diferencia entre el mandato ALTER sin el parámetro FORCE y el mandato DEFINE con el parámetro REPLACE . La diferencia es que ALTER no cambia los parámetros no especificados, pero DEFINE con REPLACE establece todos los parámetros. Si utiliza REPLACE, los parámetros no especificados se toman del objeto especificado en el parámetro LIKE , o de la definición predeterminada, y los parámetros del objeto que se está sustituyendo, si existe uno, se ignoran.

El mandato falla si se cumplen las dos sentencias siguientes:
  • El mandato establece parámetros que requerirían el uso del parámetro FORCE si estuviera utilizando el mandato ALTER
  • El objeto está abierto

El mandato ALTER con el parámetro FORCE se ejecuta correctamente en esta situación.

[AIX, Linux, Windows]Si se SCOPEespecifica ( CELL ) en AIX, Linux, and Windowsy ya existe una cola con el mismo nombre en el directorio de celdas, el comando falla, incluso si REPLACE se especifica.

NOREPLACE
La definición no debe sustituir ninguna definición existente del objeto.
RETINTVL(número entero )
El número de horas desde que se definió la cola, después de las cuales la cola ya no es necesaria. El valor debe estar comprendido entre 0 y 999.999.999.
Este parámetro recibe soporte solamente en colas locales y de modelo.
El CRDATE y el CRTIME se pueden mostrar utilizando el DISPLAY QUEUE comando.
Esta información está disponible para que la utilice un operador o una aplicación de mantenimiento para eliminar las colas que ya no sean necesarias.
Nota: El gestor de colas no elimina colas basándose en este valor, ni impide que se eliminen colas si su intervalo de retención no ha expirado. Es responsabilidad del usuario tomar las medidas necesarias.
RNAME(cadena )
Nombre de la cola remota. Este parámetro es el nombre local de la cola definido en el gestor de colas especificado por RQMNAME.
Este parámetro sólo se admite en colas remotas.
  • Si esta definición se utiliza para una definición local de una cola remota, RNAME no debe estar en blanco cuando se produzca la apertura.
  • Si esta definición se utiliza para una definición de alias de gestor de colas, RNAME debe estar en blanco cuando se produzca la apertura.

    En un clúster de gestores de colas, esta definición sólo se aplica al gestor de colas que la ha realizado. Para anunciar el alias a todo el clúster, añada el atributo CLUSTER a la definición de la cola remota.

  • Si esta definición se utiliza para un alias de cola de respuesta, este nombre es el nombre de la cola que será la cola de respuesta.
El nombre no se comprueba para garantizar que sólo contiene los caracteres normalmente permitidos para los nombres de cola; consulte Reglas para nombrar objetos IBM MQ .
RQMNAME(cadena )
El nombre del gestor de colas remoto en el que está definida la cola RNAME .
Este parámetro sólo se admite en colas remotas.
  • Si una aplicación abre la definición local de una cola remota, RQMNAME no debe estar en blanco ni el nombre del gestor de cola local. Cuando se produce la apertura, si XMITQ está en blanco debe existir una cola local con este nombre, que se utilizará como cola de transmisión.
  • Si esta definición se utiliza para un alias de gestor de colas, RQMNAME es el nombre del gestor de colas que se está aliaseando. Puede ser el nombre del gestor de colas local. De lo contrario, si XMITQ está en blanco, cuando se produzca la apertura debe existir una cola local con este nombre, que se utilizará como cola de transmisión.
  • Si se utiliza RQMNAME para un alias de cola de respuesta, RQMNAME es el nombre del gestor de cola que será el gestor de cola de respuesta.
No se comprueba que el nombre contenga sólo los caracteres normalmente permitidos para los nombres de objetos de IBM MQ ; véanse las reglas para nombrar objetos de IBM MQ .
[AIX, Linux, Windows]SCOPE
Especifica el ámbito de la definición de la cola.
Este parámetro sólo se admite en colas de alias, locales y remotas.
QMGR
La definición de la cola tiene alcance de gestor de colas. Esto significa que la definición de la cola no se extiende más allá del gestor de colas que la posee. Puede abrir una cola de salida que pertenezca a otro gestor de colas de dos formas:
  1. Especifique el nombre del gestor de colas propietario.
  2. Abrir una definición local de la cola en el otro gestor de colas.
CELL
La definición de la cola tiene ámbito de celda. El ámbito de la célula significa que la cola es conocida por todos los gestores de colas de la célula. Una cola con ámbito de celda puede abrirse para la salida simplemente especificando el nombre de la cola. No es necesario especificar el nombre del gestor de colas propietario de la cola.

Si ya existe una cola con el mismo nombre en el directorio de celdas, el comando falla. La opción REPLACE no afecta a esta situación.

Este valor sólo es válido si se ha configurado un servicio de nombres que admita un directorio de celdas.
Restricción: El servicio de nombres DCE ya no es compatible.
Este parámetro sólo es válido en AIX, Linux, and Windows.
SHARE y NOSHARE
Especifica si varias aplicaciones pueden obtener mensajes de esta cola.
Este parámetro recibe soporte solamente en colas locales y de modelo.
SHARE
Más de una instancia de aplicación puede obtener mensajes de la cola.
NOSHARE
Sólo una instancia de aplicación puede obtener mensajes de la cola.
STATQ
Especifica si está activada la recopilación de datos estadísticos:
QMGR
La recopilación de datos estadísticos se basa en la configuración del parámetro STATQ del gestor de colas.
ON
Si el valor del parámetro STATQ del gestor de colas no es NONE, se habilita la recopilación de datos estadísticos para la cola.
[z/OS]En z/OS los sistemas, debe habilitar las estadísticas de clase 5 utilizando el comando START TRACE.
OFF
La recopilación de datos estadísticos para la cola está desactivada.
Si se utiliza este parámetro en un comando de cola ALTER , el cambio sólo será efectivo para las conexiones al gestor de colas realizadas después de la modificación del parámetro.
[z/OS]STGCLASS( cadena )
El nombre de la clase de almacenamiento.
Este parámetro recibe soporte solamente en colas locales y de modelo.
Nota: Sólo puede modificar este parámetro si la cola está vacía y cerrada.
Este parámetro es un nombre definido por la instalación. El primer carácter del nombre debe ir de la A a la Z en mayúsculas, y los caracteres siguientes de la A a la Z en mayúsculas o del 0 al 9 en números.
Este parámetro sólo es válido en z/OS; véase Clases de almacenamiento.
STREAMQ
El nombre de una cola secundaria donde se coloca una copia de cada mensaje.
Atención: Si el usuario que establece el atributo STREAMQ no tiene la autoridad correcta en la cola de flujo elegida, el comando falla con el mensaje de error AMQ8135E o el mensaje equivalente CSQ9016E en z/OS.

Además, si la cola de flujo no existe, se devuelve el mensaje de error AMQ8135E ( CSQ9016E en z/OS ) en lugar de AMQ8147E o el mensaje equivalente CSQM125I en z/OS.

[ MQ 9.4.0 Jul 2024][z/OS]Para obtener más información, consulte Colas de streaming y, para obtener información sobre cuándo puede configurar STREAMQ, consulte Restricciones de las colas de streaming.
STRMQOS
La calidad de servicio a utilizar cuando se entregan mensajes a la cola de streaming.
El valor puede ser uno de los siguientes:
BESTEF
Si se puede entregar el mensaje original, pero el mensaje transmitido no puede, el mensaje original todavía se entrega a su cola.
Éste es el valor predeterminado.
MUSTDUP
El gestor de colas garantiza que tanto el mensaje original como el mensaje transmitido se entreguen correctamente a sus colas.
Si, por alguna razón, el mensaje transmitido no puede entregarse a su cola, entonces el mensaje original tampoco se entrega a su cola. La aplicación de colocación recibe un código de razón de error y debe intentar volver a colocar el mensaje.
TARGET(cadena )
El nombre de la cola o del objeto temático al que se asigna el alias; véanse las reglas para asignar nombres a los objetos de IBM MQ . El objeto puede ser una cola o un tema, tal y como se define en TARGTYPE. La longitud máxima es de 48 caracteres.
Este parámetro sólo es compatible con las colas de alias.
Este objeto sólo debe definirse cuando un proceso de aplicación abre la cola de alias.
El parámetro TARGQ, definido en IBM WebSphere® MQ 6.0, pasa a llamarse TARGET a partir de la versión 7.0 y se generaliza para permitir especificar el nombre de una cola o de un tema. El valor por defecto de TARGET es una cola, por lo que TARGET(my_queue_name) es lo mismo que TARGQ(my_queue_name). El atributo TARGQ se mantiene por compatibilidad con los programas existentes. Si especifica TARGET, no puede especificar también TARGQ.
TARGTYPE(cadena )
El tipo de objeto al que resuelve el alias.
QUEUE (Valor predeterminado)
El alias resuelve una cola.
TOPIC
El alias resuelve un tema.
TRIGDATA(cadena )
Los datos que se insertan en el mensaje de activación. La longitud máxima de la cadena es de 64 bytes.
Este parámetro recibe soporte solamente en colas locales y de modelo.
Para una cola de transmisión, puede utilizar este parámetro para especificar el nombre del canal que debe iniciarse.
Este parámetro también puede modificarse mediante la llamada a la API MQSET .
TRIGDPTH(número entero )
El número de mensajes que deben estar en la cola antes de que se escriba un mensaje de activación, si TRIGTYPE es DEPTH. El valor debe estar comprendido entre 1 y 999.999.999. El valor predeterminado es 1.
Este parámetro recibe soporte solamente en colas locales y de modelo.
Este parámetro también puede modificarse mediante la llamada a la API MQSET .
TRIGGER y NOTRIGGER
Especifica si los mensajes de activación se escriben en la cola de iniciación, nombrada por el parámetro INITQ , para activar la aplicación, nombrada por el parámetro PROCESS :
TRIGGER
La activación está activa y los mensajes de activación se escriben en la cola de iniciación.
NOTRIGGER
La activación no está activa y los mensajes de activación no se escriben en la cola de iniciación. Éste es el valor predeterminado.

Este parámetro recibe soporte solamente en colas locales y de modelo.

Este parámetro también puede modificarse mediante la llamada a la API MQSET .
TRIGMPRI(número entero )
El número de prioridad del mensaje que activa esta cola. El valor debe estar comprendido entre cero y el parámetro MAXPRTY del gestor de colas; consulte DISPLAY QMGR (mostrar la configuración del gestor de colas) para obtener más detalles. El valor predeterminado es cero.
Este parámetro también puede modificarse mediante la llamada a la API MQSET .
TRIGTYPE
Especifica si un mensaje de activación se escribe en la cola de iniciación y en qué condiciones. La cola de iniciación se denomina mediante el parámetro INITQ .
Este parámetro recibe soporte solamente en colas locales y de modelo.
FIRST
Siempre que llegue a la cola el primer mensaje de prioridad igual o superior a la prioridad especificada por el parámetro TRIGMPRI de la cola. Éste es el valor predeterminado.
EVERY
Cada vez que llega un mensaje a la cola con prioridad igual o superior a la especificada por el parámetro TRIGMPRI de la cola.
DEPTH
Cuando el número de mensajes con prioridad igual o superior a la prioridad especificada por TRIGMPRI es igual al número indicado por el parámetro TRIGDPTH .
NONE
No se graba ningún mensaje desencadenante.
Este parámetro también puede modificarse mediante la llamada a la API MQSET .
USAGE
Uso de la cola.
Este parámetro recibe soporte solamente en colas locales y de modelo.
NORMAL
La cola no es una cola de transmisión.
XMITQ
La cola es una cola de transmisión, que se utiliza para contener mensajes destinados a un gestor de colas remoto. Cuando una aplicación pone un mensaje en una cola remota, el mensaje se almacena en la cola de transmisión correspondiente. Permanece allí, a la espera de ser transmitida al gestor de colas remoto.

Si especifica esta opción, no especifique valores para CLUSTER y CLUSNL.

[z/OS]Además, en z/OS, no especifique INDXTYPE(MSGTOKEN) ni INDXTYPE(GROUPID).

XMITQ(cadena )
Nombre de la cola de transmisión que se utilizará para reenviar mensajes a la cola remota. XMITQ se utiliza con definiciones de alias de cola remota o de gestor de colas.
Este parámetro sólo se admite en colas remotas.
Si XMITQ está en blanco, se utiliza una cola con el mismo nombre que RQMNAME como cola de transmisión.
Este parámetro se ignora si la definición se está utilizando como alias de gestor de colas y RQMNAME es el nombre del gestor de colas local.
Este atributo también se ignora si la definición se utiliza como definición de alias de cola de respuestas.