[AIX, Linux, Windows]

DISPLAY CHANNEL (visualizar definición de canal) MQTT

Utilice el comando MQSC DISPLAY CHANNEL (MQTT) para mostrar una definición de canal 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 CHANNEL (MQTT)

Sinónimo: DIS CHL

VISUALIZAR CANAL (MQTT)

Leer diagrama de sintaxisOmitir diagrama de sintaxis visual DISPLAY CHANNEL ( nombre-canal-genérico ) CHLTYPE ( MQTT ) WHERE(FilterCondition) ALL Atributos solicitados
atribs solicitados
Leer diagrama de sintaxisOmitir diagrama de sintaxis visual,BACKLOGJAASCFGLOCLADDRMCAUSERPORTPROTOCOLSSLCAUTHSSLCIPHSSLKEYPSSLKEYRTRPTYPEUSECLTID

El mandato DISPLAY CHANNEL (MQTT) sólo es válido para canales MQ Telemetry .

Descripciones de parámetros para DISPLAY CHANNEL (MQTT)

Debe especificar el nombre de la definición de canal que desea visualizar. Puede ser un nombre de canal específico o un nombre de canal genérico. Utilizando un nombre de canal genérico, puede visualizar:
  • Todas las definiciones de canal
  • Una o más definiciones de canal que coinciden con el nombre especificado
(nombre-canal-genérico)

El nombre de la definición del canal que se va a mostrar (véase Reglas para nombrar objetos IBM MQ). 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.

CHLTYPE(tipo)

El valor siempre es MQTT.

TYPE se puede utilizar como sinónimo de este parámetro.

WHERE

Especifique una condición de filtro para visualizar sólo los canales que cumplen 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 puede utilizar para mostrar atributos para este comando DISPLAY. Sin embargo, no puede utilizar los parámetros CMDSCOPE, QSGDISP o MCANAME como palabras clave de filtro. No puede utilizar TYPE (o CHLTYPE) si también se utiliza para seleccionar canales. Los canales de un tipo para los que la palabra clave de filtro no es un atributo válido no se visualizan.
operador
Esto se utiliza para determinar si un canal satisface el valor de filtro en la palabra clave de filtro proporcionada. 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 utilizarla para visualizar objetos cuyos atributos contienen el elemento especificado.
EX
No contiene un elemento especificado. Si la palabra clave de filtro es una lista, puede utilizarla para visualizar objetos cuyos atributos no contienen el elemento especificado.
CTG
Contiene un elemento que coincide con una serie genérica que se proporciona como valor-filtro. Si la palabra clave-filtro es una lista, puede utilizar esta opción para visualizar los objetos cuyos atributos coinciden con la serie genérica.
EXG
No contiene ningún elemento que coincida con una serie genérica que proporcione como valor-filtro. Si la palabra clave-filtro es una lista, puede utilizarla para visualizar objetos cuyos atributos no coinciden con la serie genérica.
valor del filtro
El valor con el que se debe comparar el valor del atributo utilizando el operador. Dependiendo de la palabra clave del filtro, 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 (por ejemplo, el valor SDR en el parámetro TYPE), sólo puede utilizar EQ o NE.

  • Un valor genérico. Se trata de una cadena de caracteres (como la cadena de caracteres que se suministra para el parámetro DESCR) con un asterisco al final, por ejemplo ABC*. Los caracteres deben ser válidos para el atributo que está comprobando. 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. El valor puede ser explícito o, si es un valor de carácter, puede ser explícito o genérico. Si es explícito, utilice CT o EX como operador. 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. Si es genérico, utilice CTG o EXG como operador. Si se especifica ABC* con el operador CTG, se listan todos los elementos en los que uno de los valores de atributo empieza por ABC.
TODOS

Especifique ALL para mostrar los resultados de la consulta de todos los parámetros. Si se especifica ALL, se ignora cualquier solicitud de un parámetro específico. El resultado de la consulta con ALL es devolver los resultados de todos los parámetros posibles.

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

Si no se especifica ningún parámetro (y el parámetro ALL no está especificado o predeterminado), por defecto sólo se muestran los nombres de los canales.

Parámetros solicitados

Especifique uno o varios parámetros DISPLAY CHANNEL que definen los datos que se van a visualizar. Puede especificar los parámetros en cualquier orden, pero no especifique el mismo parámetro más de una vez.

Algunos parámetros sólo son relevantes para canales de un tipo o tipos determinados. Los atributos que no son relevantes para un tipo determinado de canal no producen ninguna salida, ni se genera un error. La tabla siguiente muestra los parámetros que son relevantes para cada tipo de canal. Hay una descripción de cada parámetro después de la tabla. Los parámetros son opcionales a menos que la descripción indique que son necesarios.
BACKLOG

El número de solicitudes de conexiones pendientes que puede soportar el canal de telemetría a la vez. Cuando se alcance el límite de reserva, los clientes que intenten conectarse desde ese momento, se rechazarán hasta que se procese la reserva actual. El valor está dentro del rango de 0 a 999.999.999. El valor predeterminado es 4096.

CHLTYPE

Tipo de canal.

Sólo hay un valor válido para este parámetro: MQTT.

JAASCFG

El nombre de una stanza en el archivo de configuración JAAS.

LOCLADDR

La dirección de comunicaciones locales para el canal.

MCAUSER

Identificador de usuario del agente de canal de mensajes.

PORT

Número de puerto en el que el servicio de telemetría (MQXR) acepta conexiones de cliente.

PROTOCOLO

El protocolo de comunicación soportado por el canal.

SSLCAUTH

Define si IBM MQ requiere un certificado del cliente TLS.

SSLCIPH

Cuando se utiliza SSLCIPH con un canal de telemetría, significa Suite de cifrado TLS.

SSLKEYP

La contraseña del depósito de claves. Si no se especifica ninguna frase de contraseña, debe utilizar conexiones no cifradas.

SSLKEYR

El nombre del repositorio de claves TLS. Para más información, consulte el parámetro SSLKEYR del comando ALTER QMGR.

TRPTYPE

El protocolo de transmisión que se va a utilizar. Para un canal de telemetría, siempre es TCP (es decir, el protocolo TCP/IP).

USECLTID

Indica si desea utilizar el ID de cliente MQTT para la conexión como el ID de usuario IBM MQ para dicha conexión.

Para obtener más detalles de estos parámetros, consulte DEFINE CHANNEL (definir un canal nuevo) para MQTT.