DISPLAY TOPIC (visualizar información de tema)

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.

Notas de uso para DISPLAY TOPIC

1. En z/OS, el iniciador de canal debe estar en ejecución para poder visualizar información sobre temas de clúster, utilizando TYPE(CLUSTER) o el parámetro CLUSINFO .
2. 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 que utiliza el mandato runmqsc, estos caracteres no imprimibles se visualizan como puntos

3. Puede utilizar el siguiente mandato (o sinónimo) como una forma alternativa de visualizar estos atributos.

   DISPLAY TCLUSTER

   Este mandato genera la misma salida que el mandato siguiente:

   DISPLAY TOPIC TYPE(CLUSTER)

   Si especifica el mandato de esta forma, no utilice el parámetro TYPE .

Descripciones de parámetros para DISPLAY TOPIC

• Todas las definiciones de tema
• Una o más definiciones de tema que coinciden con el nombre especificado

(nombre-tema-genérico)

El nombre de la definición de tema 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 CMDSCOPEo 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á procesando 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

Solicita que, además de información sobre los atributos de los temas definidos en este gestor de colas, se muestre información sobre estos y otros temas del clúster que coincidan con los criterios de selección. En este caso, puede haber varios temas con la misma serie de tema visualizada. La información de clúster se obtiene del repositorio en este gestor de colas.

En z/OS, el iniciador de canal debe estar en ejecución para poder utilizar el parámetro CLUSINFO para visualizar información sobre temas de clúster.

CLÚSTER

Limita la información visualizada a los temas con el nombre de clúster especificado si se especifica con un valor entre corchetes. El valor puede ser un nombre genérico.

Si no especifica un valor para calificar este parámetro, se trata como un parámetro solicitado y se devuelve información de nombre de clúster sobre todos los temas visualizados.

En z/OS, el iniciador de canal debe estar en ejecución para poder utilizar el parámetro CLUSINFO para visualizar información sobre temas de clúster.

TIPO

Especifica el tipo de temas que desea visualizar. Los valores son:

TODOS

Visualizar todos los tipos de tema, incluidos los temas de clúster, si también especifica CLUSINFO.

LOCAL

Visualizar temas definidos localmente.

CLÚSTER

Visualizar temas definidos en clústeres de publicación/suscripción. Los atributos de clúster incluyen:

CLÚSTER

La fecha en la que la definició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 definición ha pasado a estar disponible para el gestor de colas local, con el formato hh.mm.ss.

QMID

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

Parámetros solicitados

Especifique uno o más parámetros que definan los datos que se van a visualizar. Los parámetros se pueden especificar en cualquier orden, pero no especifique el mismo parámetro más de una vez.

La mayoría de los parámetros son relevantes para ambos tipos de temas, pero los parámetros que no son relevantes para un tipo determinado de tema no causan salida, ni se genera un error.

La tabla siguiente muestra los parámetros que son relevantes para cada tipo de tema. Hay una breve descripción de cada parámetro después de la tabla, pero para obtener más información, consulte DEFINE TOPIC (definir un nuevo tema administrativo).

Tabla 1. Parámetros que puede devolver el mandato DISPLAY TOPIC

	Tema local	tema de clúster
ALTDATE
ALTTIME
CAPEXPRY
CLROUTE
CLSTATE
FECHA
CLUSQMGR
Clúster
TIEMPO clúster
COMMINFO
PERSONALIZADO
DEFPRTY
DEFPSIST
DEFPRESP
DESCR
DURSUB
MCAST
MDURMDL
MNDURMDL
NPMSGDLV
PMSGDLV
PROXYSUB
PUB
PUBSCOPE
QMID
SUB
SUBSCOPE
TOPICSTR
TYPE
USEDLQ
WILDCARD

ALTDATE

La fecha en la que se modificó por última vez la definición o información, con el formato yyyy-mm-dd.

ALTTIME

La hora a la que se modificó por última vez la definición o la información, con el formato hh.mm.ss.

CAPEXPRY

El tiempo máximo, expresado en décimas de segundo, hasta que un mensaje puesto en un manejador de objeto, abierto utilizando este objeto en la ruta de resolución, permanece en el sistema hasta que se convierte en elegible para el procesamiento de caducidad.

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.

CLÚSTER

El nombre del clúster en el que se encuentra 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.

COMMINFO

Nombre del objeto de información de comunicación.

PERSONALIZADO

Este atributo contiene pares nombre-valor que tienen la forma NOMBRE(VALOR). El valor es una lista de cero o más pares propiedad-valor, en sintaxis estilo MQSC, separados por al menos un espacio. Los nombres de atributos que comienzan por IBM, AMQ, CSQ, o MQ están reservados para uso exclusivo de IBM . Los atributos reservados adicionales son CAPEXPRY, SQGETTMR, y PAGEVAL.

DEFPRTY

Prioridad predeterminada de los mensajes publicados en este tema.

DEFPSIST

Persistencia predeterminada de los mensajes publicados en este tema.

DEFPRESP

Respuesta de colocación predeterminada para este tema. Este atributo define el comportamiento que deben utilizar las aplicaciones cuando el tipo de respuesta de colocación en las opciones MQPMO se ha establecido en MQPMO_RESPONSE_AS_TOPIC_DEF.

DESCR

Descripción de este objeto de tema administrativo.

DURSUB

Determina si el tema permite realizar suscripciones duraderas.

MCAST

Especifica si el tema está habilitado para multidifusión.

MDURMDL

El nombre de la cola modelo para suscripciones gestionadas duraderas.

MNDURMDL

Nombre de la cola modelo para suscripciones gestionadas no duraderas.

NPMSGDLV

Mecanismo de entrega para mensajes no persistentes.

PMSGDLV

Mecanismo de entrega para mensajes persistentes.

PROXYSUB

Determina si se fuerza una suscripción proxy para esta suscripción, aunque no existan suscripciones locales.

PUB

Determina si el tema está habilitado para la publicación.

PUBSCOPE

Determina si este gestor de colas propaga publicaciones a gestores de colas como parte de una jerarquía o como parte de un clúster de publicación/suscripción.

QMID

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

SUB

Determina si el tema está habilitado para la suscripción.

SUBSCOPE

Determina si este gestor de colas propaga suscripciones a gestores de colas como parte de una jerarquía o como parte de un clúster de publicación/suscripción.

TOPICSTR

La serie de tema.

TIPO

Especifica si este objeto es un tema local o un tema de clúster.

USEDLQ

Determina si se utiliza la cola de mensajes no entregados cuando no se pueden entregar mensajes de publicación a la cola de suscriptores correcta.

WILDCARD

El comportamiento de las suscripciones comodín con respecto a este tema.