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 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.
- Select Load from File
from the Messages viewlet or Load from File from the Queue Viewlet Messages menu options. The Command settings dialog box for loading messages is displayed.
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). - 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.
- 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.
- 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.
- 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:
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.
- 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.)
- While browsing messages, select the Load from
in previous versions), then select Load from Shared 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.)
- The Select Files dialog includes all message files. Choose a file by clicking it.
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.)