Utility CTDUFMPR

This utility reorganizes the Migrated User Report List file (MUF) partitions in place according to the new partition date ranges that are specified with the utility’s input parameters.

The MUF can be separated into several partitions based on the CDAM creation date, by using the CTDUFMDV utility. The partitions date ranges are kept in the special MIGPART record, which is located in the main partition of the MUF. When Control-V works with a partitioned MUF, the new reports are usually migrated to the last (main) partition. As the main partition grows, periodically it is necessary to reorganize the MUF partitions according to the new partition date ranges. While this reorganization procedure can be performed using the CTDUFMDV utility, it requires additional space on the DASD for the new set of partitioned datasets, and the time necessary for rewriting all the MUF records to the new datasets. Using CTDUFMPR is more efficient, saving this additional overhead in space and time.

The CTDUFMPR utility reorganizes the MUF partitions inside the existing partitioned datasets. The records, which are located in the partitions that do not match the new partition date ranges, are moved to the appropriate partitions. The remaining MUF records are not moved. CTDUFMPR does not change the number of partitions.

The repartition process consists of following steps:

1. Run CTDUFMPR with the COPY function. The MUF records, which are located in the partitions that do not match the new date ranges specified in the SYSIN input parameters, are copied to the corresponding partitions. The copied records are not deleted from the original partitions in this step. The Control-D end users continue to work with the original copies of the records during this step. At the end of this step, the MIGPART record is updated with the new partition date ranges.
2. To enable end users to work with the new partitions distribution, do the following:
   1. Send the modify command

   /F IOAGATE,MODASID MODAPPL D RMIGPART

   to the IOA Application Server. This modify command causes the IOA Application Server to read the MIGPART record with the new partition dates. Then the Control-D/WebAccess end users can work with the new partitions distribution.

   1. Restart Online Monitor and TSO users working with migrated reports. Then the 3270 terminal end users can work with the new partitions distribution.
   2. If deferred printing from Migration User files is used, run the CTDBLXR utility with the MIG parameter. It rebuilds the Print Control records to point to the new location of the User records, which were copied during the CTDUFMPR COPY step.
3. Run CTDUFMPR with the DELETE function. The MUF records, which were copied to other partitions in step 1, are now deleted from the original partitions. For more information about the CTDUFMPR utility, see the INCONTROL for z/OS Utilities Guide.