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]Puedes 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 para DEFINE colas

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

Notas de uso para 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 gestor de colas del grupo de colas compartidas 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, QREMOTEo 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 colas con el comando DEFINE QREMOTE (crear definición local de una cola remota).

Descripciones de parámetros para DEFINE QUEUE y ALTER QUEUE

La tabla 1 muestra los parámetros relevantes para cada tipo de cola. Hay una descripción de cada parámetro después de la tabla.
Tabla 1. Parámetros DEFINE y ALTER QUEUE
Parámetro Cola local Cola modelo Cola alias Cola remota
ACCTQ X X    
NOMBRE_COLA X X    
BOTHRESH X X    
[ MQ 9.3.1 Oct 2022][UNIX, Linux, Windows, IBM i] CAPEXPRY X X X X
[z/OS] CFSTRUCT X X    
NOMBRE_CLM X      
CLÚSTER X   X X
CLÚSTER X   X X
CLWLPRTY X   X X
CLWLRANK X   X X
CLWLUSEQ X      
[z/OS] CMDSCOPE X X X X
PERSONALIZADO X X X X
DEFECTO X   X X
DEFECTO X X X X
DEFECTO X X X X
DEFECTO X X X X
DEFREADA X X X  
DEFECTO X X    
TIPODEFECTO   X    
DESCR X X X X
DISTL X X    
FORZAR X   X X
GET X X X  
HARDENBO o NOHARDENBO X X    
IMGRCOVQ X X    
TIPO_INDX X X    
INITQ X X    
SIMILAR X X X X
PROFUNDIDAD X X    
TAMAÑO X X    
MAXMSGL X X    
MON X X    
MSGDLVSQ X X    
NOREPLACE X X X X
NPMCLASS X X    
PROCESO 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    
PUNTO DE CONTROL X X    
SUSTITUIR X X X X
RETINTVL X X    
NOMBRE       X
NOMBRE_RQM       X
ÁMBITO X   X X
SHARE o NOSHARE X X    
STATQ X X    
[z/OS] STGCLASS X X    
[MQ 9.3.0 Jul 2022] STREAMQ X X
[MQ 9.3.0 Jul 2022] STRMQOS X X
DESTINO     X  
TARGQ     X  
TIPO TARG     X  
DATOS TRIGAD X X    
TRIGDPTH X X    
TRIGGER o NOTRIGGER X X    
TRIGMPRI X X    
TIPO TRIGT X X    
USO X X    
XMITQ       X
nombre-cola
Nombre local de la cola, excepto la cola remota donde es la definición local de la cola remota.
Consulte Reglas para la denominación de objetos IBM MQ.
ACCTQ
Especifica si la recopilación de datos de contabilidad debe habilitarse para la cola. En z/OS, los datos recopilados son datos de contabilidad de clase 3 (nivel de hebra y nivel de cola). Para que se recopilen los datos de contabilidad para esta cola, los datos de contabilidad para esta conexión también deben estar habilitados. Active la recopilación de datos de contabilidad estableciendo el atributo de gestor de colas ACCTQ o el campo de opciones en la estructura MQCNO en la llamada MQCONNX .
QMGR
La recopilación de datos de contabilidad se basa en el valor 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 de contabilidad está inhabilitada para la cola.
BOQNAME (nombre-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 atributo BOTHRESH .

BOTHRESH(número entero )
El umbral de restitución.
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 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 utiliza el atributo para determinar cuántas veces se debe permitir que se restituya un mensaje. Cuando se supera el valor, el mensaje se transfiere a la cola especificada por el atributo BOQNAME .
Especifique un valor en el rango de 0 a 999.999.999.
[ MQ 9.3.1 Oct 2022][UNIX, Linux, Windows, IBM i]CAPEXPRY(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.
[z/OS]Importante: You cannot use the CAPEXPRY attribute introduced in IBM MQ 9.3.1 with a cluster if the full repository is on z/OS.

Para obtener más información sobre el proceso de caducidad de mensajes, consulte Imponer tiempos de caducidad inferiores.

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 tiempo de caducidad permanece intacto). 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 del recurso de asociación donde desea que se almacenen los mensajes cuando se utilizan colas compartidas.
Este parámetro solo está soportado en z/OS para colas locales y de modelo.
El nombre:
  • No puede tener más de 12 caracteres
  • Debe empezar con una letra mayúscula (A-Z)
  • Sólo puede incluir los caracteres A-Z y 0-9
El nombre del grupo de compartición de colas al que está conectado el gestor de colas tiene 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 compartición de colas denominado NY03 y proporciona el nombre PRODUCT7, el nombre de la estructura del recurso de asociación resultante es NY03PRODUCT7. La estructura administrativa para el grupo de compartición de colas (en este caso NY03CSQ_ADMIN) no se puede utilizar para almacenar mensajes.
Para ALTER QLOCAL, ALTER QMODEL, DEFINE QLOCAL con REPLACEy DEFINE QMODEL con REPLACE se aplican las reglas siguientes:
  • En una cola local con QSGDISP ( SHARED ), CFSTRUCT no puede cambiar.
  • Si cambia el valor CFSTRUCT o QSGDISP , debe suprimir y redefinir la cola. Para conservar cualquiera de los mensajes de la cola, debe descargar los mensajes antes de suprimir 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 del recurso 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: Para poder utilizar la cola, la estructura debe estar definida en el conjunto de datos de política de gestión de recursos (CFRM) del recurso de acoplamiento.
CLCHNAME(nombre del canal )

Este parámetro sólo está soportado en colas de transmisión.

CLCHNAME es el nombre genérico de los canales de clúster emisor 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 el atributo de cola de transmisión CLCHNAME en un canal de clúster emisor manualmente. 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 blancos, el canal cambia a la cola de transmisión de clúster predeterminada cuando se reinicia el canal. La cola predeterminada es SYSTEM.CLUSTER.TRANSMIT.ChannelName o SYSTEM.CLUSTER.TRANSMIT.QUEUE, en función del valor del atributo DEFCLXQ del gestor de colas.
Si especifica asteriscos, " * ", en CLCHNAME, puede asociar una cola de transmisión con un conjunto de canales de clúster emisor. Los asteriscos pueden estar al principio, al final o en cualquier posición intermedia de la serie de nombre de canal. CLCHNAME está limitado a una longitud de 48 caracteres, MQ_OBJECT_NAME_LENGTH. Un nombre de 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 de canal genérico 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 predeterminada se puede modificar 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 ser compartible, especificando el atributo de cola SHARE.
  • 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 está soportado en colas 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 no estar en blanco; no puede especificar un valor para ambos.

En las colas locales, este parámetro no se puede establecer 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 está soportado en colas 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 no estar en blanco; no puede especificar un valor para ambos.

En las colas locales, este parámetro no se puede establecer 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 para fines de distribución de carga de trabajo de clúster. Este parámetro sólo es válido para colas locales, remotas y alias. El valor debe estar en el rango de cero a 9, donde cero es la prioridad más baja y 9 es la más alta. Para obtener más información sobre este atributo, consulte Atributo de cola CLWLPRTY.
CLWLRANK (número entero )
Especifica el rango de la cola para fines de distribución de carga de trabajo de clúster. Este parámetro sólo es válido para colas locales, remotas y alias. El valor debe estar en el rango de cero a 9, donde cero es el rango más bajo y 9 es el más alto. Para obtener más información sobre este atributo, consulte 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 remoto. El parámetro no tiene ningún efecto cuando el MQPUT se origina en un canal de clúster. Este parámetro sólo es válido para 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 otra instancia de la cola de clúster para fines de distribución de carga de trabajo.
LOCAL
La cola local es el único destino de la operación MQPUT .
[z/OS]CMDSCOPE
Este parámetro se aplica únicamente a z/OS. Especifica dónde se ejecuta el mandato 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 mandato se ejecuta en el gestor de colas en el que se ha especificado.
QmgrName
El mandato se ejecuta en el gestor de colas que especifique, siempre que el gestor de colas esté activo dentro del grupo de compartición de colas.

Puede especificar un nombre de gestor de colas que no sea el gestor de colas en el que se ha especificado el mandato. Puede especificar otro nombre, sólo si está utilizando un entorno de grupo de compartición de colas y si el servidor de mandatos está habilitado.

*
El mandato se ejecuta en el gestor de colas local y también se pasa a cada gestor de colas activo del grupo de compartición de colas. El efecto de * es el mismo que especificar el mandato en cada gestor de colas del grupo de compartición de colas.
CUSTOM (serie)
El atributo personalizado 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 . Otros atributos reservados 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.3.1 Oct 2022]Nota: Para Continuous Delivery de IBM MQ 9.3.1, 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 QL(Q1) CAPEXPRY(1000) CAPEXPRY('')
Para más información sobre los valores permitidos, véase CAPEXPRY.
[Soporte a largo plazo][z/OS]Para IBM MQ for z/OS y Long Term Support para IBM MQ for Multiplatforms, el atributo CUSTOM puede utilizarse con el atributo CAPEXPRY de la siguiente manera.
CAPEXPRY (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.

Para obtener más información sobre el proceso de caducidad de mensajes, consulte Imponer tiempos de caducidad inferiores.

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.
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 tiempo de caducidad permanece intacto). Sólo los mensajes nuevos que se colocan en la cola después del cambio en CAPEXPRY tienen la nueva hora de caducidad.
DEFBIND
Especifica el enlace que debe utilizarse cuando la aplicación especifica MQOO_BIND_AS_Q_DEF en la llamada MQOPEN y la cola es 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 descriptor de contexto de cola no está enlazado a ninguna instancia de la cola de clúster. El gestor de colas selecciona una instancia de cola específica cuando el mensaje se coloca utilizando MQPUT. Cambia esa selección más adelante, 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 carga de trabajo seleccione el destino más adecuado para cada mensaje, MQOO_BIND_NOT_FIXED. Puede permitir que una aplicación solicite que se asigne un grupo de mensajes a la misma instancia de destino. El equilibrio de carga de trabajo vuelve a elegir un destino entre grupos de mensajes, sin que sea necesario un MQCLOSE y un 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 de colocación en la cola que especifican MQPMO_RESPONSE_AS_Q_DEF se emiten como si se especificara MQPMO_SYNC_RESPONSE en su lugar.
ASYNC
Las operaciones de colocación en la cola que especifican MQPMO_RESPONSE_AS_Q_DEF se emiten como si se hubiera especificado MQPMO_ASYNC_RESPONSE en su lugar; consulte Opciones MQPMO (MQLONG).
DEFPRTY(número entero )
Prioridad predeterminada de los mensajes colocados en la cola. El valor debe estar en el rango de 0 a 9. Cero es la prioridad más baja, a través del parámetro de gestor de colas MAXPRTY . El valor predeterminado de MAXPRTY es 9.
DEFPSIST
Especifica la persistencia de mensaje que se debe utilizar cuando las aplicaciones especifican 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 de lectura anticipada predeterminado para los mensajes no persistentes entregados al cliente. La habilitación de la lectura anticipada puede mejorar el rendimiento de las aplicaciones cliente que consumen mensajes no persistentes.
NO
Los mensajes no persistentes no son de lectura anticipada a menos que la aplicación cliente esté configurada para solicitar la lectura anticipada.
YES
Los mensajes no persistentes se envían al cliente antes de que una aplicación los solicite. Los mensajes no persistentes se pueden perder si el cliente finaliza de forma anómala o si el cliente no suprime todos los mensajes que se envían.
DISABLED
Lectura anticipada de mensajes no persistentes en no habilitados para esta cola. Los mensajes no se envían al cliente independientemente de si la aplicación cliente solicita la lectura anticipada.
DEFSOPT
La opción de compartición predeterminada para las aplicaciones que abren esta cola para 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 está soportado en colas modelo.
PERMDYN
Se crea una cola dinámica permanente cuando una aplicación emite una llamada MQI de 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 de API MQOPEN con el nombre de esta cola modelo 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 de 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 mandato 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 juego 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, es posible que se conviertan incorrectamente.
[AIX, Linux, Windows]DISTL
Establece si las listas de distribución están soportadas por el gestor de colas asociado.
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 cambia este parámetro, porque lo establece el MCA. Sin embargo, puede establecer este parámetro al definir una cola de transmisión si se conoce la capacidad de 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 mandato ALTER en colas alias, locales y remotas.
Especifique este parámetro para forzar la finalización del mandato en las circunstancias siguientes.
Para una cola alias, si se cumplen las dos sentencias siguientes:
  • El parámetro TARGET especifica una cola
  • Una aplicación tiene esta cola alias abierta
