Use this command to move the messages from one transmission queue (a source
queue) to another transmission queue (a target queue), and to have future
messages sent to the target queue.
Requirements and Restrictions
- You can enter this command only in NORM state.
- You must define the queue manager profile by entering the ZMQSC DEF MQP
command before entering this command.
- Without single quotation marks (' ') specified, characters are
handled as uppercase only. If a TPF MQSeries object needs to be
case-sensitive, enclose the object in single quotation marks.
- Channels associated with the transmission queue must be stopped and not in
an in-doubt condition.
-
Attention: If a ZMQSC SWQ command is in progress, do not
start the channel associated with the queue specified as the source
transmission queue (FROMQ). If you do, messages in this queue may be
transmitted out of sequence.
Format
- FROMQ-fqname
- specifies the source transmission queue, where fqname is the 1-
to 48-character queue name. A queue name can contain percent signs
(%), slashes (/), underscores (_), periods (.), letters
in either uppercase (A-Z) or lowercase (a-z), and digits
(0-9).
- TOQ-tqname
- specifies the target transmission queue, where tqname is the 1-
to 48-character queue name. A queue name can contain percent signs
(%), slashes (/), underscores (_), periods (.), letters
in either uppercase (A-Z) or lowercase (a-z), and digits
(0-9).
Additional Information
- Online help information is available for this command. To display
the help information, enter one of the following:
ZMQSC HELP
ZMQSC ?
- The queue is reset if you specify the same transmission queue name for
both the FROMQ and TOQ parameters. New messages are no longer routed to
a different target queue.
Examples
The following example moves the messages from transmission queue abc to
transmission queue def.
+--------------------------------------------------------------------------------+
|User: ZMQSC SWQ FROMQ-'abc' TOQ-'def' |
| |
|System: MQSC0088I QUEUE SWING abc TO def SUCCESSFUL |
+--------------------------------------------------------------------------------+
Related Information
See MQSeries Command Reference for more
information about the MQSeries product.