Suprimir colas

Utilice el mandato MQSC DELETE para suprimir una definición de cola para una cola local, modelo o remota, o un alias de cola.

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.

Esta sección contiene los mandatos siguientes:

[z/OS] Puede emitir este mandato desde orígenes 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®.

Notas de uso para colas DELETE

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 DELETE en Comprobación de que los mandatos asíncronos para redes distribuidas han finalizado.

Descripciones de parámetros para colas DELETE

(nombre-q)

El nombre de la cola debe estar definido en el gestor de colas local para todos los tipos de cola.

Para una cola alias, es el nombre local de la cola alias que se va a suprimir.

Para una cola modelo, es el nombre local de la cola modelo que se va a suprimir.

Para una cola remota, es el nombre local de la cola remota que se va a suprimir.

Para una cola local, es el nombre de la cola local que se va a suprimir. Debe especificar qué cola desea suprimir.

Nota: Una cola no se puede suprimir si contiene mensajes no confirmados.

Si una aplicación tiene esta cola abierta o tiene abierta una cola que finalmente se resuelve en esta cola, el mandato falla. El mandato también falla si esta cola es una cola de transmisión, y cualquier cola que sea, o se resuelva en, una cola remota que haga referencia a esta cola de transmisión, está abierta.

Si esta cola tiene un atributo SCOPE de CELL, la entrada para la cola también se suprime del directorio de célula.

AUTOR

Este parámetro no se aplica a z/OS.

Especifica si el registro de autorización asociado también se suprime:

SÍ: Se suprime el registro de autorización asociado con el objeto. Este es el valor predeterminado.
NO: El registro de autorización asociado con el objeto no se suprime.

CMDSCOPE

Este parámetro sólo se aplica a z/OS y especifica cómo 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á establecido en GROUP o SHARED.

' ': El mandato se ejecuta en el gestor de colas en el que se ha especificado. Éste es el valor predeterminado.
nombre-gestcolas: 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, 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 esto es el mismo que entrar el mandato en cada gestor de colas del grupo de compartición de colas.

PURGE y NOPURGE

Especifica si se van a depurar los mensajes confirmados existentes en la cola indicada por el mandato DELETE para que funcione el mandato delete. El valor predeterminado es NOPURGE.

DEPURAR: La supresión se lleva a cabo incluso si hay mensajes confirmados en la cola especificada, y estos mensajes también se van a depurar.
NOPURGE: La supresión no se realiza si hay mensajes confirmados en la cola especificada.

QSGDISP

Especifica la disposición del objeto al que está aplicando el mandato (es decir, dónde está definido y cómo se comporta). Si la definición de objeto es compartida, no es necesario suprimirla en cada gestor de colas que forme parte de un grupo de compartición de colas. (Los grupos de compartición de colas sólo están disponibles en IBM MQ for z/OS.)

COPY

La definición de objeto reside en el conjunto de páginas del gestor de colas que ejecuta el mandato. El objeto se ha definido utilizando un mandato con los parámetros QSGDISP(COPY). Los objetos que residen en el repositorio compartido, o los objetos definidos utilizando un mandato con los parámetros QSGDISP(QMGR), no se ven afectados por este mandato.

GRUPO

La definición de objeto reside en el repositorio compartido. El objeto se ha definido utilizando un mandato con los parámetros QSGDISP(GROUP). Cualquier objeto que resida en el conjunto de páginas del gestor de colas que ejecuta el mandato, o cualquier objeto definido utilizando un mandato que tenga los parámetros QSGDISP (SHARED), no se verá afectado por este mandato.

Si la supresión es satisfactoria, se genera el mandato siguiente y se envía a todos los gestores de colas activos del grupo de compartición de colas para realizar, o suprimir, copias locales en el conjunto de páginas cero:

DELETE queue(q-name) QSGDISP(COPY)

o, sólo para una cola local:

DELETE QLOCAL(q-name) NOPURGE QSGDISP(COPY)

La supresión del objeto de grupo entra en vigor incluso si el mandato generado con QSGDISP (COPY) falla.

Nota: Siempre obtiene la opción NOPURGE aunque especifique PURGE. Para suprimir mensajes en copias locales de las colas, debe emitir explícitamente el mandato:

DELETE QLOCAL(q-name) QSGDISP(COPY) PURGE

para cada copia.

QMGR

La definición de objeto reside en el conjunto de páginas del gestor de colas que ejecuta el mandato. El objeto se ha definido utilizando un mandato con los parámetros QSGDISP(QMGR). Los objetos que residen en el repositorio compartido, o las copias locales de un objeto de ese tipo, no se ven afectados por este mandato.

Éste es el valor predeterminado.

SHARED

Esta opción sólo se aplica a las colas locales.

La definición de objeto reside en el repositorio compartido. El objeto se ha definido utilizando un mandato que tenía los parámetros QSGDISP (SHARED). Cualquier objeto que resida en el conjunto de páginas del gestor de colas que ejecuta el mandato, o cualquier objeto definido utilizando un mandato que tenga los parámetros QSGDISP (GROUP), no se verá afectado por este mandato.

IGNSTATE de

Especifica si el mandato falla si la cola no existe. El valor puede ser uno de los siguientes:

NO: El mandato falla si la cola no existe. Éste es el valor predeterminado.
SÍ: El mandato se ejecuta correctamente independientemente de si existe la cola.