Programa de utilidad cliente MQTT

El programa de utilidad cliente MQTT es una aplicación Java™ con que puede explorar las funciones de MQTT, es decir, la conexión a un gestor de colas y la publicación y suscripción a temas.

Puede utilizar un programa de utilidad cliente para verificar su configuración de telemetría (por ejemplo, cuando crea un canal de telemetría), o el cliente puede servir de ayuda cuando va a desarrollar y depurar aplicaciones. Para obtener más información sobre las funciones y propiedades del programa de utilidad cliente, consulte las descripciones siguientes:

Publicar
Publique un mensaje con un tema que se distribuirá entre los suscriptores interesados.
Suscribir
Los clientes y el escucha MQXR pueden registrar su interés en un tema suscribiéndose éste y, así, poder recibir los mensajes publicados en dicho tema.
Tema
El tema es la clave que identifica el canal de información en el que se publican los mensajes. Los suscriptores utilizan el nombre de tema para identificar los canales de información de los que desean recibir mensajes publicados.
Comodines de los temas

Una suscripción puede contener caracteres especiales y puede suscribirse a varios temas a la vez. Se utiliza un separador de nivel de tema, la barra inclinada (/), para separar cada nivel dentro de un tema, creando una estructura jerárquica. Por ejemplo, ibm/qmgr/apple. Los separadores de nivel de tema permiten más flexibilidad y simplifican la gestión de temas.

Para los suscriptores, se soportan dos caracteres comodines:
  • El signo de número (#) corresponde a cualquier número de nivel dentro de un tema. Por ejemplo, si se suscribe al tema ibm/qmgr/#, recibe mensajes sobre los temas ibm/qmgr/apple e ibm/qmgr/orange.

  • El signo más (+) corresponde sólo a un nivel de tema. Por ejemplo, ibm/qmgr/+ corresponde a ibm/qmgr/apple pero no a ibm/qmgr/apple/queue.

    Puede utilizar el signo + al final de un árbol de temas o dentro del árbol de temas. Por ejemplo, ibm/+ e ibm/+/orange no son válidos.

Los temas de publicaciones no pueden contener ninguno de los signos + o #.

Mensaje
Un mensaje, en el contexto de un programa de utilidad cliente MQTT, hace referencia a la carga útil del mensaje distribuido a los suscriptores que muestran interés en un tema. Los mensajes pueden estar formados por caracteres alfanuméricos.
Calidad de servicio (QoS)
El programa de utilidad cliente MQTT proporciona tres calidades de servicio, que figuran a continuación:
Como máximo una vez (QoS = 0)
  • El mensaje se entrega como máximo una vez, si no, no se entrega. No hay acuse de recibo del mensaje.
  • El mensaje puede perderse si se desconecta el cliente o si falla el servidor.
Como mínimo una vez (QoS = 1)
  • El mensaje se entrega como mínimo una vez. Se puede entregar varias veces si no se recibe el acuse de recibo después de un periodo de tiempo, o si se detecta un fallo y la sesión de comunicaciones se reinicia.
  • El mensaje debe almacenarse localmente en el sistema del remitente hasta que se reciba un acuse, por si debe enviarse de nuevo. Los mensajes pueden llegar duplicados a la aplicación receptora.
Exactamente una vez (QoS = 2)
  • Éste es el nivel más alto de entrega en el que el mensaje se entrega sólo una vez. Se presupone la entrega, pero los mensajes duplicados no se entregan en la aplicación receptora.
Retenido
Esta opción se utiliza sólo cuando se publican mensajes. Determina si el servidor MQTT (el gestor de colas en IBM® MQ) retiene un mensaje, de la publicación en un tema, después de que se entregue a los suscriptores actuales. Si crea una suscripción a un tema que tiene alguna publicación retenida, recibirá inmediatamente la publicación retenida más reciente que haya en el tema.
Última voluntad y testamento
Ésta es una opción de conexión que determina el mensaje que se envía a IBM MQ, en el caso en el que el cliente MQTT se desconecte de forma inesperada. Esta opción incluye tema, mensaje, QoS y la opción para retener la publicación. Considere la configuración de QoS en 1 ó 2 para garantizar la entrega.
Limpiar sesión
Al iniciar un cliente MQTT con una sesión limpia, se eliminan todas las publicaciones pendientes y todas las suscripciones antiguas que existían en el cliente antes de la conexión. Si no existe ninguna sesión previa, el programa de utilidad cliente inicia una nueva sesión.
Historial del cliente
El historial del cliente ofrece información sobre los sucesos que ocurren mientras que se utiliza el programa de utilidad cliente MQTT. Algunos ejemplos de sucesos son: Conectado, Desconectado, Publicado o Suscrito.

Visualice los detalles completos de una entrada seleccionando la entrada y pulsando la tecla Intro. También puede hacerlo pulsando dos veces la entrada.

Cambie el orden de las columnas en el historial del cliente arrastrando los nombres de columna y colocándolos en el orden que elija.