Para una cola local, si se cumplen las dos sentencias siguientes:
  • Se ha especificado el parámetro NOSHARE
  • Más de una aplicación tiene la cola abierta para entrada
FORCE también es necesario si se cumplen las dos sentencias siguientes:
  • El parámetro USAGE ha cambiado
  • Uno o más mensajes están en la cola, o una o más aplicaciones tienen la cola abierta

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

Para una cola remota, si se cumplen las dos sentencias siguientes:
  • El parámetro XMITQ ha cambiado
  • Una o más aplicaciones tiene esta cola abierta como una cola remota
FORCE también es necesario si se cumplen las dos sentencias siguientes:
  • Se cambia cualquiera de los parámetros RNAME, RQMNAMEo XMITQ
  • Una o varias aplicaciones tienen una cola abierta que se ha resuelto a través de esta definición como alias de gestor de colas
Nota: FORCE no es necesario si esta definición se utiliza sólo como alias de cola de respuesta.

Si no se especifica FORCE en las circunstancias descritas, el mandato no se ejecuta correctamente.

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 sobre 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 las aplicaciones deben tener permiso para obtener mensajes de esta cola:
ENABLED
Los mensajes se pueden recuperar de la cola, mediante aplicaciones debidamente autorizadas.
DISABLED
Las aplicaciones no pueden recuperar mensajes de la cola.
Este parámetro también se puede cambiar utilizando la llamada de API MQSET .
HARDENBO y NOHARDENBO
Especifica si se ha reforzado el recuento del número de veces que se ha restituido un mensaje. Cuando se endurece el recuento, el valor del campo BackoutCount del descriptor de mensaje se graba en el registro antes de que una operación MQGET devuelva el mensaje. Escribir el valor en el registro garantiza que el valor es preciso en los reinicios del gestor de colas.
Este parámetro recibe soporte solamente en colas locales y de modelo.
Cuando se endurece el recuento de restituciones, el rendimiento de las operaciones MQGET para los mensajes persistentes en esta cola se ve afectado.
HARDENBO
El recuento de restituciones de mensajes para los mensajes de esta cola se ha reforzado para asegurarse de que el recuento es preciso.
NOHARDENBO
El recuento de restituciones de mensajes para los mensajes de esta cola no está protegido y es posible que no sea preciso sobre los reinicios del gestor de colas.
[z/OS]Nota: Este parámetro sólo afecta a z/OS. Puede establecer este parámetro en Multiplatforms pero no es efectivo.
[UNIX, Linux, Windows, IBM i]IMGRCOVQ
Especifica si un objeto de cola dinámica local o permanente es recuperable a partir de una imagen de soporte, 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
El tipo de índice mantenido por el gestor de colas para acelerar las operaciones de MQGET en la cola. Para las colas compartidas, el tipo de índice determina el tipo de operaciones MQGET que se pueden utilizar.
Este parámetro sólo está soportado en z/OS.
Este parámetro recibe soporte solamente en colas locales y de modelo.
Los mensajes se pueden recuperar utilizando un criterio de selección sólo si se mantiene un tipo de índice adecuado, como se muestra en la tabla siguiente:
Tabla 2. Tipo de índice necesario para diferentes criterios de selección de recuperación
Criterio de selección de recuperación Tipo de índice necesario
  Cola compartida Otra cola
