Exporting messages

Some of the content described in this article is available in meshIQ Manage versions 11.1.1 and later. See meshIQ platform Highlights v11.1 for an overview of feature changes.

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 pane, 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 some or all messages from the console pane

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.