DISPLAY TCLUSTER (visualizar atributos de tema de clúster)

Utilice el mandato MQSC DISPLAY TCLUSTER para visualizar los atributos del objeto de tema de clúster 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®.

Nota: El mandato DISPLAY TCLUSTER genera la misma salida que el mandato DISPLAY TOPIC TYPE(CLUSTER) . Consulte DISPLAY TOPIC (visualizar información de tema) para obtener más información sobre todos los atributos visualizados.

Sinónimo: DIS TCLUSTER

VISUALIZAR TCLUSTER

atribs solicitados

Notas:

¹ Sólo es válido en z/OS cuando el gestor de colas es miembro de un grupo de compartición de colas.
² Sólo es válido en z/OS.

Descripciones de parámetros para DISPLAY TCLUSTER

Debe especificar el nombre de la definición de tema de clúster que desea visualizar. Este nombre puede ser un nombre de tema de clúster específico o un nombre de tema de clúster genérico. Utilizando un nombre de tema genérico, puede visualizar:

(nombre-tema-genérico)

El nombre de la definición de tema de clúster administrativo que se va a visualizar (consulte Reglas para la denominación de objetos de IBM MQ ). Un asterisco final (*) coincide con todos los objetos de tema administrativo con la raíz especificada seguida de cero o más caracteres. Un asterisco (*) por sí mismo especifica todos los objetos de tema administrativo.

WHERE

Especifique una condición de filtro para visualizar sólo las definiciones de objeto de tema administrativo que satisfagan el criterio de selección de la condición de filtro. La condición de filtro está en tres partes: palabra clave-filtro, operadory valor-filtro:

palabra clave de filtro

Casi cualquier parámetro que se pueda utilizar para visualizar atributos para este mandato DISPLAY.

Sin embargo, no puede utilizar los parámetros CMDSCOPE o QSGDISP como palabras clave de filtro.

operador

Esta parte se utiliza para determinar si un objeto de tema satisface el valor de filtro en la palabra clave de filtro dada. Los operadores son:

LT: Menor que
GT: Mayor que
EQ: Igual que
NE: No es igual que
LE: Menor o igual que
GE: Mayor o igual que
LK: Coincide con una serie genérica que se proporciona como valor-filtro
NL: No coincide con una serie genérica que proporcione como valor-filtro

valor-filtro

El valor con el que se debe comparar el valor del atributo utilizando el operador. En función de la palabra clave de filtro, este valor puede ser:

Un valor explícito que sea un valor válido para el atributo que se está comprobando.
Sólo se pueden utilizar los operadores LT, GT, EQ, NE, LE o GE. Sin embargo, si el valor de atributo es uno de un posible conjunto de valores en un parámetro, sólo puede utilizar EQ o NE.
Un valor genérico. Este valor es una serie de caracteres (como la serie de caracteres que proporciona para el parámetro DESCR) con un asterisco al final, por ejemplo ABC*. Si el operador es LK, se listan todos los elementos en los que el valor del atributo empiece por la serie (ABC, en el ejemplo). Si el operador es NL, se listan todos los elementos en los que el valor del atributo no empiece por la serie. Sólo está permitido un único carácter comodín final (asterisco).
No puede utilizar un valor de filtro genérico para parámetros con valores numéricos o con uno de un conjunto de valores.

Nota: En z/OS hay un límite de 256 caracteres para el valor de filtro de la cláusula MQSC WHERE . Este límite no está en vigor para otras plataformas.

TODOS

Especifique este parámetro para visualizar todos los atributos. Si se especifica este parámetro, los atributos que se soliciten específicamente no tendrán ningún efecto; todos los atributos se seguirán visualizando.

Este es el valor predeterminado si no especifica un nombre genérico y no solicita ningún atributo específico.

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. Este 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 este proceso es el mismo que entrar el mandato en cada gestor de colas del grupo de compartición de colas.

No puede utilizar CMDSCOPE como palabra clave de filtro.

QSGDISP

Especifica la disposición de los objetos para los que se va a visualizar información. Los valores son:

