DELETE TOPIC (suprimir un nodo de tema administrativo)

Utilice DELETE TOPIC para suprimir un nodo de tema administrativo de IBM® MQ .

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

Sinónimo: Ninguno

DELETE TOPIC

Leer diagrama de sintaxisOmitir diagrama de sintaxis visual DELETE TOPIC ( nombre-tema ) AUTHREC(YES )AUTHREC(NO)1CMDSCOPE(' ')CMDSCOPE(nombre-gestcolas)2CMDSCOPE(*)23QSGDISP(QMGR)QSGDISP(COPY)QSGDISP(GROUP)23IGNSTATE(NO)4IGNSTATE(YES)
Notas:
  • 1 No válido en z/OS
  • 2 Sólo es válido en z/OS cuando el gestor de colas es miembro de un grupo de compartición de colas.
  • 3 Sólo válido en z/OS.
  • 4 Sólo es válido en AIX®, Linux®, and Windows.

Notas de uso para DELETE TOPIC

Descripciones de parámetros para DELETE TOPIC

(nombre-tema)
El nombre del objeto de tema administrativo que se va a suprimir. Este parámetro es necesario.

El nombre debe ser el de un objeto de tema administrativo existente.

AUTOR
Este parámetro no se aplica a sistemas 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.
[z/OS]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 ser el gestor de colas local, si QSGDISP está establecido como GROUP.
' '
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.
[z/OS]QSGDISP
Este parámetro se aplica únicamente a z/OS.

Especifica la disposición del objeto al que está aplicando el mandato (es decir, dónde está definido y cómo se comporta).

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 (excepto una copia local del objeto) no resulta afectado por este mandato.
Si el mandato es satisfactorio, 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 TOPIC(topic-name) QSGDISP(COPY)

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

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.

IGNSTATE de [AIX, Linux, Windows][MQ 9.3.0 Jun 2022]
Especifica si el mandato falla si el tema no existe. El valor puede ser uno de los siguientes:
NO
El mandato falla si el tema no existe. Éste es el valor predeterminado.
SÍ
El mandato se ejecuta correctamente independientemente de si el tema existe.