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

From the Queues/Topics widget, you can export all messages to an .MMF or .TXT file, or to Shared Storage.

While browsing messages in the Console panel, you can export either all messages or only selected messages. You can also access the additional option to download the message list as a CSV file.

To save or export files to Shared Storage, you must specify a valid directory path in the Directory to be used for MMF Shared Storage field (located in Enterprise Manager > MQM Properties > MMF Shared Storage tab).
This option is available for IBM MQ queues, Kafka topics and partitions, ActiveMQ queues, and EMS queues.

Exporting All Messages from the Console Panel or a Queues/Topics Widget

You can export all messages either from the Console panel (while browsing) or directly from a Queues/Topic widget. The process is largely the same in both contexts.

1. From a Queues widget

   • Check the box next to the desired queue.

   • From the Selected menu, choose: Messages > Export All Messages >

     • As .MMF

     • As .TXT

     • To Shared Storage
       

2. From the Console panel (Browse View):

   • Check the box next to the desired queue/topic.

   • From the Selected menu, choose Browse Messages. The queue’s/topics messages appear in the Console panel.

   • In the Console tab, click the Save all messages button.

   • Choose:

     • Export all in MMF

     • Export all in text

     • Export all to Shared Storage

     • Export view in csv
       

3. If you selected As .MMF or As .TXT:

   • The Export Messages dialog appears. Modify the existing settings as needed, and then click Export to export messages. Messages are exported to your system’s Downloads folder.
     

4. If you selected Export to Shared Storage:

   • The Write File Name dialog opens.

     

   • Enter a file name and click Ok.

   • A Success message appears in the lower-right corner once the export is complete.

5. If you select Export view in csv:

   • Select Export view in csv.

   • A file named exported_message.csv is downloaded to your system’s Downloads folder. You can open the file directly from your browser.

     

Exporting Selected Messages from the Console Panel

You can export selected messages from the Console panel (while browsing).

1. Check the box next to the desired queue/topic.

2. From the Selected menu, choose Browse Messages. The queue’s/topics messages appear in the Console panel.

3. In the Console tab, check the boxes next to the messages you want to export. Click the

   Save Selected Messages button.
   

   • Choose:

     • Export in MMF

     • Export in text

     • Export to Shared Storage

   • For Shared Storage, you can also select the messages and choose Save to storage from the Selected menu.
     

4. If you selected Export in MMF or text:

   • The Export Messages dialog appears. Modify the existing settings as needed, and then click Export to export messages. Messages are exported to your system’s Downloads folder.

     

5. If you selected Export to Shared Storage or Save to storage:

   • The Write File Name dialog opens.

     

   • Enter a file name and click Ok.

   • A Success message appears in the lower-right corner once the export is complete.

_________________________________________________________________________________________________________________

Version 11.3 and Earlier

You can export all of a queue's messages or only selected messages. From a queues viewlet, you export all messages. They can be exported to an .MMF or .TXT file. When browsing messages in the Console panel, you can select which messages to export. You also have additional options, such as exporting messages to shared storage.

The ability to save/export files to shared storage requires that you enter a valid path in the Enterprise Manager MQM Properties dialog's MMF Shared Storage tab, in the Directory to be used for MMF Shared Storage field. This option is available for IBM MQ queues, Kafka topics and partitions, and EMS topics and queues.

Exporting All Messages from a Queues Viewlet

Perform the following:

1. Click on the box next to the desired queue.
   
2. Export all of the queue's messages:  select Messages > Export All Messages > As .MMF, As .TXT, or To Shared Storage.
   
3. The next steps depends on your selection in step 2:
   • If you selected As .MMF or As .TXT, you are presented with the following message. Click Yes to export.
     
     To change the export file's customization options, click Configure on the screen above. The Settings window opens (check out step #3 in  How can I change the file layout of exported messages for an explanation of each setting). After updating all desired options, click Use Once to only use these configurations this one time, or click Save Changes to make these new specifications the default file configuration when exporting message files. 
     
     The message(s) are now exported to your default Downloads location.

   • If you selected To Shared Storage, the Write File Name dialog opens. Enter a file name. Click OK.

     

Exporting Selected or All Messages from the Console panel

Perform the following:

1. Click on the box next to the desired queue.
   
2. Select Browse messages from the Action menu (Selected menu in 11.2). All of the queue's messages display within a viewlet located in the Console panel. 
   
3. Do one of the following:
   • Select all desired messages (check the box immediately to the left of each message) and click  the Saved selected messages button (or in previous versions) located on the top left. 
     Select either Export in MMF, Export in text, or Export to Shared Storage from the pop-up menu that appears.
     
     • If you chose Export in MMF or Export in text, the Command settings dialog is displayed.
       Click Yes to export. The message(s) are now exported to your default Downloads location.
     • If you chose Export to Shared Storage, the Write File Name dialog is displayed.
       
       Enter a name for the exported messages file and click OK. When the file is created, a Success message is temporarily displayed in the lower right corner of the window.
   • Export all of the queue's messages by clicking on the Save all messages button (last button on the tool bar; in previous versions). 
     
     • If you chose Export all in MMF or Export all in text, the Command settings dialog is displayed. Click Yes to export. The message(s) are now exported to your default Downloads location.
       
     • If you chose Export to Shared Storage, the Write File Name dialog is displayed.
       
       Enter a name for the exported messages file and click OK. When the file is created, a Success message is temporarily displayed in the lower right corner of the window.
     • If you chose Export view in csv, a csv file is downloaded to your default Downloads location. You can open the file from your browser:
       

Configuring Message Export File Options

From the Command Settings dialog shown below, you can make changes to the format of exported messages.

To change the export file's customization options:

Click Configure on the dialog above. The Settings window opens (check out step #3 in  How can I change the file layout of exported messages for an explanation of each setting).

Update all desired options.

Choose one:

• Click Use Once to only use these configurations this one time.
• Click Save Changes to make these new specifications the default file configuration when exporting message files.