gtpo1mafOperations

ZMQSC MIGRATE-Migrate TPF MQSeries Queues

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

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:
  1. Apply turbo enhancements for TPF support of MQSeries local queue manager on all processors in the loosely coupled complex.
  2. 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