Configure Message Exchanges
Using a message exchange, you can send a message to one or more standard queues that are bound to the message exchange. The maximum size of a message sent to a message exchange is 10 MB.
FIFO does not support the use of a message exchange. Similarly, FIFO queues cannot be bound to a message exchange.
Before creating a message exchange, create one or more queues. For information, see Create Queues.
To create a message exchange:
-
Log in to Anypoint Platform.
-
Click MQ from the left navigation area or the main Anypoint Platform screen.
-
Click Destinations.
-
Click the blue plus-circle icon to display the menu:
-
Click Exchange.
-
In the Create Exchange page, name the message exchange.
Message exchange names can contain up to 127 alphanumeric characters (a-z, A-Z, 0-9), periods (.), and hyphens (-). They cannot contain spaces or other characters.
-
Click the checkboxes to bind queues to this message exchange:
-
Click Save Changes.
-
In the Destinations page, click the message exchange type for the new exchange to display its details in the right pane:
Bind a Queue to a Message Exchange
To bind a queue to a message exchange:
-
In Anypoint Platform > MQ, click Destinations in the left pane.
-
Click the message exchange ID to display the Exchange Settings page:
-
In the settings page, click Bind or Unbind for each queue you want to bind to or unbind from the message exchange.
Send a Message to a Message Exchange
Sending a message to a message exchange is similar to sending a message to a queue. The only difference is that you can get the message from any queue bound to a message exchange. The maximum size for a message sent to a message exchange is 10 MB.
To send a message to a message exchange:
-
In Anypoint Platform > MQ, click Destinations in the left pane.
-
Click the message exchange ID to display the Exchange Settings page:
-
In the settings page, click Message Sender in the left pane:
-
Leave the Type field set to Text.
-
Enter text in the Payload field, such as
Hello Queues from myMessageExchange. -
Click Send.
-
Click View Messages for a queue that is bound to the exchange to view the queue with the Message Browser.
You also send JSON content or comma-separated values (CSV) in the payload by changing the message Type value. See Send a JSON Message to a Queue and Send a CSV Message to a Queue.
Delete a Message Exchange
If a message exchange is no longer needed, you can delete it. All queue bindings for the deleted exchange queue are lost. Clients can’t publish or subscribe to the exchange.
To delete a message exchange:
-
In Anypoint Platform > MQ, click Destinations in the left pane.
-
In the Destinations page, click the message exchange type for the exchange to display its details in the right pane.
-
Click the trash can icon in the upper right:
-
In the Delete Exchange page, click the checkbox, and then click Delete Exchange:
