Air Cleaner User Manual
You can specify a queue manager name, other than the queue
manager on which the command was entered, only if you are
using a queue-sharing group environment and if the command
server is enabled.
QSGDISP
Specifies the disposition of the source queue.
PRIVATE
The queue is defined with QSGDISP(QMGR) or QSGDISP(COPY).
This is the default value.
SHARED
The queue is defined with QSGDISP(SHARED). This is valid only
in a queue-sharing group environment.
TYPE Specifies how the messages are moved.
MOVE
Move the messages from the source queue to the empty target
queue.
The command fails if the target queue already contains one or
more messages. The messages are deleted from the source queue.
This is the default value.
ADD Move the messages from the source queue and add them to any
messages already on the target queue.
The messages are deleted from the source queue.
target The name of the local queue to which messages are moved. The name
must be defined to the local queue manager.
The name of the target queue can be the same as that of the source queue
only if the queue exists as both a shared and a private queue. In this case,
the command moves messages to the queue that has the opposite
disposition (shared or private) from that specified for the source queue on
the QSGDISP parameter.
If an application has this queue open, or has open a queue that eventually
resolves to this queue, the command fails. The command also fails if this
queue is a transmission queue, and any queue that is, or resolves to, a
remote queue that references this transmission queue, is open.
No application can open this queue while the command is in progress.
If you specify TYPE(MOVE), the command fails if the target queue already
contains one or more messages.
The DEFTYPE, HARDENBO, INDXTYPE, and USAGE parameters of the
target queue must be the same as those of the source queue.
Usage notes
1. A typical use of the MOVE QLOCAL command is to move messages from a
private queue to a shared queue when you are setting up a queue-sharing
group environment.
2. The MOVE QLOCAL command moves messages; it does not copy them.
3. The MOVE QLOCAL command moves messages in a similar way to an
application performing successive MQGET and MQPUT calls. However, the
MOVE QLOCAL command does not physically delete logically-expired
messages and, therefore, no expiration reports will be generated.
MOVE QLOCAL
226
MQSeries MQSC Command Reference
|
|
|
|
|
|
|
|
|
|
|
|
||
|
|
|
|
|
|
||
|
|
||
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|