To control the properties of messages that are created during the Put New or Load from File processes, see the Message Commands Tab.
For field descriptions of Kafka message properties, see Message Properties for Kafka.

Some of the content described in this article is available in meshIQ Manage versions 12.1 and later.
For a quick overview of what's new or changed, visit the meshIQ Highlights page for a version-by-version breakdown.  

Jump to Section:
Version 12.x and Later
Version 11.3 and Earlier

Version 12.x and Later

The instructions below explain how to add a message to a Kafka topic or partition.

1. In the topic or partition widget, select the topic or partition where you want to put messages.
2. From the Selected menu, choose Messages > Put New Message.
   (Alternatively, click the Put New button from the Console tab while browsing messages.)
   
3. The Add New Message To dialog opens.
   
4. In the Number of Messages field, enter how many messages you want to send.
5. In the Message Size (bytes) field, enter the desired size. The default value is 1.
6. (Optional.) Enter a Message Key. By default, a Kafka message is placed on a partition according to its key.
7. If putting a message on a topic, specify a Partition, if needed.

   • If you do not specify a partition, Kafka uses the key to determine it.

   • If you are putting a message directly to a partition, the Partition field is not shown.

8. In the Contain Header section, check the Header checkbox and click the icon to open the Kafka Header dialog.
   

   • Enter the Header Name and its corresponding Value, then click Add.

   • Repeat as needed, and click Save.

9. If needed, use File Attachment to import messages. Click Choose File. Locate and select the file you want to attach.
10. In the Message body field, optionally enter the message content.
11. Select a format—Text, Hex, Xml, or Json—to write the message. The message appears in the selected format. The message encoding type can be changed, select this from the Encoding drop-down. 
12. Click Save to add the message immediately, or click Schedule to add it later. (See Scheduling Jobs.)
    Messages are now added to the selected topics or partitions. . 

_____________________________________________________________________________________________________________

Version 11.3 and Earlier

Adding messages to Kafka topics and partitions is performed in the Add New Message To dialog.

You can get to this window in one of two ways:

• Click the Put New button from a Message viewlet.
• Or, select Messages > Put New Message from the Action menu of a topic or partition (this is the Selected menu in 11.2). The Add New Message to dialog opens.

The instructions below explain how to add a messages in the Add New Message to dialog.

1. On the General tab, Specify the Number of Messages.
   
2. The Message Size (bytes) is filled in as you .
3. If applicable, use the File attachment browse button to locate a file to attach to the message.
4. (Optional.) Enter a Message Key. By default, a Kafka message is placed on a partition according to its key.
5. When putting a message on a topic, you can also specify a Partition for the message to go to. If you don’t specify a partition, the Key is used to determine the partition. (If you are putting a message to a specific Partition, the Partition field is not shown.)
6. Within the Data section, enter the message body. You can check the Text only checkbox to display the message content as text, or leave it off to view message content as code.
7. Select the Headers tab. Add headers as Key-Value pairs:
   1. Enter the Header Name and its corresponding Value.
      
   2. Click . 
8. Click Ok to add the message immediately, or click Schedule to add it later. (See Scheduling Jobs.)
   Messages are now added to the selected topics or partitions.