Migrate Conversion

Users that have to load Migrate data that are versioned in Predict Application Control and created with Predict Version 3.4 or below are now able to load such Migrate data sets using the Migrate Conversion function.

The Migrate Conversion function transforms these old Migrate data (3.1, 3.2 and 3.4) to Predict Migrate 4.1 format. The input workfile can contain several different Migrate formats. Those records in the input workfile that are in Predict Migrate 4.1 format or above are transferred without conversion.

The function can also be used when customers want to upgrade directly from Predict Version 3.4 or below to the current Predict version.

The programs required for the Migrate Conversion tool are delivered in library SYSDICBE in source form.

This section covers the following topics:


Calling the Function

The Migrate Conversion function is called with command PRDM41 from the Coordinator Menu or with command PRDM41 on the NEXT prompt in library SYSDICBE.

Options

Workfiles

Workfile 1 is the default input workfile and workfile 6 the default output workfile.

Output

The command PRDM41 has an optional parameter that can be set to either REP or NOREP.

REP Replace. After a successful conversion the content of workfile 6 is copied to workfile 1.
NOREP No replace. The content in workfile 1 remains untouched. This is the default.

Example

LOGON SYSDICBE   
MENU             
PRDM41 NOREP     
FIN

User Exits

U-MTOT

This user exit translates the codes that are reserved in Predict Version 4.1. For user-defined object type codes and object typ names of earlier versions, you must enter a new code and/or name or you can use the assigned defaults.

Reserved object type codes: MD, IE and PY.

Reserved object type names: METHOD, INTERFACE, PROPERTY.

U-MOBJ

Migrate objects of the versions 3.1, 3.2 and 3.4 can be explicitly excluded from the conversion based on:

  • Migrate version,

  • Current object type,

  • Current object ID,

  • Current object subtype.

These excluded objects are not written to output workfile 6.

Refer to U-MTOT and U-MOBJ in section User Exits of the Predict Administration documentation for further details.

Limitations

The following limitations apply depending on the Migrate format:

Limitations for Migrate Formats 3.4, 3.2 and 3.1

  • Xref data are not converted
    Corresponding message: Xref data not converted.

Limitations for Migrate Formats below 3.4

  • DDM records are not converted.
    Corresponding message: DDM records not converted. File must be regenerated.

  • UDE’s (Meta data / Data) are not converted.
    Corresponding message: Object ID: TST-FL (FL) not converted.

  • Retrieval models are not converted.
    Corresponding message: Retrieval model data not converted.

Sample Output Protocol

----------------------------------------------------------------------------
Start of migrate format conversion at 09:59:43.3 on 2013-05-31            
-----------------------------------------------------------------------------
Migrate 34 format to migrate 41 format. 
 Object type: M4 (METHOD) converted.    
Migrate 34 format to migrate 41 format. 
 Object type: FL (FLUX_NAME) converted. 
 Object ID: TST-FL (FL) converted.      
 Object ID: TST-FL-2 (FL) converted.    
Migrate 32 format to migrate 41 format.                                 
 Object ID: TST-Z (PR) converted.                                       
 Object ID: TST-R (PR) converted.                                       
Migrate 32 format to migrate 41 format.                                 
 Object ID: TST-FL (FL) not converted.                                  
 Object ID: TST-FL-2 (FL) not converted.                                
Migrate 34 format to migrate 41 format.                                 
 Object ID: TST-S (VE) converted.                                       
 Object ID: TST-S-1 (VE) converted.                                     
Migrate 34 format to migrate 41 format.                                 
 Object ID: TST-DDM-34 (FI) converted.                                  
Conversion of migrate format 42 not necessary.
Migrate 32 format to migrate 41 format.                                 
 Object ID: TST-DDM-32 (FI) converted.                                  
            DDM records not converted must be regenerated.              
 Object ID: TST-UDE1 (T1) not converted.                             
---------------------------------------------------------------------------
End of migrate format conversion at 09:59:48.9 on 2013-05-03              
---------------------------------------------------------------------------
Summary                               
  Objects converted ........ 8         
  Objects not converted .... 3
  Object types converted ... 2
Migrate format conversion terminated successfully.