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 all message properties, see Message Properties.

Some of the content described in this article is available in meshIQ Manage versions 11.1.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 11.2 and Earlier
Version 12.x and Later

Version 11.2 and Earlier

Adding IBM MQ 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 a Message viewlet.
  
• Or, select Messages > Put New from a queue's Action menu (Selected menu in 11.2).
  

The instructions below explain how to add a message from the queue's Action menu (Selected menu in 11.2).

1. Within the queue viewlet, select the queues you want to put messages on. From the Action menu (Selected menu in 11.2), select Messages > Put New Message. In the example below, the two queues selected are on queue managers AB.MQ.Q.02 and AB.MQ.Q.03.
   
2. On the General tab of 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. 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.
  • If Put Failed:  Select the action that should be taken if Put command fails.
  • Contains headers:  The header(s) in the message. Select MD1, MDE, DLH and/or XQH. Please note that DLH and XQH cannot be selected together.
  • File attachment:  Enter the path of the file to attach to the message.
  • Message Criteria: Select from the Criteria list to apply Message Criteria. By default, the Message Criteria from User Settings or Global Settings is selected. You can also select other Message Criteria records.
  • Data:  Within the Data section, select the message data type (text, hex XML or JSON). Check the Text only checkbox to display the message content as text only.  Unchecking Text only will display the message content with offsets which increases the load on the browser and should be used only for small messages. The message encoding type can be changed, select this from the Encoding drop-down. 

3. Enter details on the MD, MD1, MDE, DLH, XQH and PMO tabs as needed.  Review the MD options to ensure that they meet your expectations for message type. 

4. Click Ok.
   

5. Ten messages are now added to each of the selected queues. 

Viewing the put messages

1. Click on one of the queues you put messages on.
   

2. A new viewlet opens within the Console panel and displays all of the selected queue’s messages. 
   

3. Select one of the messages and select View message from the Action menu (Selected menu in 11.2) to view more details.
   

4. The View message window opens. You can see details such as the format of the message (Hex, Text, XML, or JSON). In the example below, the message is of Text format. You can also see whether there are message properties (view these by clicking the MsgProp button).
   

5. Click Cancel to return to the dashboard. Using the buttons located at the top left of the viewlet, you can perform actions such as editing, deleting and moving messages.
   

______________________________________________________________________________________________________________

Version 12.x and Later

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

Use one of the following methods to open the dialog:

• From a Queue viewlet, open the Selected menu and choose Messages > Put New Message.
• Click the Put New button from the Console tab while browsing messages.
  

   

The instructions below explain how to add a message using the menu option:

1. In the queue viewlet, select the queue 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.)
3. The Add New Message To dialog opens.
   
4. 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.
   • If Put Failed: Select an action to take if the Put command fails. Options include Stop, Continue, or Exclude.
   • Message Criteria: Choose a record from the Criteria list to apply Message Criteria. By default, the system uses the criteria selected in User Settings, but you can choose another record if needed.

5. Set Message Headers:

   • In the Contains Headers section, select from the following header types: MD, MD1, MDE, DLH, XQH, RFH2, JMS, and PMO.

     • You cannot select both DLH and XQH together.

     • You cannot select both RFH2 and JMS together.

   • To configure a selected header:

     • Click the checkbox next to MD, MD1, MDE, DLH, XQH, or PMO.
     • Click the  icon to open the Properties dialog.
     • Review and update the fields to match your message type and requirements.
6. If needed, use the File attachment feature. Click Choose File, then locate and select the file to attach.
7. 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.
8. Click Save to submit the message.

Viewing the Put Messages

1. Select the queues where you put messages, or check the box next to it and choose Browse Message from the Selected menu.
   

2. A tab opens within the Console panel, displaying all messages from the selected queue.
   

3. Select one of the messages in the Console tab. From the Selected menu, choose View Message.

   

4. The View Message window 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.

5. 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.