Home
Optional parameters
- CommandScope (MQCFST)
- Command scope (parameter identifier: MQCACF_COMMAND_SCOPE).
Specifies how the command is executed when the queue manager is a member of a queue-sharing group. We can specify one of the following:
- blank (or omit the parameter altogether). The command is executed on the queue manager on which it was entered.
- a queue manager name. The command is executed on the queue manager you specify, providing it is active within the queue sharing group. If you specify a queue manager name other than the queue manager on which it was entered, be using a queue-sharing group environment, and the command server must be enabled.
The maximum length is MQ_QSG_NAME_LENGTH.
- MoveType (MQCFIN)
- Move type (parameter identifier: MQIA_QSG_DISP).
Specifies how the messages are moved. The value can be:
- MQIACF_MOVE_TYPE_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.
- MQIACF_MOVE_TYPE_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.
- QSGDisposition (MQCFIN)
- Disposition of the object within the group (parameter identifier: MQIA_QSG_DISP).
Specifies the disposition of the object for which information is to be returned (that is, where it is defined and how it behaves). The value can be:
- MQQSGD_PRIVATE
- The object is defined as either MQQSGD_Q_MGR or MQQSGD_COPY. This is the default value.
- MQQSGD_SHARED
- The object is defined as MQQSGD_SHARED. This is valid only in a shared queue environment.
- ToQName (MQCFST)
- To queue name (parameter identifier: MQCACF_TO_Q_NAME).
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 QSGDisposition 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 a value of MQIACF_MOVE_TYPE_MOVE on the MoveType parameter, the command fails if the target queue already contains one or more messages.
The DefinitionType, HardenGetBackout, Usage parameters of the target queue must be the same as those of the source queue.
The maximum length of the string is MQ_Q_NAME_LENGTH.
Parent topic:
Move Queue
pc13580_
Home