Home

 

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 are generated.

  4. The priority, context, and persistence of each message are not changed.

  5. The command performs no data conversion and calls no exits.

  6. Confirm-on-delivery (COD) report messages are not generated but confirm-on-arrival (COA) report messages are. This means that more than one COA report message can be generated for a message.

  7. The MOVE QLOCAL command transfers the messages in batches. At COMMIT time, if the trigger conditions are met, trigger messages are produced. This might be at the end of the move operation.

    Before the transfer of messages begins, this command verifies that the number of messages on the source queue, when added to the number of messages on the target queue, does not exceed MAXDEPTH on the target queue.

    If the MAXDEPTH of the target queue were to be exceeded, no messages are moved.

  8. The MOVE QLOCAL command can change the sequence in which messages can be retrieved. The sequence remains unchanged only if:

    • You specify TYPE(MOVE) and

    • The MSGDLVSQ parameter of the source and target queues is the same.

  9. Messages are moved within one or more syncpoints. The number of messages in each syncpoint is determined by the queue manager.

  10. If anything prevents the moving of one or more messages, the command stops processing. This can mean that some messages have already been moved, while others remain on the source queue. Some of the reasons that prevent a message being moved are:

    • The target queue is full.

    • The message is too long for the target queue.

    • The message is persistent, but the target queue cannot store persistent messages.

    • The page set is full.

 

Parent topic:

MOVE QLOCAL


sc12570_


 

Home