gtpo1mcsOperations

ZPMIG-Migrate Pool Structures

Use this command to:

Requirements and Restrictions

Format




CONVERT
converts the pool data structures for the current subsystem from PXP format to 32-way loosely coupled pool support format. When pool conversion is completed, all pool data structures on DASD are in 32-way loosely coupled pool support format.

Notes:

  1. If your complex is loosely coupled, you must ensure that the pool data structures in main processor storage on each processor in the complex are current before specifying the CONVERT parameter. Do this by entering the ZDFPC command on each active processor in the complex.

  2. All processors in the complex must be currently running from an image containing 32-way loosely coupled pool support before you convert the pool data structures. To ensure that all active processors are using 32-way loosely coupled pool support, enter the ZPMIG command with the STATUS parameter specified from each active processor. If message PMIG0011I is returned, the processor is using 32-way loosely coupled pool support. If any other message is returned, the processor is not using 32-way loosely coupled pool support. You must re-IPL the processor using an image containing 32-way loosely coupled pool support before you can specify the CONVERT parameter.

  3. You need to enter the command with the CONVERT parameter specified once for each subsystem in the loosely coupled complex. The command can be entered from any active processor in the complex. After processing is successfully completed, all pool data structures that reside in processor storage and on DASD for the subsystem are in 32-way loosely coupled pool support format.

FALLBACK
changes the pool data structures on DASD for each subsystem from 32-way loosely coupled pool support format back to PXP format.

STATUS
displays the migration state for each processor in the complex. The migration state can be MIGRATED, UNMIGRATED, or INACTIVE.

Additional Information

Online help information is available for this command. To display the help information, enter one of the following:

ZPMIG HELP

ZPMIG ?

Examples

In the following example, pool data structures are converted from PXP format to 32-way loosely coupled pool support format.

+--------------------------------------------------------------------------------+
|User:   ZPMIG CONVERT                                                           |
|                                                                                |
|System: PMIG0001I 13.31.29 POOL CONVERSION COMPLETE                             |
+--------------------------------------------------------------------------------+

In the following example, pool data structures are changed from 32-way loosely coupled pool support format back to PXP format.

+--------------------------------------------------------------------------------+
|User:   ZPMIG FALLBACK                                                          |
|                                                                                |
|System: PMIG0002I 13.31.29 POOL CONVERSION FALLBACK COMPLETED                   |
+--------------------------------------------------------------------------------+

The migration state for each processor defined in the complex is displayed in the following example.

+--------------------------------------------------------------------------------+
|User:   ZPMIG STATUS                                                            |
|                                                                                |
|System: PMIG0011I 13.26.36 32-WAY LC POOL MIGRATION STATUS                      |
|        THE POOL DATA STRUCTURES ARE NOT CONVERTED                              |
|            PROCESSOR        STATUS                                             |
|            ---------      ----------                                           |
|                B          MIGRATED                                             |
|                C          UNMIGRATED                                           |
|                D          UNMIGRATED                                           |
|                E          INACTIVE                                             |
|        END OF DISPLAY+                                                         |
|                                                                                |
+--------------------------------------------------------------------------------+

Related Information

See the TPF Migration Guide: Program Update Tapes for more information about converting the entire complex from the old pool format to the new pool format.