DISPLAY CHSTATUS (visualizar estado de canal) MQTT

Utilice el comando MQSC DISPLAY CHSTATUS (MQTT) para mostrar el estado de uno o más canales MQ Telemetry.

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.

Diagrama sintáctico para DISPLAY CHSTATUS (MQTT)
Descripciones de parámetros para DISPLAY CHSTATUS (MQTT)
Atributos de resumen

Diagrama sintáctico para DISPLAY CHSTATUS (MQTT)

Sinónimo: DIS CHS

VISUALIZAR CHSTATUS (MQTT)

SummaryAttributes

DetailAttributes

Notas:

El comportamiento predeterminado es que RUNMQSC devuelva un resumen de las conexiones al canal. Si se especifica CLIENTID , RUNMQSC devuelve detalles de cada cliente conectado al canal.
Se puede especificar CLIENTID, SUMMARYo ninguno, pero no ambos al mismo tiempo.
El mandato DISPLAY CHSTATUS para MQ Telemetry tiene el potencial de devolver un número de respuestas mucho mayor que si el mandato se ejecutara para un canal de IBM MQ . Por este motivo, el servidor de MQ Telemetry no devuelve más respuestas que las que caben en la cola de respuestas. El número de respuestas está limitado al valor del parámetro MAXDEPTH delSYSTEM.MQSC.REPLY.QUEUE. Cuando RUNMQSC procesa un comando MQ Telemetry truncado por el servidor MQ Telemetry, se muestra el mensaje AMQ8492 especificando cuántas respuestas se devuelven en función del tamaño de MAXDEPTH.
Puede utilizar este mandato para listar los clientes desconectados. Puesto que estos clientes no están asociados a un canal determinado, puede listarlos utilizando el carácter comodín. Por ejemplo,
```
DIS CHS(*) CHLTYPE(MQTT) CLIENTID(*) WHERE(STATUS EQ DISCONNECTED).
```
Debe tener cuidado al utilizar este mandato cuando pueda haber un gran número de clientes desconectados.

Descripciones de parámetros para DISPLAY CHSTATUS (MQTT)

Debe especificar el nombre del canal cuya información de estado desea visualizar. Este parámetro puede ser un nombre de canal específico o un nombre de canal genérico. Si utiliza un nombre de canal genérico, podrá visualizar la información de estado de todos los canales, o bien la información de estado de uno o más canales que coincidan con el nombre especificado.

( generic-channel-name )

Nombre de la definición de canal para la que se debe mostrar información de estado. Un asterisco final (*) especifica todas las definiciones de canal con la raíz indicada seguida de cero o más caracteres. Un asterisco (*) sin más especifica todas las definiciones de canal. Se necesita un valor para todos los tipos de canal.

WHERE

Especifique una condición de filtro para visualizar información de estado para los canales que cumplan los criterios 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

El parámetro que se debe utilizar para visualizar los atributos de este mandato DISPLAY.

No se muestra información de estado para los canales de un tipo para el cual la palabra clave de filtro no es válida.

operador

Se utiliza para determinar si un canal satisface el valor de filtro en la palabra clave de filtro. 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
CT: Contiene un elemento especificado. Si la palabra clave-filtro es una lista, puede utilizar este operador para visualizar los objetos cuyos atributos contienen el elemento especificado.
EX: No contiene un elemento especificado. Si la palabra clave-filtro es una lista, puede utilizar este operador para visualizar objetos cuyos atributos no contienen el elemento especificado.

valor del 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 es un valor válido para el atributo que se está probando.
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 (por ejemplo, el valor SDR en el parámetro CHLTYPE), sólo puede utilizar EQ o NE.
Un valor genérico. Este valor es una serie de caracteres 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.
Un elemento en una lista de valores. Utilice los operadores CT o EX. Por ejemplo, si el valor DEF se especifica con el operador CT, se listan todos los elementos en los que DEF es uno de los valores del atributo.

ALL

Especifique este parámetro para visualizar toda la información de estado para cada instancia relevante.

Si se especifica este parámetro, cualquier parámetro que solicite información de estado específica que también se especifique no tendrá ningún efecto; se visualizará toda la información.

Atributos de resumen

Cuando se añade SUMMARY al comando MQSC DISPLAY CHSTATUS (MQTT), el número de conexiones se muestra como el atributo CONNECTIONS. Los atributos siguientes muestran un resumen para cada canal.

TODOS: Especifique este parámetro para visualizar toda la información de estado para cada instancia relevante. Este atributo es el valor predeterminado si no se solicita ningún atributo.; Este parámetro es válido para canales MQTT .; Si se especifica este parámetro, los parámetros especificados que solicitan información de estado específica no tienen ningún efecto; y se visualiza toda la información.
CONEXIONES: Número de conexiones actuales con este canal.
Estado: El estado de este canal.

Modalidad de detalles de cliente

Estado: Estado del cliente.
CLNTUSER: El ID de usuario que el cliente ha proporcionado al conectarse.
CONNAME: El nombre de la conexión remota (dirección IP)
KAINT: El intervalo de mantenimiento activo del cliente.
MCAUSER: El ID de usuario que utiliza el cliente para acceder a los recursos de IBM MQ . Este es el ID de usuario de cliente seleccionado por el proceso descrito en Identidad de cliente y autorización deMQTT.
MSGSNT: Número de mensajes enviados por el cliente desde que se conectó por última vez.
MSGRCVD: Número de mensajes recibidos por el cliente desde que se conectó por última vez.
INDOUBTIN: Número de mensajes de entrada dudosos para el cliente.
INDOUBTOUT: Número de mensajes de salida dudosos para el cliente.
PENDING: Número de mensajes pendientes de salida.
PROTOCOLO: Protocolo de comunicación utilizado por el cliente. Se trata de MQTTV311, MQTTV3 o HTTP.
LMSGDATE: Fecha de recepción o envío del último mensaje.
LMSGTIME: Hora a la que se recibió o envió el último mensaje.
FECHA DE CHL: Fecha de inicio del canal.
CHLSTIME: Hora a la que se inició el canal.