Examples of using the dmpmqmsg utility
Simple ways in which you can use the dmpmqmsg utility (formerly qload). This utility is incorporated into the product from IBM® MQ 8.0.
Formerly the qload utility was available as SupportPac MO03.
Unload a queue to a file
Use the following options on the command line to save the messages that are on a queue, into a file:
dmpmqmsg -m QM1 -i Q1 -f c:\myfile
This command takes a copy of the messages from the queue
and saves them in the file specified.
Unload a queue to a series of files
You can unload a queue to a series of files by using an
insert
character in the file name. In this mode each message is written to a new file:
dmpmqmsg -m QM1 -i Q1 -f c:\myfile%n
This command unloads the queue to files, myfile1
, myfile2
, myfile3
, and so on.
Load a queue from a file
To reload a queue with the messages you saved in Unload a queue to a file, use the following options on the command line:
dmpmqmsg -m QM1 -o Q1 -f c:\myfile%n
This command unloads the queue to files, myfile1
, myfile2
, myfile3
, and so on.
Load a queue from a series of files
You can load a queue from a series of files by using an
insert
character in the file name. In this mode each message is written to a new file:
dmpmqmsg -m QM1 -o Q1 -f c:\myfile%n
This command loads the queue to files, myfile1
, myfile2
, myfile3
, and so on.
Copy the messages from one queue to another queue
Replace the file parameter in Unload a queue to a file, with another queue name and use the following options:
dmpmqmsg -m QM1 -i Q1 -o Q2
This command
allows the messages from one queue to be copied to another queue.
Copy the first 100 messages from one queue to another queue
Use the command in the previous example and add the
-r#100
option:
dmpmqmsg -m QM1 -i Q1 -o Q2 -r#100
Move the messages from one queue to another queue
A variation on Load a queue from a file. Note the distinction between using
-i (lowercase) which only browses a queue, and -I
(uppercase) which destructively gets from a queue:
dmpmqmsg -m QM1 -I Q1 -o Q2
Move messages older than one day from one queue to another queue
This example shows the use of age selection. Messages can be selected that are older than, younger than, or within a range of ages.
dmpmqmsg -m QM1 -I Q1 -o Q2 -T1440
Display the ages of messages currently on a queue
Use the following options on the command line:
dmpmqmsg -m QM1 -i Q1 -f stdout -dT
Work with the message file
Having unloaded the message from your queue, as in Unload a queue to a file, you might want to edit the file.
You might also want to change the format of the file to use one of the display options that you did not specify at the time you unloaded the queue.
You can use the dmpmqmsg utility to reprocess the file into the required format even after the unload of the queue has taken place. Use the following options on the command line.
dmpmqmsg -f c:\oldfile -f c:\newfile -dA
See dmpmqmsg for a description of the command and its parameters.