Use this command to migrate existing TPF MQSeries queues to the new format
established by turbo enhancements for TPF support of MQSeries local queue
manager (APAR PJ27023) and to fall back TPF MQSeries queues to a TPF system
prior to APAR PJ27023.
Requirements and Restrictions
- Migration must be committed before you can enter the following
commands:
- ZMQSC ALTER (QA, QL, QR, or CHL)
- ZMQSC DEFINE (QA, QL, QR, or CHL)
- ZMQSC DELETE
- ZMQSC DBREBUILD.
You cannot enter the ZMQSC MIGRATE command with the COMMIT parameter
specified while there are messages on the dead-letter queue unless you also
specify the FORCE parameter.
When processor unique queues are migrated, the value for the SWEEP
parameter in the queue definition is set to OFF.
You must enter this command on each subsystem in your complex where a
local queue manager was previously defined.
Format
- BEGin
- sets the TPF MQSeries queue manager to migration mode. All
processor unique queues that were defined previously will be migrated to the
new format for the processor on which this command is entered. Enter
ZMQSC MIGRATE BEGIN before starting the queue manager for the first
time on a processor with turbo enhancements for TPF support of MQSeries local
queue manager applied. Migration mode continues until you specify the
FALLBACK or COMMIT parameter. You cannot define new queues or channels,
or delete or change existing ones, while in migration mode. You must
make any changes to queues or channels on a TPF system without turbo
enhancements for TPF support of MQSeries local queue manager applied, or after
you specify the COMMIT parameter.
- COMMit
- ends the migration mode of the TPF MQSeries queue manager for all
processors. Before you specify this parameter, do the following:
- Apply turbo enhancements for TPF support of MQSeries local queue manager
on all processors in the loosely coupled complex.
- Enter ZMQSC MIGRATE BEGIN on all active processors in the
loosely coupled complex. An active processor is one that possibly has
messages on at least one processor-unique queue. A processor is marked
active when you enter ZMQSC START QMGR. It remains active
until all processor unique queues are emptied and you enter ZMQSC STOP
QMGR. If you enter ZMQSC START QMGR again, the
processor becomes active even if there are no messages on the processor unique
queues.
- FALLback
- converts TPF MQSeries queues back to the format that was used before turbo
enhancements for TPF support of MQSeries local queue manager. After you
specify this parameter, the queue manager cannot be started on a TPF system
with turbo enhancements for TPF support of MQSeries local queue manager
applied.
- FORCE
- forces the MIGRATE BEGIN or MIGRATE FALLBACK operations to be completed or
to end even if the TPF system is in a partially migrated state because of an
error. This parameter also forces the MIGRATE COMMIT operation to be
completed or to end even if the the old format (before APAR PJ27023)
dead-letter queue is not empty.
- STATus
- displays the processors in a loosely coupled complex that have yet to be
migrated. Any processor that has nonzero, processor unique queues in
the old format must be migrated.
Additional Information
Online help information is available for this command. To display
the help information, enter one of the following:
ZMQSC HELP
ZMQSC ?
Processors with and without APAR PJ27023 can co-exist within a loosely
coupled complex.
Examples
The following example migrates a TPF MQSeries queue.
+--------------------------------------------------------------------------------+
|User: ZMQSC MIGRATE BEGIN |
| |
|System: MQSC0173I ALL QUEUES SUCCESSFULLY MIGRATED |
+--------------------------------------------------------------------------------+
Related Information
- See MQSeries Command Reference for more
information about the MQSeries product.
- See TPF Migration Guide: Program Update
Tapes for more information about migrating TPF MQSeries queues to the
turbo enhancements for TPF support of MQSeries local queue manager
format.