Colas ALTER (modificar valores de cola)

• 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

• 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.

• 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.

• 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.

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

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

''

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('')
• CUSTOM('A(B)')
• CUSTOM('C(D) E(F)')
• CUSTOM('G(5000) H(''9.20.4.6(1415)'')')

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.

En IBM MQ for z/OS se fija CAPEXPRY utilizando el atributo CUSTOM .

Por ejemplo:

ALTER QL(Q1) CUSTOM('CAPEXPRY(1000)')

Para desestablecer el atributo CAPEXPRY en IBM MQ for z/OS , especifique, por ejemplo, el mandato siguiente:

ALTER QL(Q1) CUSTOM(' ')

Nota: En z/OS debe dejar un espacio entre las comillas simples, de lo contrario el comando falla.

La especificación de un valor para CAPEXPRY que no es válido, no hace que el mandato falle. En su lugar, se utiliza 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.

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).

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

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).

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

No especifique este valor para una definición de cola de modelo con un parámetro DEFPSIST de YES.

Si especifica esta opción, no especifique INDXTYPE(MSGTOKEN).

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.

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

MQRC_OBJETO_MODIFICADO (2041)

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 ).

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 )

• AIX, Linux, and Windows
• z/OS

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.

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.

• IBM i
• AIX, Linux, and Windows
• z/OS

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.

ENABLED

Se generan sucesos de profundidad alta de cola.

DISABLED

No se generan sucesos de profundidad alta de cola.

ENABLED

Se generan sucesos de profundidad baja de cola.

DISABLED

No se generan sucesos de profundidad baja de cola.

ENABLED

Se generan sucesos de cola llena.

DISABLED

No se generan sucesos de cola llena.

• 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.

• 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.

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.

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.

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.

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.

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.

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