To control the properties of messages that are created during the Put New or Load from File processes, see the Message Commands Tab.

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

Add New Messages to EMS Queue

Adding messages to queues is performed on the Add New Message To: queue_name dialog.

You can open this dialog in one of two ways:

Click the Put New button from the Console tab while browsing messages.
From a Queue widget, open the Selected menu and choose Messages > Put New Message. The Add New Message To dialog opens.

The instructions below explain how to add a message in the Add New Message To: queue_name dialog.

Enter the following details:
- Number of Messages: Enter the number of messages to put into a queue.
  Example: If you enter “Sample test message” and set the quantity to 10, the same message will be added ten times.
- Message Size (bytes): This field displays the size of the message content being entered. The default value is 1, but you can increase it as needed.
In the Contains Headers section, click the checkbox next to JMS and then click the icon. The EMS JMS Headers dialog opens, allowing you to configure the following fields:
- JMS Delivery Mode: Select the delivery mode for the message. Options typically include PESISTANT, NON_PERSISTANT or RELIABLE.
- JMS Correlation ID: Enter a correlation identifier to link this message with another, such as in request-reply messaging patterns.
- JMS Expiration: Set the time-to-live (TTL) in milliseconds. A value of 0 means the message will not expire.
- JMS Priority: Specify a priority level from 0 (lowest) to 9 (highest).
  The default is typically 4, which represents normal priority.
If needed, use the File attachment feature. Click Choose File, then locate and select the file to attach.
Choose a format—Text, Hex, XML, or JSON—to write the message. The message will appear in the selected format. You can change the message encoding type by selecting a value from the Encoding drop-down.
Click Save to add the message immediately, or click Schedule to add it later. (See Scheduling Jobs.)
Messages are now added to the selected queues.

Viewing the Put Messages

Select the queues where you put messages, select the checkbox next to each queue, and then choose Browse Message from the Selected menu.
A new tab opens within the Console panel, displaying all messages from the selected queue.
Select a message in the Console tab. From the Selected menu, choose View Message, or simply click the message.
The View Message dialog opens, where you can see the message format—Text, Hex, Xml, or Json (Text format in the example shown)—and check for message properties by clicking the MsgProp option.
Use the buttons located at the top left of the Console tab to perform actions such as deleting, copying, moving, editing, or saving messages. Click Cancel to return to the dashboard.

______________________________________________________________________________________________________________

Version 11.3 and Earlier

Add New Messages to EMS Queue

Adding messages to queues is performed on the Add new message to: queue_name dialog.

You get to this window in one of two ways:

Click the Put New button from the Console tab while browsing messages.
From a Queue viewlet, open the Action menu (Selected menu from v11.2 onwards) and choose Messages > Put New Message. The Add New Message To: queue_name dialog opens.

The instructions below explain how to add a message in the Add New Message To: queue_name dialog.

On the General tab, enter the following details:
- Number of Messages: Enter the number of messages to put into a queue. In the example below, “Sample test message” is entered as the message and a quantity of ten will be added to both queues.
- Message Size (bytes): Displays the size of the message text being entered or created in the Data field.
- File attachment: If needed, click , then locate and select the file to attach.
- Data: Within the Data section, select the message data type (Text, Hex, XML or JSON). The message encoding type can be changed by using the Encoding list.
Select the Headers tab, and configure the following fields:
- JMS Delivery Mode: Select the delivery mode for the message. Options typically include PESISTANT, NON_PERSISTANT or RELIABLE.
- JMS Correlation ID: Enter a correlation identifier to link this message with another, such as in request-reply messaging patterns.
- JMS Expiration: Set the time-to-live (TTL) in milliseconds. A value of 0 means the message will not expire.
- JMS Priority: Specify a priority level from 0 (lowest) to 9 (highest).
  The default is typically 4, which represents normal priority.
Click Ok to add the message immediately, or click Schedule to add it later. (See Scheduling Jobs.)
Messages are now added to the selected queues.

Viewing the Put Messages

Select the queue where you want to put the message, or select its checkbox and choose Browse Message from the Action menu (Selected menu in v11.2 and later).
A new tab opens within the Console panel, displaying all messages from the selected queue.
Select a message in the Console tab. From the Selected menu, choose View Message, or simply click the message.
The View message window opens. You can see details such as the format of the message (Hex, Text, XML, or JSON). You can also see whether there are message properties (view these by clicking the MsgProp button).
Use the buttons located at the top left of the Console tab to perform actions such as deleting, copying, moving, editing, or saving messages. Click Cancel to return to the dashboard.