ltm rule command MQTT protocol version

iRule(1)		      BIG-IP TMSH Manual		      iRule(1)



MQTT::protocol_version
       Get or set protocol revision level of MQTT CONNECT message

SYNOPSIS
       MQTT::protocol_version (VERSION)?

DESCRIPTION
       This command can be used to get or set protocol revision level of MQTT
       message.  This command is valid only for following MQTT message types:

	   CONNECT

       Syntax

       MQTT::protocol_version [  ]

       MQTT::protocol_version
	   * Get the protocol revision level of MQTT CONNECT message.

       MQTT::protocol_version 
	   * Set the protocol revision level of MQTT CONNECT message.
	     To set to MQTT 3.1.1 specify 4. (MQTT::protocol_version 4).
	     To set to MQTT 3.1 specify 3. (MQTT::protocol_version 3).

RETURN VALUE
       When called without an argument, this command returns the protocol
       revision of MQTT CONNECT message

VALID DURING
       MQTT_CLIENT_INGRESS MQTT_SERVER_INGRESS MQTT_CLIENT_DATA
       MQTT_SERVER_DATA MQTT_CLIENT_EGRESS MQTT_SERVER_EGRESS

EXAMPLES
	# Upgrade protocol from 3.1 to 3.1.1
	when MQTT_CLIENT_INGRESS {
	   set type [MQTT::type]
	   switch $type {
	       "CONNECT" {
		  if {[MQTT::protocol_version] == 3 } {
		     MQTT::protocol_version 4
		     MQTT::protocol_name "MQTT"
		  }
	       }
	   }
	}

HINTS
SEE ALSO
CHANGE LOG
       @BIGIP-13.0.0 --First introduced the command.



BIG-IP				  2018-07-19			      iRule(1)