Ninguno (recuperación secuencial) Cualquiera Cualquiera
Identificador de mensaje MSGID o NONE Cualquiera
Identificador de correlación CORRELID Cualquiera
Identificadores de mensaje y correlación 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 valores siguientes:
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 están compartidas y no utilizan señales de agrupación o de mensaje, el tipo de índice no restringe el tipo de selección de recuperación. Sin embargo, el índice se utiliza para acelerar las operaciones de GET en la cola, por lo tanto, elija el tipo que corresponda a la selección de recuperación más común.
Si está alterando o sustituyendo una cola local existente, puede cambiar el parámetro INDXTYPE sólo en los casos indicados en la tabla siguiente:
Tabla 3. Cambio de tipo de índice permitido en función de la compartición de colas y de la presencia de mensajes en la cola
Tipo de cola NO COMPARTIDO SHARED
Estado de cola Actividad no confirmada No hay actividad no confirmada, hay mensajes No hay actividad no confirmada y está vacía Abrir o mensajes presentes No abierto y vacío
Cambie 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í - -
INITQ(cadena )
El nombre local de la cola de inicio en este gestor de colas, en el que se graban los mensajes desencadenantes relacionados con esta cola. Consulte Reglas para la denominación de 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 este campo no se completa, los valores de los campos de parámetro no definidos se toman de una de las definiciones siguientes. La opción depende del tipo de cola:
Tabla 4. Tipos de cola y sus definiciones correspondientes
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 alias:
LIKE(SYSTEM.DEFAULT.ALIAS.QUEUE)
Si necesita definiciones predeterminadas diferentes para todas las colas, modifique las definiciones de cola predeterminadas 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 )
Número máximo de mensajes permitidos en la cola.
Este parámetro recibe soporte solamente en colas locales y de modelo.
En las plataformas siguientes, 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 en el rango de cero a 640000.
Otros factores pueden seguir haciendo que la cola se trate como llena, por ejemplo, si no hay más espacio de disco duro disponible.
Si se reduce este valor, los mensajes que ya estén en la cola que superen el nuevo máximo permanecerán intactos.
[UNIX, Linux, Windows, IBM i]MAXFSIZE
Tamaño máximo, en megabytes, hasta el que puede crecer 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 de archivo de cola actual.
Si esto sucede, 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 colocar nuevos mensajes en la cola.
Nota: Esta figura puede diferir del valor del atributo configurado en la cola, porque internamente el gestor de colas puede necesitar utilizar un tamaño de bloque mayor para alcanzar el tamaño elegido. Consulte Modificación de archivos de cola de IBM MQ para obtener más información sobre cómo cambiar el tamaño de los archivos de cola y el tamaño de bloque y la granularidad.
Cuando es necesario cambiar la granularidad porque se ha aumentado este atributo, mensaje de aviso AMQ7493WGranularity changedse graba en los registros de AMQERR. Esto le proporciona una indicación de que necesita planificar que la cola se vacíe, para que IBM MQ adopte la nueva granularidad.
Especifique un valor mayor o igual que 20 y menor o igual que 267.386.880.
El valor predeterminado para este atributo es DEFAULT, que equivale a un valor codificado de 2.088.960 MB, el máximo para una cola en versiones de IBM MQ anteriores a IBM MQ 9.1.5.
MAXMSGL(número entero )
Longitud máxima (en bytes) de los mensajes de 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. Consulte el parámetro MAXMSGL del mandato 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 de usuario y la longitud de las cabeceras. Para los mensajes colocados en la cola de transmisión, hay cabeceras de transmisión adicionales. Permita 4000 bytes adicionales para todas las cabeceras de mensaje.
Si este valor se reduce, los mensajes que ya estén en la cola con una longitud que supere el nuevo máximo no se verán afectados.
Las aplicaciones pueden utilizar este parámetro para determinar el tamaño del almacenamiento intermedio para recuperar mensajes de la cola. Por lo tanto, el valor sólo se puede reducir si se sabe que esta reducción no hace que una aplicación funcione incorrectamente.
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 de acuerdo con el valor del parámetro de 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 recopilación de datos, pero no afectan a la tasa de recopilación.
Cuando se utiliza este parámetro en un mandato de cola ALTER , el cambio sólo es efectivo cuando la cola se abre por siguiente.
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 llamadas de API de MQGET ) en orden de primero en entrar, primero en salir (FIFO) dentro de la prioridad.
FIFO
Los mensajes se entregan (en respuesta a llamadas de API de 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 cambia. Los mensajes añadidos a la cola posteriormente tienen la prioridad predeterminada de la cola, por lo que pueden 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. Si lo hace, el mensaje se almacena como si fuera la prioridad dos.
[UNIX, Linux, Windows, IBM i]NPMCLASS
El nivel de fiabilidad que se debe asignar a los mensajes no persistentes que se colocan en la cola:
NORMAL
Los mensajes no persistentes se pierden después de una anomalía o de una conclusión del gestor de colas. Estos mensajes se descartan en un reinicio del gestor de colas.
HIGH
El gestor de colas intenta retener los mensajes no persistentes en esta cola a través de un reinicio o conmutación del gestor de colas.
Nota: En una configuración HA nativa, cualquier cambio de líder de una instancia del gestor de colas siempre da lugar al descarte de los mensajes no persistentes, independientemente de la configuración de NPMCLASS.
[z/OS]No se puede establecer este parámetro 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 suceso desencadenante; consulte Reglas para la denominación de objetos de IBM MQ.
La definición de proceso no se comprueba cuando se define la cola local, pero debe estar disponible para que se produzca un suceso desencadenante.
Si la cola es una cola de transmisión, la definición de proceso contiene el nombre del canal que se va a iniciar. Este parámetro es opcional para las colas de transmisión en las plataformas siguientes:
  • [IBM i]IBM i
  • [AIX, Linux, Windows]AIX, Linux, and Windows
  • [z/OS]z/OS
Si no lo especifica, el nombre de canal se toma del valor especificado para el parámetro TRIGDATA .
PROPCTL
Atributo de control de propiedad. El atributo es opcional. Es aplicable a colas locales, alias y modelo.
Nota: Si la aplicación está abriendo una cola alias, debe establecer este valor en las colas alias y destino.
Las opciones de PROPCTL son las siguientes. Las opciones no afectan a las propiedades de mensaje 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 se pueden cambiar pueden acceder a todas las propiedades del mensaje como propiedades del manejador de mensajes.

En algunos casos, el formato de los datos en las cabeceras MQRFH2 en el mensaje recibido puede ser diferente al formato en el 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 se pueden cambiar pueden acceder a todas las propiedades del mensaje como propiedades del manejador de mensajes.
Si el mensaje contiene una propiedad con el prefijo mcd., jms., usr.o mqext., todas las propiedades de mensaje se entregan a la aplicación. Si no se proporciona ningún descriptor de contexto de mensaje, las propiedades se devuelven en una cabecera MQRFH2 . Si se proporciona un descriptor de contexto de mensaje, se devuelven todas las propiedades en el descriptor de contexto de mensaje.
Si el mensaje no contiene una propiedad con uno de estos prefijos y la aplicación no proporciona un manejador de mensajes, no se devolverá ninguna propiedad de mensaje a la aplicación. Si se proporciona un descriptor de contexto de mensaje, se devuelven todas las propiedades en el descriptor de contexto de mensaje.

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

FORCE
Forzar a todas las aplicaciones a leer las propiedades de mensaje de las cabeceras MQRFH2 .
Las propiedades siempre se devuelven en los datos de mensaje en una cabecera MQRFH2 independientemente de si la aplicación especifica un manejador de mensajes.
Se ignora un descriptor de mensaje válido proporcionado en el campo MsgHandle de la estructura MQGMO en la llamada MQGET . No se puede acceder a las propiedades del mensaje utilizando el descriptor de contexto de mensaje.

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

NONE
Si se proporciona un descriptor de contexto de mensaje, se devuelven todas las propiedades en el descriptor de contexto de mensaje.
Todas las propiedades de mensaje se eliminan del cuerpo del mensaje antes de que se entregue a la aplicación.
PUT
Indica si pueden transferirse mensajes a la cola.
ENABLED
Los mensajes se pueden añadir a la cola (mediante aplicaciones debidamente autorizadas).
DISABLED
No se pueden añadir mensajes a la cola.
Este parámetro también se puede cambiar utilizando la llamada de API MQSET .
QDEPTHHI(número entero )
El umbral con el que se compara la profundidad de cola para generar un suceso 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 suceso indica que una aplicación ha colocado un mensaje en una cola, lo que hace que el número de mensajes de la cola sea mayor o igual que el umbral superior de profundidad de cola. Consulte el parámetro QDPHIEV .
El valor se expresa como un porcentaje de la profundidad máxima de cola (parámetroMAXDEPTH ), y debe estar en el rango de cero a 100 y no menor que QDEPTHLO.
QDEPTHLO(número entero )
El umbral con el que se compara la profundidad de cola para generar un suceso 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 suceso indica que una aplicación ha recuperado un mensaje de una cola, lo que hace que el número de mensajes de la cola sea menor o igual que el umbral inferior de profundidad de cola. Consulte el parámetro QDPLOEV .
El valor se expresa como un porcentaje de la profundidad de cola máxima (parámetroMAXDEPTH ), y debe estar en el rango de cero a 100 y no debe ser mayor que QDEPTHHI.
QDPHIEV
Controla si se generan sucesos de profundidad de cola alta.
Este parámetro recibe soporte solamente en colas locales y de modelo.
Un suceso de profundidad de cola alta indica que una aplicación ha colocado un mensaje en una cola, lo que da como resultado que el número de mensajes de la cola sea mayor o igual que el 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 suceso, consulte Profundidad de cola alta.
QDPLOEV
Controla si se generan sucesos de Profundidad de cola baja.
Este parámetro recibe soporte solamente en colas locales y de modelo.
Un suceso Profundidad de cola baja indica que una aplicación ha recuperado un mensaje de una cola, lo que da como resultado que el número de mensajes de la cola sea menor o igual que el 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 suceso, consulte Profundidad de cola baja.
QDPMAXEV
Controla si se generan sucesos Cola llena.
Este parámetro recibe soporte solamente en colas locales y de modelo.
Un suceso Cola llena indica que una colocación en una cola se ha rechazado porque la cola está llena. La profundidad de 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 obtener más información sobre este suceso, 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 QSGDISP(GROUP) 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(GROUP) solo está permitido si el gestor de colas está en un grupo de compartición de colas.

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 entra en vigor independientemente de si el mandato generado con QSGDISP(COPY) falla.
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 sucesos de intervalo de servicio alto o de intervalo de servicio correcto.
Este parámetro solo está soportado en colas locales y de modelo y no es efectivo si se especifica en una cola compartida.
Se genera un suceso de intervalo de servicio alto cuando una comprobación indica que no se ha recuperado ningún mensaje de la cola durante al menos el tiempo indicado por el parámetro QSVCINT .
Se genera un suceso de intervalo de servicio correcto cuando una comprobación indica que los mensajes se han recuperado de la cola dentro del 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 sucesos de intervalo de servicio alto y de intervalo de servicio correcto en Intervalo de servicio de cola alto y Intervalo de servicio de cola correcto.
HIGH
Se generan sucesos de intervalo de servicio alto
OK
Se generan sucesos de intervalo de servicio correcto
NONE
No se generan sucesos de intervalo de servicio
QSVCINT(número entero )
El intervalo de servicio utilizado para la comparación para generar sucesos de intervalo de servicio alto y de intervalo de servicio correcto.
Este parámetro solo está soportado en colas locales y de 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.
SUSTITUIR & 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 SCOPE(CELL) se especifica en AIX, Linux, and Windows, y 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 el momento en que se definió la cola, después de las cuales la cola ya no es necesaria. El valor debe estar en el rango de 0 a 999.999.999.
Este parámetro recibe soporte solamente en colas locales y de modelo.
El CRDATE y se CRTIME 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 suprimir colas que ya no son necesarias.
Nota: El gestor de colas no suprime las colas basándose en este valor, ni impide que se supriman las colas si su intervalo de retención no ha caducado. Es responsabilidad del usuario realizar cualquier acción necesaria.
RNAME(cadena )
Nombre de la cola remota. Este parámetro es el nombre local de la cola tal como se define en el gestor de colas especificado por RQMNAME.
Este parámetro sólo está soportado 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 en todo el clúster, añada el atributo CLUSTER a la definición de cola remota.

  • Si esta definición se utiliza para un alias de cola de respuesta, este nombre es el nombre de la cola que debe ser la cola de respuesta.
El nombre no se comprueba para asegurarse de que contiene sólo los caracteres normalmente permitidos para los nombres de cola; consulte Reglas para la denominación de objetos de IBM MQ.
RQMNAME(cadena )
El nombre del gestor de colas remoto en el que se define la cola RNAME .
Este parámetro sólo está soportado 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 colas local. Cuando se produce la apertura, si XMITQ está en blanco, debe haber 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á alias. Puede ser el nombre del gestor de colas local. De lo contrario, si XMITQ está en blanco, cuando se produzca la apertura debe haber 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 colas que debe ser el gestor de colas de respuesta.
El nombre no se comprueba para asegurarse de que contiene sólo los caracteres normalmente permitidos para los nombres de objeto de IBM MQ ; consulte Reglas para la denominación de objetos de IBM MQ.
[AIX, Linux, Windows]SCOPE
Especifica el ámbito de la definición de cola.
Este parámetro sólo está soportado en colas alias, locales y remotas.
QMGR
La definición de cola tiene ámbito 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 para salida que es propiedad de otro gestor de colas de dos maneras:
  1. Especifique el nombre del gestor de colas propietario.
  2. Abra una definición local de la cola en el otro gestor de colas.
CELL
La definición de cola tiene ámbito de célula. El ámbito de célula significa que la cola es conocida por todos los gestores de colas de la célula. Una cola con ámbito de célula se puede abrir para salida simplemente especificando el nombre de la cola. No es necesario especificar el nombre del gestor de colas propietario de la cola.

Si ya hay una cola con el mismo nombre en el directorio de célula, el mandato 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 da soporte a un directorio de célula.
Restricción: El servicio de nombres DCE ya no está soportado.
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 única instancia de aplicación puede obtener mensajes de la cola.
[MQ 9.3.0 Jul 2022][MQ 9.3.0 Jul 2022]STATQ
Especifica si la recopilación de datos de estadísticas está habilitada:
QMGR
La recopilación de datos de estadísticas se basa en el valor 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 de estadísticas para la cola está inhabilitada.
Si este parámetro se utiliza en un mandato de cola ALTER , el cambio sólo es efectivo para las conexiones con el gestor de colas realizadas después del cambio en el 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: Puede cambiar este parámetro sólo 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 estar en mayúscula de la A a la Z, y los siguientes caracteres deben estar en mayúscula de la A a la Z o ser numéricos de 0 a 9.
Este parámetro sólo es válido en z/OS; consulte Clases de almacenamiento.
[MQ 9.3.0 Jun 2022]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 autorización correcta en la cola de corriente elegida, el mandato falla con el mensaje de error AMQ8135E, o el mensaje equivalente CSQ9016E en z/OS.

Además, si la cola de corriente 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.

[z/OS][ MQ 9.3.1 Oct 2022] Consulte Restricciones de la cola de streaming para obtener información sobre cuándo puede configurar STREAMQ.
[MQ 9.3.0 Jun 2022]STRMQOS
La calidad de servicio que se debe utilizar al entregar mensajes a la cola de modalidad continua.
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 en modalidad continua no se puede entregar a su cola, 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 del objeto de cola o tema con alias; consulte Reglas para la denominación de objetos IBM MQ. El objeto puede ser una cola o un tema tal como lo define TARGTYPE. La longitud máxima es de 48 caracteres.
Este parámetro sólo está soportado en colas alias.
Este objeto sólo es necesario definirlo cuando un proceso de aplicaciones abre la cola alias.
El parámetro TARGQ, definido en IBM WebSphere® MQ 6.0, se ha renombrado a TARGET de la versión 7.0 y se ha generalizado para permitirle especificar el nombre de una cola o un tema. El valor predeterminado para TARGET es una cola, por lo tanto, TARGET(my_queue_name) es el mismo que TARGQ(my_queue_name). El atributo TARGQ se conserva por compatibilidad con los programas existentes. Si especifica TARGET, no puede especificar también TARGQ.
TARGTYPE(cadena )
El tipo de objeto en el que se resuelve el alias.
QUEUE (Valor predeterminado)
El alias se resuelve en una cola.
TOPIC
El alias se resuelve en un tema.
TRIGDATA(cadena )
Los datos que se insertan en el mensaje desencadenante. La longitud máxima de la serie 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 se va a iniciar.
Este parámetro también se puede cambiar utilizando la llamada de 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 en el rango de 1 a 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 se puede cambiar utilizando la llamada de API MQSET .
TRIGGER y NOTRIGGER
Especifica si los mensajes desencadenantes se graban en la cola de inicio, denominada por el parámetro INITQ , para desencadenar la aplicación, denominada por el parámetro PROCESS :
TRIGGER
El desencadenamiento está activo y los mensajes desencadenantes se graban en la cola de inicio.
NOTRIGGER
El desencadenamiento no está activo y los mensajes desencadenantes no se graban en la cola de inicio. Éste es el valor predeterminado.

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

Este parámetro también se puede cambiar utilizando la llamada de API MQSET .
TRIGMPRI(número entero )
Número de prioridad de mensaje que desencadena 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 se puede cambiar utilizando la llamada de API MQSET .
TRIGTYPE
Especifica si un mensaje desencadenante se graba en la cola de inicio y en qué condiciones. La cola de inicio es (denominada por 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 mayor que 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 una prioridad igual o mayor que la prioridad especificada por el parámetro TRIGMPRI de la cola.
DEPTH
Cuando el número de mensajes con prioridad igual o mayor que 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 se puede cambiar utilizando la llamada de API MQSET .
USAGE
Uso de 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 coloca un mensaje en una cola remota, el mensaje se almacena en la cola de transmisión adecuada. Permanece allí, a la espera de la transmisión 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 )
El nombre de la cola de transmisión que se va a 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 está soportado 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.