DIRECTO

EN VIVO es el valor predeterminado y muestra información para los objetos definidos con QSGDISP (QMGR) o QSGDISP (COPY).

TODOS

Visualizar información para objetos definidos con QSGDISP (QMGR) o QSGDISP (COPY).

Si hay un entorno de gestor de colas compartido y el mandato se está ejecutando en el gestor de colas donde se ha emitido, esta opción también muestra información para los objetos definidos con QSGDISP (GROUP).

Si se especifica QSGDISP (ALL) en un entorno de gestor de colas compartido, el mandato puede dar nombres duplicados (con disposiciones diferentes).

En un entorno de gestor de colas compartido, utilice

DISPLAY TOPIC(name) CMDSCOPE(*) QSGDISP(ALL)

para listar TODOS los objetos que coinciden con name en el grupo de compartición de colas sin duplicar esos objetos en el repositorio compartido.

COPY

Visualizar información sólo para objetos definidos con QSGDISP (COPY).

GRUPO

Visualizar información sólo para objetos definidos con QSGDISP (GROUP). Esto sólo está permitido si hay un entorno de gestor de colas compartido.

PRIVATE

Visualizar información sólo para objetos definidos con QSGDISP (QMGR) o QSGDISP (COPY). QSGDISP (PRIVATE) muestra la misma información que QSGDISP (LIVE).

QMGR

Visualizar información sólo para objetos definidos con QSGDISP (QMGR).

QSGDISP

QSGDISP muestra uno de los valores siguientes:

QMGR: El objeto se ha definido con QSGDISP (QMGR).
GRUPO: El objeto se ha definido con QSGDISP (GROUP).
COPY: El objeto se ha definido con QSGDISP (COPY).

No puede utilizar QSGDISP como palabra clave de filtro.

CLÚSTER

Muestra temas con el nombre de clúster especificado. El valor puede ser un nombre genérico.

Atributos solicitados

CLROUTE

El comportamiento de direccionamiento que se debe utilizar para los temas del clúster definidos por el parámetro CLUSTER .

CLSTATE

El estado actual de este tema en el clúster definido por el parámetro CLUSTER . Los valores pueden ser los siguientes:

Activo: El tema de clúster está configurado correctamente y está siendo cumplido por este gestor de colas.
Pendiente: Sólo visto por un gestor de colas de host, este estado se notifica cuando el tema se ha creado pero el depósito completo todavía no lo ha propagado al clúster. Esto podría deberse a que el gestor de colas de host no está conectado a un depósito completo o a que el depósito completo ha considerado que el tema no era válido.
NO VÁLIDA: Esta definición de tema de clúster entra en conflicto con una definición anterior del clúster y, por lo tanto, no está activa actualmente.
ERROR: Se ha producido un error en relación con este objeto de tema.

Este parámetro normalmente se utiliza para ayudar a diagnosticar cuándo hay varias definiciones del mismo tema de clúster en distintos gestores de colas y las definiciones no son idénticas. Consulte Direccionamiento para clústeres de publicación/suscripción: Notas sobre el comportamiento.

CLÚSTER

La fecha en la que la información ha pasado a estar disponible para el gestor de colas local, con el formato yyyy-mm-dd.

CLUSQMGR

El nombre del gestor de colas que aloja el tema.

TIEMPO de clúster

La hora a la que la información ha pasado a estar disponible para el gestor de colas local, con el formato hh.mm.ss.

QMID

Nombre exclusivo generado internamente del gestor de colas que aloja el tema.

Notas de uso para DISPLAY TCLUSTER

En z/OS, el iniciador de canal debe estar en ejecución para poder visualizar información sobre temas de clúster.
El parámetro TOPICSTR puede contener caracteres que no se pueden convertir en caracteres imprimibles cuando se visualiza la salida del mandato.
En z/OS, estos caracteres no imprimibles se visualizan como espacios en blanco.

En Multiplatforms utilizando el mandato runmqsc , estos caracteres no imprimibles se visualizan como puntos.