Skip to main content
Top
Review meshIQ Products (G2.com)

Load Messages from a File or Shared Storage

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

You can choose to load messages from one of several sources:

Load Messages from a File

You can load single or multiple messages from .mmf, .txt, or IBM dmpmqmsg utility-generated files.

  1. To begin, do one of the following:

    • Select Load From > Load from file from the Console tab.

    • Or, open the Queue/Topic widget, then choose Messages > Load From File... from the Selected menu.

  2. The system displays the Load Messages dialog.

  3. Select the format of the file you are loading:

    • Text/Binary: Choose this option for plain text files.

    • MMF: The MMF option is a meshIQ-proprietary Message Management File format. When selected, this format also preserves extra metadata such as headers.

    • dmpmqmsg: Choose this option for character-encoded binary files created by the IBM dmpmqmsg utility, which exports queue messages into a file.

  4. Select the Force Encoding checkbox to enable the Encoding drop-down list on the right, choose an encoding method such as US-ASCII, IBM EBCDIC International, or UTF-8, and the system will apply your selection not only to the Message Headers Data, but also to the message encoding type and the message content itself.

When loading Kafka messages from a file, the encoding is fixed to US-ASCII. The Force Encoding option is not available.

  1. (Optional) Modify the remaining settings in the dialog, such as Max Loaded Messages Count, Message Creation, Preserve Context, Message Delimiter, and MQMD Header Values. For details about each field, see the Load Messages article.

  2. Click Load to load messages using the selected settings. The system prompts you to load a file from an internal location.
    Alternatively, click Scheduling to load messages at a later time. 

If the selected file contains more messages than the queue's maximum depth allows, the system will display an error message similar to the following:

Load Messages from Shared Storage

To enable saving or exporting files to shared storage, you must enter a valid path in the Enterprise Manager MQM Properties dialog, under the MMF Shared Storage tab.
Specify the location in the Directory to be used for MMF Shared Storage field.

This option is available for:

  • IBM MQ queues

  • Kafka topics and partitions

  • TIBCO EMS queues

  • ActiveMQ queues

You can load messages from shared storage using one of the following methods:

  1. From the Queue/Topic widgets:

    • Select the queue/topic into which you want to load messages.

    • From the Selected menu, choose Messages > Load From Shared Storage....

  2. From the Console Panel (while browsing messages):

    • Click the Load From button.

    • Then choose Load from Shared Storage.

The Select Files dialog appears, listing all available message files. Click a file to select it, or enter the file name in the File name field and click Select.

The queue refreshes automatically, and a Success message confirms the load.

_______________________________________________________________________________________________________________

Version 11.3 and Earlier

You can choose to load messages from one of several sources:

Load Messages from a File

Users can load single or multiple messages from .mmf files, .txt files, or files created by the IBM dmpmqmsg utility. 

  1. Select Load from File CnsLoadFromBt.png from the Messages tab in the Console, or Load from File from the Queue Viewlet Messages sub menu options. The Command settings dialog box for loading messages is displayed.   
    LoadfromFile.png
    When loading Kafka messages from a file, the Encoding is set to US-ASCII and cannot be changed (the Force Encoding option is not available).
    LoadFromFileKafka.png
  2. Choose the file format you’re loading from. Choices are as follows:
    • Text/binary. Choose this option for plain text format.
    • MMF. The MMF option is a meshIQ proprietary Message Management File format. Please be aware that when this file type is selected, extra data, such as headers, will be saved.
    • Dmpmqmsg. This option indicates a character-encoded binary file that was produced by the IBM dmpmqmsg utility, which saves messages from a queue into a file.
  3. Use the list on the right to choose between US-ASCII and IBM EBCDIC International encoding. The encoding method in the list will be reflected in the Message Headers Data.  If you select the Force Encoding checkbox, not only the message headers, but the message encoding type (in the Encoding list) and message data itself will also reflect your selection.
  4. Choose one of the following options:
    • Click Yes to load a file right away. 
    • Click Configure to specify settings (such as the delimiter to be used) in the Load Message settings window. Click Use Once to use the updated settings without saving them. Click Save Changes to use the settings and keep them the next time you load messages from a file.
  5. Double-click the file to load messages into the queue.

If the file that is loaded contains more messages than the queue’s maximum depth, an error message similar to the following will be displayed:

LoadMsgError.png

Load Messages from 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.

There are two ways to load messages from shared storage.

  1. Choose an option for loading messages from storage:
    • Select the queue into which you want to load messages. On the action menu, select Messages > Load from Shared Storage. (The action menu is the Selected menu in 11.2.)
      LoadFromMenu.png
    • While browsing messages, select the Load from CnsLoadFromBt.png button (LoadFrmFileBt.png in previous versions), then select Load from Shared Storage.
      LoadFromSS.png
  2. The Select Files dialog includes all message files. Choose a file by clicking it.
    SystemFileLkp.png

If you do not see the new message in the queue viewlet, refresh the viewlet. (In versions 11.1 and later, the queue is refreshed automatically and a Success message is displayed.)