![[AIX, Linux, Windows]](ngalw.gif)
ALTER CHANNEL (modificar valores de canal) MQTT
Diagrama de sintaxis para un canal de telemetría cuando se utiliza el mandato ALTER CHANNEL .
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.
Sinónimo: ALT CHL
Notas de uso
El servicio de telemetría (MQXR) debe estar en ejecución cuando se emite este mandato. Para obtener instrucciones sobre cómo iniciar el servicio de telemetría (MQXR), consulte Configuración de un gestor de colas para telemetría en Linux® o Configuración de un gestor de colas para telemetría en Windows .
Descripciones de parámetros para ALTER CHANNEL (MQTT)
- (nombre-canal)
El nombre de la definición de canal.
- BACKLOG (entero)
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.
- CHLTYPE
Tipo de canal. Canal MQTT (telemetría).
- JAASCFG (serie)
El nombre de una stanza en el archivo de configuración JAAS.
- LOCLADDR (dirección-ip)
LOCLADDR es la dirección de comunicaciones local para el canal. Utilice este parámetro si desea forzar al cliente a utilizar una dirección IP determinada. LOCLADDR también es útil para forzar a un canal a utilizar una dirección IPv4 o IPv6 si hay una opción disponible, o para utilizar un adaptador de red determinado en un sistema con varios adaptadores de red.
- MCAUSER (serie)
Identificador del usuario del agente de canal de mensajes.
- PORT (entero)
Número de puerto en el que el servicio de telemetría (MQXR) acepta conexiones de cliente. El número de puerto predeterminado para un canal de telemetría es 1883; y el número de puerto predeterminado para un canal de telemetría seguro utilizando SSL es 8883. La especificación de un valor de puerto de 0 hace que MQTT asigne dinámicamente un número de puerto disponible.
- PROTOCOLO
- El canal da soporte a los siguientes protocolos de comunicación:
- MQTTV311
- El canal acepta conexiones de clientes utilizando el protocolo definido por el estándar Oasis MQTT 3.1.1 . La funcionalidad proporcionada por este protocolo es casi idéntica a la proporcionada por el protocolo MQTTV3 preexistente.
- MQTTV3
- El canal acepta conexiones de clientes utilizando la especificación de protocolo MQTT V3.1 de mqtt.org.
- HTTP
- El canal acepta peticiones HTTP de páginas, o conexiones WebSockets a MQ Telemetry.
Para aceptar conexiones de clientes que utilizan protocolos diferentes, especifique los valores aceptables como una lista delimitada por comas. Por ejemplo, si especifica MQTTV3,HTTP, el canal acepta conexiones de clientes que utilicen MQTTV3 o HTTP. Si no especifica ningún protocolo de cliente, el canal acepta conexiones de clientes utilizando cualquiera de los protocolos soportados.
Si utiliza IBM MQ 8.0.0 Fix Pack 3 o posterior, y la configuración incluye un canal MQTT que se modificó por última vez en una versión anterior del producto, debe cambiar explícitamente el valor de protocolo para solicitar al canal que utilice la opción MQTTV311 . Esto es así incluso si el canal no especifica ningún protocolo de cliente, porque los protocolos específicos que se van a utilizar con el canal se almacenan en el momento en que se configura el canal y las versiones anteriores del producto no tienen conocimiento de la opción MQTTV311 . Para solicitar a un canal en este estado que utilice la opción MQTTV311 , añada explícitamente la opción y, a continuación, guarde los cambios. La definición de canal ahora es consciente de la opción. Si posteriormente vuelve a cambiar los valores y no especifica ningún protocolo de cliente, la opción MQTTV311 se sigue incluyendo en la lista almacenada de protocolos soportados.
- SSLCAUTH
- Define si IBM MQ requiere un certificado del cliente TLS. El extremo iniciador del canal actúa como el cliente TLS, por lo que este parámetro se aplica al extremo del canal que recibe el flujo de iniciación, que actúa como el servidor TLS.
- Nunca
- IBM MQ nunca solicita un certificado del cliente TLS.
- OBLIGATORIO
- IBM MQ requiere y valida un certificado del cliente TLS.
- OPCIONAL
- IBM MQ permite al cliente TLS decidir si proporciona un certificado. Si el cliente envía un certificado, el contenido de este certificado se valida como normal.
- SSLCIPH(serie)
Cuando se utiliza SSLCIPH con un canal de telemetría, significa Suite de cifrado TLS. La suite de cifrado TLS es la soportada por la JVM que se ejecuta el servicio de telemetría (MQXR). Si el parámetro está en blanco, no se intenta utilizar TLS en el canal.
- SSLKEYP (serie)
La frase de contraseña para el repositorio de claves TLS.
![[MQ 9.3.0 Jun 2022]](ng930.gif)
Si el servicio MQXR se configura para el cifrado de frases de contraseña especificando la opción -sf en STARTARG para el servicio, la frase de contraseña se cifrará. Para obtener más información sobre el cifrado de las frases de contraseña, consulte Cifrado de frases de contraseña para canales TLS de MQTT.- SSLKEYR (serie)
El nombre completo de la vía de acceso del archivo de repositorio de claves TLS, el almacén de certificados digitales y sus claves privadas asociadas. Si no se especifica un archivo de claves, no se utiliza TLS.
La longitud máxima de la serie es de 256 caracteres;![[AIX]](ngaix.gif)
![[Linux]](nglinux.gif)
En AIX® y Linux, el nombre tiene el formato pathname/keyfile.![[Windows]](ngwin.gif)
En Windows, el nombre tiene el formato pathname\keyfile.
- TRPTYPE
(string) - El protocolo de transmisión que se utilizará:
- TCP
- TCP/IP.
- USECLTID
Decida si desea utilizar el ID de cliente de MQTT para la nueva conexión como el ID de usuario de IBM MQ para dicha conexión. Si se especifica esta propiedad, se ignora el nombre de usuario que proporciona el cliente.