Example

This example demonstrates how to use this Listener to receive and deserialize temperature readings from 'AGENT 1', an XMQ Action Agent in a different Data Stream. It is designed to work with the XMQ Action Agent Example.

Refer to configuration to understand all configuration options of this Agent.

Step 1: Add the Agent

Drag the XMQ Listener onto the canvas, link the output endpoint to the JSON Deserializer, and save the Data Stream.

Step 2: Configure General

Select the Agent and click Configure. Keep the default Collection.

Step 3: Configure Settings

Set the Address to any port on the 127.0.0.1 host with the TCP protocol. This example uses tcp://127.0.0.1:3339. Set the Identity to "LISTENER 1" and add to the Subscriptions box the value "AGENT 1", which is the Identity used in the XMQ Action Agent example.

Step 4: Configure Authentication

Tick the Use Authentication box. If you have previously generated a Server Key that you wish to apply, enter it into the Server Key field.

Alternatively, click Generate Key. Once here, click the Generate New Key button. Then, select and copy the entire value, store it in a secure Variable or a temporary location for later use, then enter the value into the Server Key field. Please see the XMQ Action Agent example for a demonstration.

Step 5: Results

Apply the changes, save the Data Stream and publish it. You will also need to publish the XMQ Action Agent example with similar configuration.

Let's look at the Live Data View. The Listener is receiving data from the Action Agent example Data Stream, which the Json Deserializer agent is processing and turning into usable data.